Geocoding Overview
- Print
- PDF
Geocoding Overview
- Print
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
We are preparing a localization service for the content. We will do our best to provide the localization service as soon as possible.
Geocoding API returns detailed information including geographic coordinates, based on the specified address.
Common information
You can get a Client ID by registering your application in NAVER Cloud Platform Console.
Go to AI·Application Service > AI·NAVER API > Application in your web console and register an application. Learn how to register >
Check your Client ID and Client Secret by selecting the application registered in AI·Application Service > AI·NAVER API > Application.
Click [Edit] of the application to make sure that Geocoding is selected. If it is not selected, a 429 error (Quota Exceed) occurs.
API URL
Method | Authentication | Request URL | Response format |
---|---|---|---|
GET | ID,KEY | https://naveropenapi.apigw.ntruss.com/map-geocode/v2/geocode | JSON |
Request Header
Header | Description |
---|---|
X-NCP-APIGW-API-KEY-ID | Client ID issued when registering an appX-NCP-APIGW-API-KEY-ID:{Client ID} |
X-NCP-APIGW-API-KEY | Client Secret issued when registering an appX-NCP-APIGW-API-KEY:{Client Secret} |
Error Codes
{
"error": {
"errorCode": "300",
"message": "Not Found Exception"
}
}
Common errors
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | 100 | Bad Request Exception | Request error in protocol (https) or encoding (UTF-8). |
401 | 200 | Authentication Failed | Authentication failed. |
401 | 210 | Permission Denied | Authentication failed. |
404 | 300 | Not Found Exception | Authentication failed. |
429 | 400 | Quota Exceeded | Quota exceeded. |
429 | 410 | Throttle Limited | Rate exceeded. |
429 | 420 | Rate Limited | Rate exceeded. |
413 | 430 | Request Entity Too Large | Content-length exceeded (10 MB). |
503 | 500 | Endpoint Error | End point connection error |
504 | 510 | Endpoint Timeout | End point connection timeout |
500 | 900 | Unexpected Error | Unexpected error |
API errors
HTTP status code | Result code | Error message | Description |
---|---|---|---|
200 | OK | - | Normal response |
400 | INVALID_REQUEST | Bad Request Exception | Request error |
500 | SYSTEM_ERROR | Unexpected Error | No exception handling |
Was this article helpful?