안녕하세요.
카카오맵 로컬 REST API 사용 중, 동일한 주소 또는 동일한 좌표에 대해 서로 상이한 결과가 반환되는 문제가 있어 문의드립니다.
아래 두 가지 사례를 통해 상세히 정리했습니다.
1. 주소 → 좌표 변환 시, 도로명주소 검색 결과는 없음. 지번으로 검색하면 동일 주소가 정상 반환되는 문제
다음 도로명주소로 주소 검색을 수행할 경우 검색 결과가 나오지 않습니다.
전북특별자치도 군산시 옥서면 산동길 2
■ 요청 코드
curl -X GET "https://dapi.kakao.com/v2/local/search/address.json?analyze_type=similar&page=1&size=10&query=전북특별자치도+군산시+옥서면+산동길+2" \
-H "Authorization: KakaoAK {REST_API_KEY}"
■ 반환 결과
{
"documents": [],
"meta": {
"is_end": true,
"pageable_count": 0,
"total_count": 0
}
}
그러나 동일 위치의 지번주소로 검색을 수행하면 방금 검색에서 없다고 반환되었던 도로명주소가 포함된 결과가 반환됩니다.
동일 위치의 지번주소 검색 시 정상 반환됨
지번주소:
전북특별자치도 군산시 옥서면 선연리 385
■ 요청 코드
curl -X GET "https://dapi.kakao.com/v2/local/search/address.json?analyze_type=similar&page=1&size=10&query=전북특별자치도+군산시+옥서면+선연리+385" \
-H "Authorization: KakaoAK {REST_API_KEY}"
■ 반환 결과 (일부)
{
"documents": [
{
"address": {
"address_name": "전북특별자치도 군산시 옥서면 선연리 385",
"main_address_no": "385",
"region_1depth_name": "전북특별자치도",
"region_2depth_name": "군산시",
"region_3depth_name": "옥서면 선연리",
"x": "126.615614887301",
"y": "35.9264364527116"
},
"road_address": {
"address_name": "전북특별자치도 군산시 옥서면 산동길 2",
"road_name": "산동길",
"main_building_no": "2",
"zone_no": "54168"
}
}
]
}
문의사항
- 도로명주소 데이터 누락 또는 매칭 기준 차이 때문인지 확인 부탁드립니다.
2. 주소 → 좌표 변환과 좌표 → 주소 변환 결과가 서로 다르게 표시되는 문제
다음 도로명주소로 검색 후 반환된 좌표를 다시 좌표→주소 변환 API에 넣으면
도로명주소 표기 방식이 서로 달라지는 현상이 있습니다.
검색 주소:
대구광역시 수성구 미술관로 40
■ Step 1 — 주소 → 좌표 변환
요청 코드
curl -X GET "https://dapi.kakao.com/v2/local/search/address.json?analyze_type=similar&page=1&size=10&query=대구광역시+수성구+미술관로+40" \ -H "Authorization: KakaoAK {REST_API_KEY}"
반환 결과 (일부)
{
"address_name": "대구 수성구 미술관로 40",
"road_address": {
"address_name": "대구 수성구 미술관로 40",
"building_name": "대구미술관",
"x": "128.674120391304",
"y": "35.827049088137"
}
}
→ 도로명주소 표기: 대구 수성구 미술관로 40
■ Step 2 — 반환된 좌표로 다시 좌표 → 주소 변환
요청 코드
curl -X GET "https://dapi.kakao.com/v2/local/geo/coord2address.json?input_coord=WGS84&x=128.674120391304&y=35.827049088137" \
-H "Authorization: KakaoAK {REST_API_KEY}"
반환 결과 (일부)
{ “road_address”: { “address_name”: “대구광역시 수성구 미술관로 40”, “building_name”: “대구미술관”, “main_building_no”: “40”, “zone_no”: “42250” } }
→ 도로명주소 표기: 대구광역시 수성구 미술관로 40
문의사항
- 두 API의 도로명 주소 표기법이 다르다면 기준이 있는지 안내 부탁드립니다.