---
title: "Geocoding 개요"
slug: "ai-naver-mapsgeocoding"
tags: ["Maps", "Geocoding"]
updated: 2026-09-17T09:10:00Z
published: 2026-09-17T09:10:00Z
canonical: "api-fin.ncloud-docs.com/ai-naver-mapsgeocoding"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api-fin.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Geocoding 개요

주소의 텍스트를 입력받아 좌표를 포함한 상세정보들을 제공합니다.

## 공통 설정

클라이언트 아이디는 [NAVER Cloud Platform 콘솔](https://console.fin-ncloud.com/)에서 애플리케이션을 등록해 발급받습니다.

1. 콘솔의 **AI·NAVER API > AI·NAVER API > Application**에서 애플리케이션을 등록합니다. **[자세한 방법 보기](https://guide-fin.ncloud-docs.com/docs/naveropenapiv3-application) >**
2. **AI·NAVER API > AI·NAVER API > Application**에서 등록한 애플리케이션을 선택해 Client ID와 Client Secret값을 확인합니다.
3. **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 ID `X-NCP-APIGW-API-KEY-ID:{Client ID}` |
| X-NCP-APIGW-API-KEY | 앱 등록 시 발급 받은 Client Secret `X-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 | 예외처리가 안된 오류 |