Reverse Geocoding
- 인쇄
- PDF
Reverse Geocoding
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
Reverse Geocoding API는 네이버 지도에서 좌표를 주소 정보로 변환(coordsToAddr)하는 서비스를 제공합니다. Reverse geocoding API를 이용해 특정 좌표에 해당하는 국내 법정동, 행정동, 지번 주소, 도로명 주소 정보를 얻을 수 있습니다.
참고
Reverse geocoding 서비스는 EPSG(European Petroleum Survey Group)에서 지정한 일부 좌표 체계와 국내에서 주로 사용하는 좌표 체계를 지원합니다.
Reverse Geocoding API 이용 방법은 API 참조서의Reverse Geocoding에서 상세하게 설명하고 있습니다. API 참조서의 Reverse Geocoding으로 이동하여 정보를 확인하려면 Reverse Geocoding API v2를 클릭해주십시오.
| 기능 | 바로 가기 |
|---|---|
| 입력한 주소를 좌표 정보와 상세 정보로 반환 | Reverse Geocoding API v2 |
참고
주소를 좌표 정보로 변환하려면 Geocoding API를 사용해야 합니다. 자세한 내용은 Geocoding API 참조서를 참고해주십시오.
주의
현재 제공 중인 Reverse Geocoding API는 2019년 3월 1일 업데이트된 새로운 버전(v2)입니다. 기존 버전(v1)을 사용 중인 경우 API가 정상 호출되지 않으므로 Reverse Geocoding API v2의 달라진 점을 참고하여 코드를 수정해 주십시오.
Reverse Geocoding API v2의 달라진 점
Reverse Geocoding API가 v1에서 v2로 버전이 변경되면서 요청 파라미터와 응답 형식에서 일부 내용이 업데이트됐습니다.
요청 파라미터
요청 파라미터에서 달라진 점은 다음과 같습니다.
- 응답 인코딩 파라미터(encoding) 미지원(항상 'utf-8'로 응답)
- 파라미터명 변경
- 좌표값 : query → coords
- 출력좌표계 : coordType → targetcrs
- 필수 파라미터 추가
- request=coordsToaddr
- output 파라미터로 응답 형식(xml/json) 선택
- 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와 동일한 결과(법정동, 행정동 정보 반환)
- orders=legalcode,admcode,addr,roadaddr: v1(개발자센터 API)에서와 같이 모든 주소
참고
상세 주소(지번, 도로명) 정보 반환을 위한 호출문은 orders=addr,roadaddr보다는 orders=legalcode,admcode,addr,roadaddr과 같은 형식으로 작성해야 해안가, 강, 신규 택지 등 상세 주소가 없는 지역의 경우 법정동, 행정동 정보를 결과로 반환할 수 있습니다.
응답 형식
응답 형식에서 달라진 점은 다음과 같습니다.
- 응답 결과의 행정단위별 depth 구조가 있으며 각각의 중심 좌표 정보도 제공
- 도로명 주소의 경우 우편번호가 있는 위치의 좌표 결과라면 우편번호 정보도 함께 제공
- 단일 tag로 full address를 제공하는 항목(v1의 'address') 없음
참고
depth 구조 및 상세 정보를 함께 제공하게 되면서 기존 v1보다 v2의 응답 길이가 길어졌습니다.
예제
기존 버전(v1)에서의 검색 결과와 새로운 버전(v2)에서의 검색 결과 예제는 다음과 같습니다.
- 기존 버전에서의(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
}
}
}
}
]
}
이 문서가 도움이 되었습니까?