참고

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

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

API 소개

네이버 지도에서는 좌표를 주소를 변환(coordsToAddr)하는 Reverse geocoding 서비스를 제공합니다. Reverse geocoding API를 이용해 특정 좌표에 해당하는 국내 법정동/행정동/지번주소/도로명주소 정보를 얻을 수 있습니다.
Reverse geocoding 서비스는 EPSG(European Petroleum Survey Group)에서 지정한 일부 좌표 체계와 국내에서 주로 사용하는 좌표 체계를 지원합니다.
주소를 좌표로 변환하는 Geocoding 서비스 API는 검색 API 사용 가이드를 참고하시기 바랍니다.

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

참고

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

요청 파라미터

​ - 응답 인코딩 파라미터(encoding)를 더 이상 지원하지 않습니다.(항상 'utf-8'로 응답)

  • 파라미터명이 변경되었습니다.
    • 좌표값 : query -> coords
    • 출력좌표계 : coordType -> targetcrs
  • 필수 파라미터가 있습니다.
    • request=coordsToaddr
  • xml/json 응답형식 선택을 output 파라미터로 합니다.
    • output=xml or output=json
    • output 파라미터가 없다면 기본으로 xml결과를 전달합니다.
  • 받고자 하는 주소 종류를 상세하게 선택 및 조합할 수 있습니다.
    • orders=legalcode : 법정동
    • orders=admcode : 행정동
    • orders=addr : 지번주소
    • orders=roadaddr : 도로명주소
    • orders=legalcode,admcode : 법정동/행정동 둘다 받음
    • orders=legalcode,admcode,addr,roadaddr : 법정동/행정동/지번/도로명주소 모두 받음
    • orders 파라미터 없이 호출하면 'orders=legalcode,admcode'와 동일한 효과가 있습니다.
      • 법정동, 행정동 정보 받음
    • 개발자 센터 API처럼 모든 주소를 받고자 하신다면 'orders=legalcode,admcode,addr,roadaddr'를 호출하시면 됩니다.
    • 상세주소(지번,도로명)을 받고자 한다면 'orders=addr,roadaddr' 같은 호출보다는 'orders=legalcode,admcode,addr,roadaddr' 형식으로 호출하는 것을 추천드립니다.
      • 이유 : 해안가, 강, 신규택지 등 상세주소가 없는 지역의 경우 법정동, 행정동 정보라도 결과로 함께 받을 수 있기 때문 ​

응답

  • 응답결과의 행정단위별 depth구조가 있으며 각각의 중심좌표 정보도 제공합니다.
  • 도로명주소의 경우 우편번호가 있는 위치의 좌표결과라면 우편번호 정보도 함께 제공합니다.
  • depth 구조 및 상세정보를 함께 제공하다보니 기존 개발자 센터 결과보다 응답길이가 깁니다.
  • 단일 tag로 full address를 제공하는 항목이 없습니다.
    • 기존 개발자 센터 결과의 'address' 항목 ​

예시

  • 기존(v1) 결과
    • query=127.1054065,37.3595669
{
   "result": {
       "total": 3,
       "userquery": "127.1054065,37.3595669",
       "items": [
           {
               "address": "경기도 성남시 분당구 정자동 178-1",
               "addrdetail": {
                   "country": "대한민국",
                   "sido": "경기도",
                   "sigugun": "성남시 분당구",
                   "dongmyun": "정자동",
                   "ri": "",
                   "rest": "178-1"
               },
               "isAdmAddress": false,
               "isRoadAddress": false,
               "point": {
                   "x": 127.1052208,
                   "y": 37.3595122
               }
           },
           {
               "address": "경기도 성남시 분당구 불정로 6 NAVER그린팩토리",
               "addrdetail": {
                   "country": "대한민국",
                   "sido": "경기도",
                   "sigugun": "성남시 분당구",
                   "dongmyun": "불정로",
                   "ri": "",
                   "rest": "6 NAVER그린팩토리"
               },
               "isAdmAddress": false,
               "isRoadAddress": true,
               "point": {
                   "x": 127.1052133,
                   "y": 37.3595316
               }
           },
           {
               "address": "경기도 성남시 분당구 정자1동 178-1",
               "addrdetail": {
                   "country": "대한민국",
                   "sido": "경기도",
                   "sigugun": "성남시 분당구",
                   "dongmyun": "정자1동",
                   "ri": "",
                   "rest": "178-1"
               },
               "isAdmAddress": true,
               "isRoadAddress": false,
               "point": {
                   "x": 127.106363,
                   "y": 37.372799
               }
           }
       ]
   }
}

  • 신규(v2) 결과
    • request=coordsToaddr&coords=127.1054065,37.3595669&orders=legalcode,admcode,addr,roadaddr&output=json
      {
      "status":{
       "code":0,
       "name":"ok",
       "message":"done"
      },
      "results":[
       {
          "name":"legalcode",
          "code":{
             "id":"4113510300",
             "type":"L",
             "mappingId":"02135103"
          },
          "region":{
             "area0":{
                "name":"kr",
                "coords":{
                   "center":{
                      "crs":"",
                      "x":0.0,
                      "y":0.0
                   }
                }
             },
             "area1":{
                "name":"경기도",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.550802,
                      "y":37.4363177
                   }
                },
                "alias":"경기"
             },
             "area2":{
                "name":"성남시 분당구",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.118925,
                      "y":37.38282
                   }
                }
             },
             "area3":{
                "name":"정자동",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.111533,
                      "y":37.361458
                   }
                }
             },
             "area4":{
                "name":"",
                "coords":{
                   "center":{
                      "crs":"",
                      "x":0.0,
                      "y":0.0
                   }
                }
             }
          }
       },
       {
          "name":"admcode",
          "code":{
             "id":"4113555000",
             "type":"A",
             "mappingId":"02135550"
          },
          "region":{
             "area0":{
                "name":"kr",
                "coords":{
                   "center":{
                      "crs":"",
                      "x":0.0,
                      "y":0.0
                   }
                }
             },
             "area1":{
                "name":"경기도",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.550802,
                      "y":37.4363177
                   }
                },
                "alias":"경기"
             },
             "area2":{
                "name":"성남시 분당구",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.118925,
                      "y":37.38282
                   }
                }
             },
             "area3":{
                "name":"정자1동",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.106363,
                      "y":37.372799
                   }
                }
             },
             "area4":{
                "name":"",
                "coords":{
                   "center":{
                      "crs":"",
                      "x":0.0,
                      "y":0.0
                   }
                }
             }
          }
       },
       {
          "name":"addr",
          "code":{
             "id":"4113510300",
             "type":"L",
             "mappingId":"02135103"
          },
          "region":{
             "area0":{
                "name":"kr",
                "coords":{
                   "center":{
                      "crs":"",
                      "x":0.0,
                      "y":0.0
                   }
                }
             },
             "area1":{
                "name":"경기도",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.550802,
                      "y":37.4363177
                   }
                },
                "alias":"경기"
             },
             "area2":{
                "name":"성남시 분당구",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.118925,
                      "y":37.38282
                   }
                }
             },
             "area3":{
                "name":"정자동",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.111533,
                      "y":37.361458
                   }
                }
             },
             "area4":{
                "name":"",
                "coords":{
                   "center":{
                      "crs":"",
                      "x":0.0,
                      "y":0.0
                   }
                }
             }
          },
          "land":{
             "type":"1",
             "number1":"178",
             "number2":"1",
             "addition0":{
                "type":"",
                "value":""
             },
             "addition1":{
                "type":"",
                "value":""
             },
             "addition2":{
                "type":"",
                "value":""
             },
             "addition3":{
                "type":"",
                "value":""
             },
             "addition4":{
                "type":"",
                "value":""
             },
             "coords":{
                "center":{
                   "crs":"",
                   "x":0.0,
                   "y":0.0
                }
             }
          }
       },
       {
          "name":"roadaddr",
          "code":{
             "id":"4113510300",
             "type":"L",
             "mappingId":"02135103"
          },
          "region":{
             "area0":{
                "name":"kr",
                "coords":{
                   "center":{
                      "crs":"",
                      "x":0.0,
                      "y":0.0
                   }
                }
             },
             "area1":{
                "name":"경기도",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.550802,
                      "y":37.4363177
                   }
                },
                "alias":"경기"
             },
             "area2":{
                "name":"성남시 분당구",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.118925,
                      "y":37.38282
                   }
                }
             },
             "area3":{
                "name":"정자동",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.111533,
                      "y":37.361458
                   }
                }
             },
             "area4":{
                "name":"",
                "coords":{
                   "center":{
                      "crs":"",
                      "x":0.0,
                      "y":0.0
                   }
                }
             }
          },
          "land":{
             "type":"",
             "number1":"6",
             "number2":"",
             "addition0":{
                "type":"building",
                "value":"NAVER그린팩토리"
             },
             "addition1":{
                "type":"zipcode",
                "value":"463867"
             },
             "addition2":{
                "type":"roadGroupCode",
                "value":"411353180030"
             },
             "addition3":{
                "type":"",
                "value":""
             },
             "addition4":{
                "type":"",
                "value":""
             },
             "name":"불정로",
             "coords":{
                "center":{
                   "crs":"",
                   "x":0.0,
                   "y":0.0
                }
             }
          }
       }
      ]
      }
      

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

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

    처리중...