지오코딩 서비스(GEOCODER-XR) 기능 개선

OpenAPI 형태의 서비스 단위로 제공되는 GEOCODER-XR이 고객의 요구사항에 맞춰 개선되었습니다. 다음과 같이 3가지 내용이 변경되었습니다.

  1. 지오코딩 결과에 대한 정좌표, 인근좌표, 대표좌표에 대한 구분(기존에는 인근좌표와 대표좌표의 구분이 없었음)
  2. 결과가 여러 개인 경우 정확도 순서에 따라 정렬해서 모든 결과를 다 제공하도록 변경
  3. 결과 형식을 JSON으로 변경(기존은 XML 형식였음)

예를들어 주소 중 “중앙동”으로 검색을 하기 위한 REST 방식의 OpenAPI는 다음과 같습니다.

http://localhost:8080/Gp?command=gc;addr=중앙동

위의 호출에 대한 결과는 다음과 같습니다.

[
   {
      "user-input":"중앙동",
      "full-address":"경기도 성남시 중원구 중앙동",
      "coordinate":[
         37.43959765091859,
         127.1505276103632
      ],
      "vicinity":true,
      "type":"대표좌표"
   },
   {
      "user-input":"중앙동",
      "full-address":"경상남도 통영시 중앙동",
      "coordinate":[
         34.84482143430977,
         128.42308057122085
      ],
      "vicinity":true,
      "type":"대표좌표"
   },
   {
      "user-input":"중앙동",
      "full-address":"경상남도 창원시 진해구 중앙동",
      "coordinate":[
         35.14902784720422,
         128.66126916577852
      ],
      "vicinity":true,
      "type":"대표좌표"
   },

   ...
]

JSON 형식이며 중앙동이라는 이름의 행정명칭은 우리나라에 여러 개이므로 복수의 결과를 모두 전달하고 vicinity가 true이므로 인근좌표이면서 type을 통해 “대표좌표”라는 것을 파악할 수 있습니다.

이번에는 “중앙로10″으로 호출하기 위해 다음 API를 사용합니다.

http://localhost:8080/Gp?command=gc;addr=중앙로10

결과는 다음과 같습니다.

[
   {
      "user-input":"중앙로10",
      "full-address":"경기도 가평군 중앙로 10 (가평읍)",
      "coordinate":[
         37.82638794989058,
         127.5132600931772
      ],
      "vicinity":false,
      "type":"도로명주소"
   },
   {
      "user-input":"중앙로10",
      "full-address":"강원도 영월군 중앙로 10 (영월읍)",
      "coordinate":[
         37.18337775533778,
         128.46505641724204
      ],
      "vicinity":false,
      "type":"도로명주소"
   },
   {
      "user-input":"중앙로10",
      "full-address":"강원도 원주시 중앙로 10 (인동)",
      "coordinate":[
         37.34571078558531,
         127.95473309264851
      ],
      "vicinity":false,
      "type":"도로명주소"
   },

   ...
]

vicinity 값이 false이므로 “정좌표”를 의미합니다.

마지막으로 정확히 1건으로 매칭되는 주소에 대한 경우입니다.

http://localhost:8080/Gp?command=gc;addr=아차산로7나길18

결과는 다음과 같습니다.

[
   {
      "user-input":"아차산로7나길18",
      "full-address":"서울특별시 성동구 아차산로7나길 18 (성수동2가)",
      "coordinate":[
         37.54770170889392,
         127.05746040023593
      ],
      "vicinity":false,
      "type":"도로명주소"
   }
]

주소 좌표 변환 툴, Geocoder-Xr

개 요

Geocoder-Xr은 주소를 좌표로 변환하거나 좌표를 주소로 변환하여 그 결과를 SHP 파일로 저장해 주는 툴입니다. 전국의 지번주소와 도로명주소를 기반으로 지속적으로 DB가 업데이트됩니다. 이 프로그램은 특별한 공지가 없는 한 사용에 있어서 변환 건수 등과 같은 제한이 없습니다. 본 서비스의 사용자가 많은 관계로 보다 더 많은 사용자가 원할하게 이용할 수 있도록 서비스 속도가 실제보다 수초 정도 지연될 수 있습니다.

Release Note

  • [2022/02/28] 주소DB(도로명주소, 지번주소, 행정동)가 2022년 2월 DB로 업데이트 되었습니다.
  • [2021/01/19] 기존의 정좌표 및 인근좌표를 포함하여 새롭게 대표좌표(행정명, 도로명)를 지원하며 주소 DB(지번주소, 도로명주소, 행정동)가 2021년도 1월 자료로 업데이트 되었습니다.
  • [2020/06/17] 지오코딩 정확도 개선과 주소 DB(지번주소, 도로명주소, 행정동)가 2020년도 5월 자료로 업데이트 되었습니다.
  • [2020/06/10] 지오코딩 정확도 향상 및 인근좌표 변환 기능을 지원합니다. 기존 버전도 그대로 사용할 수 있지만 보다 원할하게 사용하기 위해서 버전4를 다운로드해 사용하시기 바랍니다.
  • [2020/04/10] 주소에서 불필요한 문자열을 제거하는 코드가 추가되어 성공율을 향상시켰습니다.
  • [2020/04/06] 속성 문자에 대한 인코딩을 UTF-8과 EUC-KR(기본값) 중 선택할 수 있도록 개선 되었습니다.
  • [2019/10/23] 법정동 뿐만 아니라 행정동(2019년 10월 DB)에 대한 지오코딩이 가능하도록 개 선되었습니다.
  • [2019/10/16] 도로명주소 및 지번주소가 2019년 9월 DB로 업데이트되었습니다.
  • [2019/07/17] 도로명주소가 2019년 5월 DB로 업데이트되었으며, 좌표 변환시 타원체가 동일한 경우에는 변환 파라메터를 적용하지 않도록 하여 정확한 좌표로 변환됩니다.
  • [2018/12/13] 주소를 좌표로 변환하는 기능 뿐만 아니라 좌표를 주소로 변환할 수 있는 기능, 주소를 좌표로 변환 시 좌표체계 설정 기능 추가 및 한글깨짐 문제 등이 해결 되었습니다.
  • [2018/11/01] 지번주소 및 도로명주소 DB가 2018년 10월 데이터로 업데이트 되었습니다.
  • [2017/06/08] 주요지명(POI) 및 필지가 ‘산’인 주소에 대한 지오코딩이 가능하며 지오코딩 성공율이 더욱 향상되었습니다.
  • [2017/05/11] 3.0으로 버전업 되었으며 도로명 주소와 지적도가 각각 2017년 3월, 2017년 5월 구축 DB로 업데이트 되었습니다.
  • [2016/05/03] 도로명 주소 데이터가 최신 DB(2016년 2월 버전)으로 업데이트 되으며, 지적도 DB를 활용하여 지번주소도 변환이 가능합니다.
  • [2015/06/06] 도로명 주소 데이터가 최신 DB(2015년 6월 버전)으로 업데이트 되었습니다.
  • [2014/09/28] 도로명 주소 데이터가 최신 DB(2014년 9월 버전)으로 업데이트 되었으며 매칭율이 더 향상 되었습니다.

지원되는 EPSG

주소를 좌표로 변환할 때 적용되는 좌표계는 EPSG 방식으로 지정할 수 있으며 현재 지원되는 EPSG는 다음과 같습니다.

  • EPSG:4326 – WGS84 타원체의 경위도 좌표계
  • EPSG:3857 – Google, VWorld의 좌표계
  • EPSG:5174 – 경도 10.405초 보정된 Bessel 타원체의 TM 중부원점
  • EPSG:5179 – GRS80 타원체의 UTM-K 좌표계

사용 설명

주소를 좌표로 변환하기

변환할 주소는 아래의 그림처럼 엑셀 또는 메모장을 통해 CSV 포맷으로 저장하여 사용할 수 있습니다. CSV는 각 데이터를 컴마(,)로 구분하는 데이터 형식이며 첫줄은 반드시 영문의 필드명으로 구성되어야 합니다.

이 입력 데이터를 GeoCoder-Xr 프로그램에서 “입력파일” 버튼을 통해 읽은 후 주소 필드를 지정하고 결과 포맷으로 저장할 SHP 파일을 지정하면 아래의 화면처럼 구성됩니다.

이제 좌표로 변환하기 위한 시작 버튼을 누르면 좌표로 변환됩니다. 성공적으로 변환되면 아래의 화면처럼 변환된 지점이 지도에 표시됩니다.

좌표를 주소로 변환하기

반대로, 좌표를 주소로 변환할 수 있으며 아래와 같은 화면처럼 입력값들을 지정하면 됩니다.

설치

아래의 설치 파일을 다운로드 받아 바로 설치하시면 됩니다.

Geocoder-Xr은 인터넷을 통해 지오코딩 기능을 수행하므로, 사용자의 IP와 함께 주소 데이터가 수집됩니다. 수집된 데이터는 더 나은 지오코딩 서비스 개선을 위해 활용됩니다. 이러한 사용자의 IP와 주소 데이터의 수집에 대해 동의할 경우에만 Geocoder-Xr을 이용하기 바랍니다.

사용에 있어 문의점이나 개선점에 대한 피드백은 댓글로 남겨 주시기 바랍니다.