[안내] 강원특별자치도 출범에 따른 지도/로컬 API 변경 안내 (6/12(월) 11:00 적용 완료)

지도/로컬 API
1

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

2023년 6월 11일 예정된 강원특별자치도 출범에 따른
지도/로컬 API 변경 안내 드립니다.

그럼 아래 내용을 확인하시고 지도/로컬 API 이용에 참고 부탁드립니다.

적용대상

변경사항

  • 지역명 “강원도” 가 “강원특별자치도” 로 변경됩니다.
  • 법정동 코드, 행정동 코드 등 지역코드의 앞자리가 “42” 에서 “51” 로 변경됩니다.

적용 일정

  • 2023년 6월 12일(월) 11:00 완료
    (* 당초 예정보다 내부 처리가 빠르게 진행되어 오전 적용 완료되었습니다.)

기타 참고

강원도 지역명 및 해당 지역 코드를 활용하고 계신 사용처에서는
적용 예정 시간대에 서비스 이용에 문제가 없도록 사전에 확인해주시길 부탁드립니다.

감사합니다.

3

@C.L 안녕하세요. 6월 12일 오후 이후에 geocode API 사용시
"강원도"를 제출할 수 없게 되는건지 또는 "강원도"를 "강원특별자치도"의 유의어로 처리하여 응답하는지 문의드립니다.

4

@ods07132
“강원도” 는 “강원특별자치도” 의 동의어로 처리될 예정입니다.

“제주특별자치도” 가 “제주도” 검색 시 반응하는 것과 같다고 보시면 됩니다.

6

@C.L 안녕하세요.

금일 강원특별자치도로 변경이 예정되어있는데 아직 언제 업데이트하실지 정확한 시간을 공지해주시지 않은 걸로 압니다.

그런데,

https://dapi.kakao.com/v2/local/geo/coord2address.json?x=127.313073490261&y=38.146565507037
api 응답값에 '강원특별자치도’로 응답됩니다.

또한,
기존의 응답 json 중 documents[0].address 의 'address_name’프로퍼티의 value로는 ‘서울’, ‘경기’, ‘인천’ 처럼 ~특별시, ~도의 상세한 정보는 응답하지 않았는데, 강원도에서 강원특별자치도로 업데이트되면서 , address.address_name프로퍼티의 value가 '강원특별자치도’로 응답됩니다.

응답값 포함해서 질문드립니다.

{
    "meta": {
        "total_count": 1
    },
    "documents": [
        {
            "road_address": {
                "address_name": "강원특별자치도 철원군 갈말읍 삼부연로 51",
                "region_1depth_name": "강원특별자치도",
                "region_2depth_name": "철원군",
                "region_3depth_name": "갈말읍",
                "road_name": "삼부연로",
                "underground_yn": "N",
                "main_building_no": "51",
                "sub_building_no": "",
                "building_name": "철원군청",
                "zone_no": "24040"
            },
            "address": {
                "address_name": "강원특별자치도 철원군 갈말읍 신철원리 649",
                "region_1depth_name": "강원특별자치도",
                "region_2depth_name": "철원군",
                "region_3depth_name": "갈말읍 신철원리",
                "mountain_yn": "N",
                "main_address_no": "649",
                "sub_address_no": "",
                "zip_code": ""
            }
        }
    ]
}
7

여러 시스템에 대한 배포가 순차적으로 이루어짐에 따라
특적 시각 기준으로 적용되는 것은 아닙니다.

현재 관련 작업들이 진행되고 있습니다.

응답값은,
기존에도 특별자치시, 특별자치도 등은 모두 포함하여 응답하고 있습니다.

{
  "meta": {
    "total_count": 1
  },
  "documents": [
    {
      "road_address": {
        "address_name": "세종특별자치시 한누리대로 2130",
        "region_1depth_name": "세종특별자치시",
        "region_2depth_name": "세종시",
        "region_3depth_name": "",
        "road_name": "한누리대로",
        "underground_yn": "N",
        "main_building_no": "2130",
        "sub_building_no": "",
        "building_name": "세종특별자치시청",
        "zone_no": "30151"
      },
      "address": {
        "address_name": "세종특별자치시 보람동 718",
        "region_1depth_name": "세종특별자치시",
        "region_2depth_name": "세종시",
        "region_3depth_name": "보람동",
        "mountain_yn": "N",
        "main_address_no": "718",
        "sub_address_no": "",
        "zip_code": ""
      }
    }
  ]

{
  "meta": {
    "total_count": 1
  },
  "documents": [
    {
      "road_address": {
        "address_name": "제주특별자치도 제주시 문연로 6",
        "region_1depth_name": "제주특별자치도",
        "region_2depth_name": "제주시",
        "region_3depth_name": "",
        "road_name": "문연로",
        "underground_yn": "N",
        "main_building_no": "6",
        "sub_building_no": "",
        "building_name": "제주특별자치도청",
        "zone_no": "63122"
      },
      "address": {
        "address_name": "제주특별자치도 제주시 연동 312-1",
        "region_1depth_name": "제주특별자치도",
        "region_2depth_name": "제주시",
        "region_3depth_name": "연동",
        "mountain_yn": "N",
        "main_address_no": "312",
        "sub_address_no": "1",
        "zip_code": ""
      }
    }
  ]
}
8

@C.L
답변 감사합니다.

서울같은 경우엔 '서울특별시’가 아닌 '서울’로 응답되기에 여쭈어보았습니다.

{
    "meta": {
        "total_count": 1
    },
    "documents": [
        {
            "road_address": null,
            "address": {
                "address_name": "서울 광진구 중곡동 316-1",
                "region_1depth_name": "서울",
                "region_2depth_name": "광진구",
                "region_3depth_name": "중곡동",
                "mountain_yn": "N",
                "main_address_no": "316",
                "sub_address_no": "1",
                "zip_code": ""
            }
        }
    ]
}

{
    "meta": {
        "total_count": 1
    },
    "documents": [
        {
            "road_address": {
                "address_name": "서울특별시 중랑구 면목로38길 3-5",
                "region_1depth_name": "서울",
                "region_2depth_name": "중랑구",
                "region_3depth_name": "",
                "road_name": "면목로38길",
                "underground_yn": "N",
                "main_building_no": "3",
                "sub_building_no": "5",
                "building_name": "청백오피스텔",
                "zone_no": "02252"
            },
            "address": {
                "address_name": "서울 중랑구 면목동 626-25",
                "region_1depth_name": "서울",
                "region_2depth_name": "중랑구",
                "region_3depth_name": "면목동",
                "mountain_yn": "N",
                "main_address_no": "626",
                "sub_address_no": "25",
                "zip_code": ""
            }
        }
    ]
}
9

특별자치시, 특별자치도가 아닌,
기존 특별시, 광역시 등은 축약 형태로 제공하고 있습니다.

1개의 좋아요
10

@ods07132 @yjs3819 @export @januarjune @seongeun82

안녕하세요,
관련 문의를 하신 이력이 있는 분들께 추가로 멘션 드립니다.

현재 변경 작업이 완료되었습니다.

감사합니다.

1개의 좋아요