[공지] 품질 향상을 위한 '주소 검색 api' 업데이트 / [Upgrade Notice] Search address API for better search quality

[kakao]

안녕하세요. 지도/로컬 API 담당자 입니다.

검색 품질 향상을 위해 2021년 1월 25일자로 주소검색 API(/v2/local/search/address)가 업데이트 될 예정입니다.

적용 일정

• 2021년 1월 25일

변경 사항

• 변경 전: 입력한 주소 패턴과 유사한 검색 결과 제공, 검색어의 중의적인 표현 대응 미약
• 변경 후: 옵션 파라미터(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

• January 25, 2021

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