kakao
1
안녕하세요. 지도/로컬 API 담당자 입니다.
검색 품질 향상을 위해 2021년 1월 25일자로 주소검색 API(/v2/local/search/address)가 업데이트 될 예정입니다.
적용 일정
변경 사항
- 변경 전: 입력한 주소 패턴과 유사한 검색 결과 제공, 검색어의 중의적인 표현 대응 미약
- 변경 후: 옵션 파라미터(
analyze_type
)가 추가되어 검색 결과 제공 방식 선택 가능 (exact
또는 similar
), 검색어의 중의적인 표현에 대응한 개선된 검색 결과 제공
analyze_type
similar (기본 설정값) |
exact |
보다 폭넓은 검색 결과를 제공하기 위해 입력한 건물명과 일부만 매칭될 경우에도 확장된 검색 결과를 함께 제공 |
주소의 정확한 건물명이 입력된 주소패턴일 경우에 한해, 입력한 건물명과 정확히 일치하는 검색 결과 제공 |
|
|
API 변경 예시
예시 query |
변경 전 |
변경 후 analyze_type: similar (기본 설정값) |
변경 후 analyze_type: exact |
특징 |
유사 주소 형태도 검색됨 |
주소 유사건물명 검색됨 |
정확한 주소만 검색됨 |
역삼동 63길 |
서울 강남구 논현로 63길 서울 강남구 선릉로 63길 서울 강남구 언주로 63길 … 서울 강남구 학동로 63길 |
서울 강남구 논현로 63길 서울 강남구 선릉로 63길 서울 강남구 언주로 63길 |
좌동 |
서울 대학로 |
경기 시흥시 서울대학로 경기 시흥시 서울대학로 264번길 경기 시흥시 서울대학로 278번길 |
서울 종로구 대학로 서울 종로구 대학로 1길 … 서울 종로구 대학로 14길 경기 시흥시 서울대학로 경기 시흥시 서울대학로 264번길 경기 시흥시 서울대학로 278번길 |
좌동 |
인천광역시 남동구 앵고개로934번길 13 102호 |
결과없음 |
인천 남동구 앵고개로 934번길 13 |
좌동 |
경북 구미시 옥계동 794-1 아파트 홍춘천닭갈비 |
경북 구미시 옥계동 794-1 |
좌동 |
결과 없음 |
부산 기장군 정관읍 용수리 1387 동일 106동 1405호 |
부산 기장군 용수리 1387 |
좌동 |
결과 없음 |
부산 기장군 정관읍 용수리 1387 정관동일스위트1차 106동 1405호 |
부산 기장군 용수리 1387 |
좌동 |
좌동 |
판교역로 235 에이치스퀘어 |
경기 성남시 분당구 판교역로 235 |
좌동 |
검색결과없음 |
판교역로 235 에이치스퀘어 엔동 |
경기 성남시 분당구 판교역로 235 |
좌동 |
좌동 |
조치 사항
- 기존 주소 검색 API를 이용하는 경우, 별도의 변경 사항 없이 기존 API 이용이 가능하며 기본값으로
similar
옵션이 자동으로 적용됩니다.
- 개선된 정확한 주소패턴 결과의 주소 검색 API의 기능을 이용하려면,
analyze_type
를 exact
로 추가 설정하여 요청합니다.
관련 문의 사항은 지도/로컬 API 포럼을 통해 질문남겨주시기 바랍니다.
감사합니다.
====
Hello. We are Map/Local API team!
As of January 25, 2021, the Search address API will be updated to improve search quality.
Effective Date
Changes
- Before update: Only the search results exactly matched with the entered address pattern are provided. Hard to respond to ambiguous search query.
- After update: As an optional parameter(
analyze_type
) is added, you can choose between exact
or similar
for the type of search results. The improved search results are provided for the ambiguous search query.
analyze_type
similar (Default value) |
exact |
The search results similar to the entered address pattern are also provided for a wide range of search results. |
If the exact building name is used as a search query, the search results exactly matched with the entered address pattern are provided. |
Actions
- To use the existing API: Additional action is not required because
similar
is automatically applied.
- To use the upgraded version of API for precise results: Set
analyze_type
to exact
in the request.
If you have any questions about the update, contact us through the Map/Local API forum.
Thank you.
Kakao Map/Local
2개의 좋아요