Geolocation

지도(위치) 관련 정보를 제공하는 서비스입니다.

주소에 대한 우편번호 조회 서비스
요청 주소 대해 우편번호 및 주소 리스트를 리턴합니다.
End Point Method Parameter
/v1/geolocation/inquiry/postcode GET Query

Request Parameters
필드 설명 타입
address_query 주소검색어
- 도로명 + 건물번호 (예) 도움5로 19
- 건물명 (예) 우정사업본부
- 읍/면/동/리 + 지번 (예) 어진동 307-19
- 사서함 + 사서함번호 (예) 광화문우체국사서함 45 		String
count_per_page 페이지당 데이터 개수 String
search_page 조회페이지 String

Response
필드 설명 타입
postcd 우편번호 String
address 도로명주소 String
addrjibun 지번주소 String
addressEng 영문주소 String

Response Sample


{
  "code": "0000",
  "message": "정상처리",
  "body": {
    "total_page": 2,
    "total_count": 18,
    "list": [
      {
        "postcd": "05700",
        "address": "서울특별시 송파구 양재대로68길 3 (가락동, 동방빌라)",
        "addressEng": "3, Yangjae-daero 68-gil, Songpa-gu, Seoul, 05700",
        "addrjibun": "서울특별시 송파구 가락동 1 (동방빌라)"
      },
      {
        "postcd": "05700",
        "address": "서울특별시 송파구 양재대로68길 3-3 (가락동, 다우빌라)",
        "addressEng": "3, Yangjae-daero 68-gil, Songpa-gu, Seoul, 05700",
        "addrjibun": "서울특별시 송파구 가락동 1-1 (다우빌라)"
      },
      #...
    ]
  }
}
IP주소에 대한 위치 확인 서비스
IP주소 대해 위치정보를 리턴합니다.
End Point Method Parameter
/v1/geolocation/inquiry/byip GET Query

Request Parameters
필드 설명 타입
ip_address IP주소 String

Response
필드 설명 타입
ip_address IP주소 String
country_code 국가코드 String
country_name 국가명 String
subdivision_code 주소코드 String
subdivision_name 주소명 String
city 도시 String
postal_code 우편번호 String
latitude 위도 String
longitude 경도 String

Response Sample


{
  "code": "0000",
  "message": "정상처리",
  "body": {
    "country_code": "US",
    "city": null,
    "subdivision_name": null,
    "latitude": 37.751,
    "country_name": "United States",
    "subdivision_code": null,
    "ip_address": "198.121.0.0",
    "postal_code": null,
    "longitude": -97.822
  }
}