gc

개요

네이버 지도에서는 좌표를 주소를 변환(coordsToAddr)하는 Reverse geocoding 서비스를 제공합니다. Reverse geocoding API를 이용해 특정 좌표에 해당하는 국내 법정동/행정동/지번주소/도로명주소 정보를 얻을 수 있습니다.

Reverse geocoding 서비스는 EPSG(European Petroleum Survey Group)에서 지정한 일부 좌표 체계와 국내에서 주로 사용하는 좌표 체계를 지원합니다.

요청

curl "https://naveropenapi.apigw-pub.fin-ntruss.com/map-reversegeocode/v2/gc?coords={입력_좌표}&sourcecrs={좌표계}&orders={변환_작업_이름}&output={출력_형식}" \
	-H "X-NCP-APIGW-API-KEY-ID: {애플리케이션 등록 시 발급받은 client id값}" \
	-H "X-NCP-APIGW-API-KEY: {애플리케이션 등록 시 발급받은 client secret값}" -v

요청 파라미터

좌표 체계

요청 헤더

요청 바디

• 해당 API 는 요청 바디를 필요로 하지 않습니다.

응답

응답 바디

참고

변환 대상 좌표에 따라 다양한 응답 결과가 반환될 수 있습니다. 아래의 각 경우를 참고하세요.

• 일반 읍면동
  
  https://naveropenapi.apigw-pub.fin-ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=126.9913201,37.5666936&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml

https://naveropenapi.apigw-pub.fin-ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=129.1133567,35.2982640&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml

• 일반 '리': 법정동 단위인 '읍면' 하위의 '리' 단위 좌표이므로 admcode의 결과에도 code type은 'L'로 설정됩니다.
  
  https://naveropenapi.apigw-pub.fin-ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=128.2439084,36.4938906&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml

• 분당구 정자동: 법정동과 동일한 이름의 행정동이 존재합니다(영역은 서로 다름).
  
  https://naveropenapi.apigw-pub.fin-ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=127.1114893,37.3614463&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml

• 세종시 좌표: 시군구 area2 데이터가 없고 세종시 하위의 모든 행정동의 법정동이 동일합니다(영역은 서로 다름).

  • 도담동(법행정동일명): https://naveropenapi.apigw-pub.fin-ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=127.2654387,36.5008113&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml

  • 조치원읍(법정): https://naveropenapi.apigw-pub.fin-ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=127.2923750,36.5929071&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml

• 바다 위(데이터 없음): https://naveropenapi.apigw-pub.fin-ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=125.9913201,37.5666936&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml

예시

요청 예시

curl "https://naveropenapi.apigw-pub.fin-ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=129.1133567,35.2982640&sourcecrs=epsg:4326&output=json&orders=legalcode,admcode" \
	-H "X-NCP-APIGW-API-KEY-ID: {애플리케이션 등록 시 발급받은 client id값}" \
	-H "X-NCP-APIGW-API-KEY: {애플리케이션 등록 시 발급받은 client secret값}" -v

• 좌표를 법정 코드로 변환 요청
  https://naveropenapi.apigw-pub.fin-ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=129.1133567,35.2982640&sourcecrs=epsg:4326&output=json&orders=legalcode
• 좌표를 지번 주소, 행정 코드로 변환 요청
  https://naveropenapi.apigw-pub.fin-ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=129.1133567,35.2982640&sourcecrs=epsg:4326&output=json&orders=addr,admcode
• 좌표를 지번 주소, 행정 코드, 도로명 주소로 변환 요청
  https://naveropenapi.apigw-pub.fin-ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=129.1133567,35.2982640&sourcecrs=epsg:4326&output=json&orders=addr,admcode,roadaddr

응답 예시

{
    "status":{
            "code":0,
            "name":"ok",
            "message":"done"
        },
    "results":[
        {
            "name":"legalcode",
            "code":{
                "id":"2641010100",
                "type":"L",
                "mappingId":"08410101"
            },
            "region":{
                "area0":{
                    "name":"kr",
                    "coords":{
                        "center":{
                            "crs":"",
                            "x":0.0,
                            "y":0.0
                        }
                    }
                },
                "area1":{
                    "name":"부산광역시",
                    "coords":{
                        "center":{
                            "crs":"EPSG:4326",
                            "x":129.0750222,
                            "y":35.1798159
                        }
                    }
                },
                "area2":{
                    "name":"금정구",
                    "coords":{
                        "center":{
                            "crs":"EPSG:4326",
                            "x":129.0921,
                            "y":35.243068
                        }
                    }
                },
                "area3":{
                    "name":"두구동",
                    "coords":{
                        "center":{
                            "crs":"EPSG:4326",
                            "x":129.1133567,
                            "y":35.2982641
                        }
                    }
                },
                "area4":{
                    "name":"",
                    "coords":{
                        "center":{
                            "crs":"",
                            "x":0.0,
                            "y":0.0
                        }
                    }
                }
            }
        }
    ]
}

오류 코드

요청 결과가 정상이면 HTTP 상태 코드 200을 반환하며, 상세 코드는 다음과 같습니다.

요청 결과가 정상이 아니면 다음과 같이 반환됩니다.