Geocoding 개요
- 인쇄
- PDF
Geocoding 개요
- 인쇄
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
주소의 텍스트를 입력받아 좌표를 포함한 상세정보들을 제공합니다.
공통 설정
클라이언트 아이디는 NAVER Cloud Platform 콘솔에서 애플리케이션을 등록해 발급받습니다.
콘솔의 AI·NAVER API > AI·NAVER API > Application에서 애플리케이션을 등록합니다. 자세한 방법 보기 >
AI·NAVER API > AI·NAVER API > Application에서 등록한 애플리케이션을 선택해 Client ID와 Client Secret값을 확인합니다.
AI·NAVER API > AI·NAVER API > Application의 변경 화면에서 Geocoding가 선택되어 있는지 확인합니다. 선택되어 있지 않으면 429 (Quota Exceed)가 발생하니 주의하시기 바랍니다.
API URL
메서드 | 인증 | 요청 URL | 응답 형식 |
---|---|---|---|
GET | ID,KEY | https://naveropenapi.apigw-pub.fin-ntruss.com/map-geocode/v2/geocode | JSON |
요청 헤더
헤더명 | 설명 |
---|---|
X-NCP-APIGW-API-KEY-ID | 앱 등록 시 발급받은 Client IDX-NCP-APIGW-API-KEY-ID:{Client ID} |
X-NCP-APIGW-API-KEY | 앱 등록 시 발급 받은 Client SecretX-NCP-APIGW-API-KEY:{Client Secret} |
오류 코드
{
"error": {
"errorCode": "300",
"message": "Not Found Exception"
}
}
공통 오류
HttpStatusCode | ErrorCode | ErrorMessage | Description |
---|---|---|---|
400 | 100 | Bad Request Exception | protocol(https), endocing(UTF-8) 등 request 오류 |
401 | 200 | Authentication Failed | 인증실패 |
401 | 210 | Permission Denied | 권한없음 |
404 | 300 | Not Found Exception | 권한없음 |
429 | 400 | Quota Exceeded | Quota 초과 |
429 | 410 | Throttle Limited | Rate 초과 |
429 | 420 | Rate Limited | Rate 초과 |
413 | 430 | Request Entity Too Large | content-length 초과 (10MB) |
503 | 500 | Endpoint Error | 엔드포인트 연결오류 |
504 | 510 | Endpoint Timeout | 엔드포인트 연결시간 초과 |
500 | 900 | Unexpected Error | 예외처리가 안된 오류 |
API 오류
HttpStatusCode | ResultCode | ErrorMessage | Description |
---|---|---|---|
200 | OK | - | 정상 응답 |
400 | INVALID_REQUEST | Bad Request Exception | 요청 오류 |
500 | SYSTEM_ERROR | Unexpected Error | 예외처리가 안된 오류 |
이 문서가 도움이 되었습니까?