Geocode

• 주소 검색 API는 지번, 도로명를 질의어로 사용해서 주소 정보를 검색합니다.
• 검색 결과로 주소 목록과 세부 정보를 JSON 형태로 반환합니다.

**GET** /map-geocode/v2/geocode

Request Parameter

Request Header

Response Body

Error Code

예시

요청예시

curl -G "<https://naveropenapi.apigw.ntruss.com/map-geocode/v2/geocode>" \\
    --data-urlencode "query=분당구 불정로 6" \\
    --data-urlencode "coordinate=127.1054328,37.3595963" \\
    -H "X-NCP-APIGW-API-KEY-ID: {애플리케이션 등록 시 발급받은 client id값}" \\
    -H "X-NCP-APIGW-API-KEY: {애플리케이션 등록 시 발급받은 client secret값}" -v

응답예시

{
    "status": "OK",
    "meta": {
        "totalCount": 1,
        "page": 1,
        "count": 1
    },
    "addresses": [
        {
            "roadAddress": "경기도 성남시 분당구 불정로 6 그린팩토리",
            "jibunAddress": "경기도 성남시 분당구 정자동 178-1 그린팩토리",
            "englishAddress": "6, Buljeong-ro, Bundang-gu, Seongnam-si, Gyeonggi-do, Republic of Korea",
            "addressElements": [
                {
                    "types": [
                        "POSTAL_CODE"
                    ],
                    "longName": "13561",
                    "shortName": "",
                    "code": ""
                }
            ],
            "x": "127.10522081658463",
            "y": "37.35951219616309",
            "distance": 20.925857741585514
        }
    ],
    "errorMessage": ""
}