[공지] 좌표로 주소 변환하기 API 업데이트 예정 안내 / [Update Notice] Converting coordinates to address API

Notice / 공지
1

안녕하세요, 카카오입니다.

오는 2022년 1월, 좌표로 주소 변환하기(/v2/local/geo/coord2address) API가 서비스 품질 개선을 위해 개편될 예정입니다.

변경일

  • 2022년 1월 17일(월) 오후 2시경

변경사항

  • 건물군 데이터를 도입하여 도로명 주소 결과 제공 범위 확대
  • API 성능 및 효율 향상

필요한 조치

요청 규격 및 결과 포맷이 기존과 동일하므로 추가 조치가 필요하지 않습니다.
다만 일부 케이스의 결과 값이 달라질 수 있어, 기존과 같이 데이터 파싱이 가능한지 사전 테스트가 필요합니다.

변경되는 결과의 예시는 다음을 참고합니다.

건물군 영역 내 좌표

  • 도로명 주소와 대표 지번 주소 반환
  • 좌표 기준 지번 주소가 건물 대표 지번 주소와 일치할 경우, 결과 변경 없음
  • 아래 표 참고, 결과가 변경된 부분 기울임 표시
요청 좌표 변경 전 변경 후
x : 126.95403541792821
y : 37.46195385195207		 도로명 : -
지번 : 서울 관악구 신림동 산 56-1		 도로명 : 서울특별시 관악구 관악로 1
지번 : 서울 관악구 신림동 산 56-1
x : 127.20219040487775
y : 37.29310022815422		 도로명 : -
지번 : 경기 용인시 처인구 포곡읍 전대리 519-21		 도로명 : 경기도 용인시 처인구 포곡읍 에버랜드로 199
지번 : 경기 용인시 처인구 포곡읍 전대리 310
x : 127.07301361170195
y : 37.51464918729185		 도로명 : -
지번 : 서울 송파구 잠실동 10-1		 도로명 : 서울특별시 송파구 올림픽로 25
지번 : 서울 송파구 잠실동 10
x : 127.01024974149426
y : 37.51584840034148		 도로명 : -
지번 : 서울 서초구 잠원동 56-6		 도로명 : 서울특별시 서초구 잠원로8길 3
지번 : 서울 서초구 잠원동 56-2
x : 126.41903004858595
y : 33.48843217013981		 도로명 : 제주특별자치도 제주시 애월읍 하귀1길 1
지번 : 제주특별자치도 제주시 애월읍 하귀1리 258-3		 도로명 : 제주특별자치도 제주시 애월읍 하귀1길 1
지번 : 제주특별자치도 제주시 애월읍 하귀1리 265-1
x : 127.10872103809787
y : 37.40206053249132		 도로명 : 경기도 성남시 분당구 판교역로 235
지번 : 경기 성남시 분당구 삼평동 681		 기존과 동일

건물, 건물군 영역에 모두 해당하지 않음

  • 결과 변경 없음

사전 테스트 URL

API 변경사항을 미리 확인하실 수 있도록 테스트 URL을 제공합니다.
테스트 중 포맷 관련 문제가 발생할 경우 문의 부탁 드립니다.

테스트 URL은 개편 후 삭제되오니, 테스트용으로만 사용하고 실제 서비스에 적용하지 않아야 합니다.

https://dapi.kakao.com/v2/local/test/geo/coord2address.{format}

카카오 지도 SDK 및 로컬 API에 대해 궁금하신 점은 지도/로컬 게시판으로 문의주시기 바랍니다.
언제나 더 좋은 서비스를 제공할 수 있도록 노력하겠습니다.
감사합니다.

=====

Hello. This is Kakao Developers.

We inform you that there will be some upgrades in the response result of the Converting coordinates to address API for quality improvements on January 17, 2022.

Effective Date

  • Around 2 P.M. on Monday, January 17, 2022

Target

Changes

  • Provides more detailed road name address through a new logic that uses building group data.

  • Improves API performance and efficiency.

What to do

  • You do not have to do anything to apply the upgraded version of the API since the response format is the same as the existing API. There is no change in the parameter names, types, and supported coordinates systems.

  • We provide the test URL for you to check the response results in advance. If you encounter errors in response format during the test, ask us through the Map/Local API forum:

    • https://dapi.kakao.com/v2/local/test/geo/coord2address.{format}

IMPORTANT
Do not use this URL for your actual service. Note that the above test URL is provided temporarily and will be deleted as the changes are applied to the response result of the Converting coordinates to address API.

Examples of API change

Request coordinates Before change After change Remarks
x : 126.95403541792821
y : 37.46195385195207		 Road name address: -

Land-lot number address:
서울 관악구 신림동 산 56-1		 Road name address: 서울특별시 관악구 관악로 1

Land-lot number address:
서울 관악구 신림동 산 56-1		 See (1)
x : 127.20219040487775
y : 37.29310022815422		 Road name address: -

Land-lot number address:
경기 용인시 처인구 포곡읍 전대리 519-21		 Road name address: 경기도 용인시 처인구 포곡읍 에버랜드로 199

Land-lot number address:
경기 용인시 처인구 포곡읍 전대리 310		 See (1)
x : 127.07301361170195
y : 37.51464918729185		 Road name address: -

Land-lot number address:
서울 송파구 잠실동 10-1		 Road name address:
서울특별시 송파구 올림픽로 25

Land-lot number address:
서울 송파구 잠실동 10		 See (1)
x : 127.01024974149426
y : 37.51584840034148		 Road name address:
-

Land-lot number address:
서울 서초구 잠원동 56-6		 Road name address:
서울특별시 서초구 잠원로8길 3

Land-lot number address:
서울 서초구 잠원동 56-2		 See (1)
x : 126.41903004858595
y : 33.48843217013981		 Road name address:
제주특별자치도 제주시 애월읍 하귀1길 1

Land-lot number address:
제주특별자치도 제주시 애월읍 하귀1리 258-3		 Road name address:
제주특별자치도 제주시 애월읍 하귀1길 1

Land-lot number address:
제주특별자치도 제주시 애월읍 하귀1리 265-1		 See (1)
x : 127.10872103809787
y : 37.40206053249132		 Road name address:
경기도 성남시 분당구 판교역로 235

Land-lot number address:
경기 성남시 분당구 삼평동 681		 No change See (2)
x : 127.10839182429355
y : 37.3969723183273		 Road name address:
-

Land-lot number address:
경기 성남시 분당구 삼평동 641		 No change See (3)
x : 126.9715779620982
y : 37.49944360204868		 Road name address: -

Land-lot number address:
서울 동작구 동작동 278-2		 No change See (3)

(1) If the coordinates are included in a building group, the building group’s address and its main land-lot address are returned.
(2) If the land-lot address of the coordinates is the building representative lot address, the same results are returned even though the coordinates are at a building area.
(3) If the coordinates are not a building or not included in a building group, the same results are returned.


Thank you.


Kakao Developers

2개의 좋아요