Login
      내용 x
      Reverse Geocoding API
        • 인쇄
        • PDF
        내용

        Reverse Geocoding API

          • 인쇄
          • PDF
          기사 요약

          VPC 환경에서 이용 가능합니다.

          입력한 좌표 값을 주소 정보(법정동, 행정동, 지번 주소, 도로명 주소)로 변환합니다.

          참고

          Reverse Geocoding API에서는 EPSG (European Petroleum Survey Group)에서 지정한 일부 좌표 체계와 한국에서 주로 사용하는 좌표 체계를 지원합니다. 지원되는 좌표 체계에 대한 자세한 정보는 좌표 체계를 참조해 주시오.

          요청

          요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

          메서드URI
          GET/gc

          요청 헤더

          Maps API에서 공통으로 사용하는 헤더에 대한 정보는 Maps 공통 헤더를 참조해 주십시오.

          요청 쿼리 파라미터

          요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.

          필드타입필수 여부설명
          coordsStringRequired좌표(X 좌표,Y 좌표)
          • <예시> coords=128.12345,37.98776
          sourcecrsStringOptional입력 좌표계 코드
          • EPSG:4326 (기본값) | EPSG:3857 | NHN:2048
            • EPSG:4326: WGS84 경위도
            • EPSG:3857: 구글 맵
            • NHN:2048: UTM-K
          • 지원되는 좌표계 코드는 좌표 체계 참조
          targetcrsStringOptional출력 좌표계 코드
          • EPSG:4326 (기본값) | EPSG:3857 | NHN:2048
            • EPSG:4326: WGS84 경위도
            • EPSG:3857: 구글 맵
            • NHN:2048: UTM-K
          • 지원되는 좌표계 코드는 좌표 체계 참조
          ordersStringOptional변환 타입
          • legalcode (기본값) | admcode (기본값) | addr | roadaddr
            • legalcode: 법정동으로 변환
            • admcode: 행정동으로 변환
            • addr: 지번 주소로 변환
            • roadaddr: 도로명 주소로 변환
          • ','로 구분하여 여러 옵션 값을 입력할 수 있으며, 입력순으로 결과 표시
          • 해안선 부근이나 신규 택지 등 상세 주소가 없는 지역의 좌표 변환 시 addr 또는 roadaddr로 요청하면 결과가 반환되지 않을 수 있으나, legalcode 또는 admcode로 요청하면 법정동 또는 행정동 단위 주소 확인 가능
          • <예시> orders=legalcode,addr
          outputStringOptional응답 결과의 포맷 유형
          • xml (기본값) | json
          callbackStringOptional콜백 이름
          • JSONP 통신을 위해 콜백 처리 시 이용
          • 입력한 이름으로 JSON 데이터를 감싸서 반환
          • output이 json인 경우에만 입력 가능
          • <예시> callback=abc

          좌표 체계

          좌표 체계에 대한 설명은 다음과 같습니다.

          이름코드구분GCS 정보PCS 정보
          구글 맵EPSG:3857PCSWGS_1984WGS_19846378137 (Semi_Minor)298.2572236GreenwichDegreeM0000Meter1
          WGS 84 경위도EPSG:4326GCSWGS_1984WGS_19846378137298.2572236GreenwichDegree-------
          UTM-KNHN:2048PCSD_ITRF_2000GRS_19806378137298.2572221GreenwichDegreeTM127.5382,000,0001,000,000Meter0.9996

          요청 예시

          요청 예시는 다음과 같습니다.

          curl --location --request GET 'https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?coords=127.585%2C34.9765&output=json&orders=legalcode%2Cadmcode%2Caddr%2Croadaddr' \
--header 'x-ncp-apigw-api-key-id: {API Key ID}' \
--header 'x-ncp-apigw-api-key: {API Key}'
          참고

          입력한 좌표에 따라 다양한 응답 결과가 반환될 수 있습니다. 다음의 요청 예시를 참조해 주십시오.

          • 일반 읍/면/동
            • https://naveropenapi.apigw.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.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=129.1133567,35.2982640&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml
          • 일반 리: 법정동 단위인 읍/면 하위의 리 단위 좌표는 admcode 결과에도 codeType이 L로 표시됨
            • https://naveropenapi.apigw.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.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=127.1114893,37.3614463&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml
          • 세종시: 시/군/구에 대한 데이터가 존재하지 않고, 영역은 다르지만 하위의 모든 행정동의 법정동이 동일하게 표시됨
            • 세종시 어진동: https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=127.2654387,36.5008113&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xm
            • 세종시 조치원읍: https://naveropenapi.apigw.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.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=125.9913201,37.5666936&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml

          응답

          응답 형식을 설명합니다.

          응답 바디

          응답 바디에 대한 설명은 다음과 같습니다.

          필드타입필수 여부설명
          statusObject-응답 상태에 대한 정보
          status.codeInteger-응답 상태 코드
          status.nameString-응답 상태 메시지
          status.messageString-응답 상태에 대한 설명
          resultsArray-응답 결과

          results

          results에 대한 설명은 다음과 같습니다.

          필드타입필수 여부설명
          nameString-변환 타입
          codeObject-코드 정보
          code.idString-코드 ID
          code.typeString-코드 타입
          • L | A | S
            • L: 법정동
            • A: 행정동
            • S: 영역은 다르지만 동일한 이름의 법정동이 존재하는 행정동
          code.mappingIdString-법정/행정 코드에 매핑된 네이버 동 코드의 ID
          regionObject-주소 정보
          region.areaNObject-행정 구역 정보
          • 변환된 주소의 가장 큰 행정 구역 단위부터 순차적으로 표시
          region.areaN.nameString-행정 구역 단위 이름
          • region.area0.name: 국가 코드 최상위 도메인으로, kr 표시
          • region.area1.name: 행정안전부에서 공시한 시/도 이름
          • region.area2.name: 행정안전부에서 공시한 시/군/구 이름
          • region.area3.name: 행정안전부에서 공시한 읍/면/동 이름
          • region.area4.name: 행정안전부에서 공시한 리 이름
          region.areaN.coordsObject-행정 구역 위치 정보
          region.areaN.coords.centerObject-행정 구역 중심 좌표
          region.areaN.coords.center.crsString-좌표계 코드
          region.areaN.coords.center.xFloat-X 좌표
          • land.coords.center.crs이 EPSG:4326인 경우, 경도
          region.areaN.coords.center.yFloat-Y 좌표
          • land.coords.center.crs이 EPSG:4326인 경우, 위도
          landObject-상세 주소 정보
          land.typeString-지적 타입
          • name이 addr인 경우에만 상세 값 표시
          • 1 | 2
            • 1: 일반 토지
            • 2: 산
          land.nameString-도로 이름
          • name이 roadaddr인 경우에만 상세 값 표시
          land.number1String-상세 번호
          • name이 addr인 경우 토지 본번호
          • name이 roadaddr인 경우 상세 주소
          land.number2String-토지 부번호
          • name이 addr인 경우에만 상세 값 표시
          land.coordsObject-상세 주소 위치 정보
          land.coords.centerObject-상세 주소 중심 좌표
          land.coords.center.crsString-좌표계 코드
          land.coords.center.xFloat-X 좌표
          • land.coords.center.crs이 EPSG:4326인 경우, 경도
          land.coords.center.yFloat-Y 좌표
          • land.coords.center.crs이 EPSG:4326인 경우, 위도
          land.additionNObject-추가 정보
          • name이 roadaddr인 경우에만 상세 값 표시
          • land.addition0: 건물 정보
          • land.addition1: 우편 번호 정보
          • land.addition2: 도로 코드 정보
          land.additionN.typeString-추가 정보 타입
          • land.addition0.type: building
          • land.addition1.type: zipcode
          • land.addition2.type: roadGroupCode
          land.additionN.valueString-추가 정보 값
          • land.addition0.value: 건물 이름
          • land.addition1.value: 우편번호
          • land.addition2.value: 도로 코드(12자리)

          응답 상태 코드

          응답 상태 코드에 대한 설명은 다음과 같습니다.

          HTTP 상태 코드코드메시지설명
          2000ok요청 처리 성공. 응답 결과 반환
          2003no results요청 처리 성공. 응답 결과 반환되지 않음
          400100invalid request요청 파라미터 오류
          500900unknown error / io error정의되지 않은 오류
          참고

          Maps API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Maps 공통 응답 상태 코드를 참조해 주십시오.

          응답 예시

          응답 예시는 다음과 같습니다.

          {
    "status": {
        "code": 0,
        "name": "ok",
        "message": "done"
    },
    "results": [
        {
            "name": "legalcode",
            "code": {
                "id": "4623025024",
                "type": "L",
                "mappingId": "1223025024"
            },
            "region": {
                "area0": {
                    "name": "kr",
                    "coords": {
                        "center": {
                            "crs": "",
                            "x": 0.0,
                            "y": 0.0
                        }
                    }
                },
                "area1": {
                    "name": "전라남도",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 126.957167,
                            "y": 34.900727
                        }
                    },
                    "alias": "전남"
                },
                "area2": {
                    "name": "광양시",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 127.695899,
                            "y": 34.940658
                        }
                    }
                },
                "area3": {
                    "name": "광양읍",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 127.58105,
                            "y": 34.97341
                        }
                    }
                },
                "area4": {
                    "name": "읍내리",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 127.5863,
                            "y": 34.9751
                        }
                    }
                }
            }
        },
        {
            "name": "admcode",
            "code": {
                "id": "4623025000",
                "type": "L",
                "mappingId": "12230250"
            },
            "region": {
                "area0": {
                    "name": "kr",
                    "coords": {
                        "center": {
                            "crs": "",
                            "x": 0.0,
                            "y": 0.0
                        }
                    }
                },
                "area1": {
                    "name": "전라남도",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 126.957167,
                            "y": 34.900727
                        }
                    },
                    "alias": "전남"
                },
                "area2": {
                    "name": "광양시",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 127.695899,
                            "y": 34.940658
                        }
                    }
                },
                "area3": {
                    "name": "광양읍",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 127.58105,
                            "y": 34.97341
                        }
                    }
                },
                "area4": {
                    "name": "",
                    "coords": {
                        "center": {
                            "crs": "",
                            "x": 0.0,
                            "y": 0.0
                        }
                    }
                }
            }
        },
        {
            "name": "addr",
            "code": {
                "id": "4623025024",
                "type": "L",
                "mappingId": "1223025024"
            },
            "region": {
                "area0": {
                    "name": "kr",
                    "coords": {
                        "center": {
                            "crs": "",
                            "x": 0.0,
                            "y": 0.0
                        }
                    }
                },
                "area1": {
                    "name": "전라남도",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 126.957167,
                            "y": 34.900727
                        }
                    },
                    "alias": "전남"
                },
                "area2": {
                    "name": "광양시",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 127.695899,
                            "y": 34.940658
                        }
                    }
                },
                "area3": {
                    "name": "광양읍",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 127.58105,
                            "y": 34.97341
                        }
                    }
                },
                "area4": {
                    "name": "읍내리",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 127.5863,
                            "y": 34.9751
                        }
                    }
                }
            },
            "land": {
                "type": "1",
                "number1": "252",
                "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": "4623025024",
                "type": "L",
                "mappingId": "1223025024"
            },
            "region": {
                "area0": {
                    "name": "kr",
                    "coords": {
                        "center": {
                            "crs": "",
                            "x": 0.0,
                            "y": 0.0
                        }
                    }
                },
                "area1": {
                    "name": "전라남도",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 126.957167,
                            "y": 34.900727
                        }
                    },
                    "alias": "전남"
                },
                "area2": {
                    "name": "광양시",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 127.695899,
                            "y": 34.940658
                        }
                    }
                },
                "area3": {
                    "name": "광양읍",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 127.58105,
                            "y": 34.97341
                        }
                    }
                },
                "area4": {
                    "name": "읍내리",
                    "coords": {
                        "center": {
                            "crs": "EPSG:4326",
                            "x": 127.5863,
                            "y": 34.9751
                        }
                    }
                }
            },
            "land": {
                "type": "",
                "number1": "20",
                "number2": "",
                "addition0": {
                    "type": "building",
                    "value": ""
                },
                "addition1": {
                    "type": "zipcode",
                    "value": "57742"
                },
                "addition2": {
                    "type": "roadGroupCode",
                    "value": "462304655159"
                },
                "addition3": {
                    "type": "",
                    "value": ""
                },
                "addition4": {
                    "type": "",
                    "value": ""
                },
                "name": "매일시장길",
                "coords": {
                    "center": {
                        "crs": "",
                        "x": 0.0,
                        "y": 0.0
                    }
                }
            }
        }
    ]
}
          이 문서가 도움이 되었습니까?
          What's Next
          Change password!
          Changing your password will log you out immediately. Use the new password to log back in.
          Change profile
          Success!
          First name must have atleast 2 characters. Numbers and special characters are not allowed.
          Last name must have atleast 1 characters. Numbers and special characters are not allowed.
          Enter a valid email
          Enter a valid password
          Your profile has been successfully updated.
          Logout