참고

기존 개발자 센터에서 https://openapi.naver.com/v1/map/geocode API를 사용하시는 경우, 응답 및 포맷 결과가 다를수 있습니다. 아래 네이버 개발자센터 API(v1) 대비 달라진 점 링크를 참고해주시어 응답 포맷 및 결과에 따른 코드 수정을 해 주시기 바랍니다.

기존 v1 버전의 Geocoding REST API는 2019년 2월 28일까지만 정상 호출됩니다. 2019년 3월부터는 v1 사용은 중지됩니다.

API 소개

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

Geocoding API v2 별도의 개발 가이드 사이트를 제공합니다.
Geocoding API v2 참조서 사이트 바로가기 >

참고

네이버 개발자센터 API 대비 달라진 점

요청 파라미터

  • 응답 인코딩 파라미터(encoding)를 더 이상 지원하지 않습니다.(항상 'utf-8'로 응답)
  • 응답 좌표체계 파라미터(coordType)를 더 이상 지원하지 않습니다.(항상 '위경도'로 응답) ​

응답

  • 검색어(query)에 해당하는 주소결과에 대해 도로명, 지번, 영어주소 3가지 형태를 모두 제공합니다.
  • 기존 point 객체 내 x,y로 내려가던 좌표정보를 point 객체 없이 바로 내려줍니다.
  • 기존 addrdetail에 내려주던 정보들은 addressElements 필드(array)로 대체됩니다. 이는 주소타입과 값을 구조화하여 언제든 새로운 주소타입을 추가할 수 있는 확장된 구조입니다. 예를들어 addressElements 중 types 값이 POSTAL_CODE인 요소는 우편번호를 나타냅니다. ​

예시

  • 'query=연사리 93' 검색결과 ​
  • 기존(v1) 결과
{
  "result": {
    "total": 1,
    "userquery": "연사리 93",
    "items": [
      {
        "address": "경상남도 거제시 연초면 연사리 93",
        "addrdetail": {
          "country": "대한민국",
          "sido": "경상남도",
          "sigugun": "거제시",
          "dongmyun": "연초면",
          "ri": "연사리",
          "rest": "93"
        },
        "isRoadAddress": false,
        "point": {
          "x": 128.6521583,
          "y": 34.9070498
        }
      }
    ]
  }
}
  • 신규(v2) 결과
{
    "status": "OK",
    "meta": {
        "totalCount": 1,
        "page": 1,
        "count": 1
    },
    "addresses": [
        {
        "roadAddress": "경상남도 거제시 연초면 효촌1길 10-1",
        "jibunAddress": "경상남도 거제시 연초면 연사리 93",
        "englishAddress": "10-1, Hyochon 1-gil, Yeoncho-myeon, Geoje-si, Gyeongsangnam-do, Republic of Korea",
        "addressElements": [
            {
            "types": ["SIDO"],
            "longName": "경상남도",
            "shortName": "경상남도",
            "code": ""
            },
            {
            "types": ["SIGUGUN"],
            "longName": "거제시",
            "shortName": "거제시",
            "code": ""
            },
            {
            "types": ["DONGMYUN"],
            "longName": "연초면",
            "shortName": "연초면",
            "code": ""
            },
            {
            "types": ["RI"],
            "longName": "연사리",
            "shortName": "연사리",
            "code": ""
            },
            {
            "types": ["ROAD_NAME"],
            "longName": "효촌1길",
            "shortName": "효촌1길",
            "code": ""
            },
            {
            "types": ["BUILDING_NUMBER"],
            "longName": "10-1",
            "shortName": "10-1",
            "code": ""
            },
            {
            "types": ["BUILDING_NAME"],
            "longName": "",
            "shortName": "",
            "code": ""
            },
            {
            "types": ["LAND_NUMBER"],
            "longName": "93",
            "shortName": "93",
            "code": ""
            },
            {
            "types": ["POSTAL_CODE"],
            "longName": "53209",
            "shortName": "53209",
            "code": ""
            }
        ],
        "x": "128.6521583",
        "y": "34.9070498",
        "distance": 0
        }
    ],
    "errorMessage": ""
}

""에 대한 건이 검색되었습니다.

    ""에 대한 검색 결과가 없습니다.

    처리중...