Geocoding

Geocoding API는 지번, 도로명을 질의어로 사용해서 주소 정보를 검색하여 주소 목록과 세부 정보에 대한 검색 결과를 json 형태로 반환하는 서비스를 제공합니다. Geocoding API 이용 방법은 API 참조서의 Geocoding에서 상세하게 설명하고 있습니다. API 참조서의 Geocoding으로 이동하여 정보를 확인하려면 Geocoding API v2를 클릭해주십시오.

Geocoding API v2의 달라진 점

Geocoding API가 v1에서 v2로 버전이 변경되면서 요청 파라미터와 응답 형식에서 일부 내용이 업데이트됐습니다.

요청 파라미터

요청 파라미터에서 달라진 점은 다음과 같습니다.

• 응답 인코딩 파라미터(encoding) 미지원(항상 'utf-8'로 응답)
• 응답 좌표체계 파라미터(coordType) 미지원(항상 '위경도'로 응답) |

응답 형식

응답 형식에서 달라진 점은 다음과 같습니다.

• 검색어(query)에 해당하는 주소 결과에 대해 도로명, 지번, 영어 주소 3가지 형태 모두 제공- 기존 point 객체 내 x,y로 전달되던 좌표 정보를 point 객체 없이 바로 전달
• 기존 addrdetail에 내려 주던 정보가 addressElements 필드(array)로 대체되어 주소 타입과 값을 구조화하여 언제든 새로운 주소 타입을 추가할 수 있도록 확장(예: addressElements 중 types 값이 POSTAL_CODE인 경우 우편번호를 나타냄) |

예제

검색 쿼리값이 '연사리 93'인 경우 기존 버전(v1)에서의 검색 결과와 새로운 버전(v2)에서의 검색 결과 예제 예제는 다음과 같습니다.
​

• 기존 버전에서의(v1) 검색 결과

{
  "result": {
    "total": 1,
    "userquery": "연사리 93",
    "items": [
      {
        "address": "경상남도 거제시 연초면 연사리 93",
        "addrdetail": {
          "country": "대한민국",
          "sido": "경상남도",
          "sigugun": "거제시",
          "dongmyun": "연초면",
          "ri": "연사리",
          "rest": "93"
        },
        "isRoadAddress": false,
        "point": {
          "x": 128.6521583,
          "y": 34.9070498
        }
      }
    ]
  }
}

• 새로운 버전(v2)에서의 검색 결과

{
    "status": "OK",
    "meta": {
        "totalCount": 1,
        "page": 1,
        "count": 1
    },
    "addresses": [
        {
        "roadAddress": "경상남도 거제시 연초면 효촌1길 10-1",
        "jibunAddress": "경상남도 거제시 연초면 연사리 93",
        "englishAddress": "10-1, Hyochon 1-gil, Yeoncho-myeon, Geoje-si, Gyeongsangnam-do, Republic of Korea",
        "addressElements": [
            {
            "types": ["SIDO"],
            "longName": "경상남도",
            "shortName": "경상남도",
            "code": ""
            },
            {
            "types": ["SIGUGUN"],
            "longName": "거제시",
            "shortName": "거제시",
            "code": ""
            },
            {
            "types": ["DONGMYUN"],
            "longName": "연초면",
            "shortName": "연초면",
            "code": ""
            },
            {
            "types": ["RI"],
            "longName": "연사리",
            "shortName": "연사리",
            "code": ""
            },
            {
            "types": ["ROAD_NAME"],
            "longName": "효촌1길",
            "shortName": "효촌1길",
            "code": ""
            },
            {
            "types": ["BUILDING_NUMBER"],
            "longName": "10-1",
            "shortName": "10-1",
            "code": ""
            },
            {
            "types": ["BUILDING_NAME"],
            "longName": "",
            "shortName": "",
            "code": ""
            },
            {
            "types": ["LAND_NUMBER"],
            "longName": "93",
            "shortName": "93",
            "code": ""
            },
            {
            "types": ["POSTAL_CODE"],
            "longName": "53209",
            "shortName": "53209",
            "code": ""
            }
        ],
        "x": "128.6521583",
        "y": "34.9070498",
        "distance": 0
        }
    ],
    "errorMessage": ""
}