Autocomplete - Amazon Location Service
사용 사례요청 이해응답 이해

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Autocomplete

Autocomplete는 부분 입력을 기반으로 전체 주소와 주소 구성 요소를 반환합니다. 주요 사용 사례에는 주소 양식 자동 채우기 및 미리 주소 입력 완료(최종 사용자가 주소를 입력하는 동안 대화형으로 주소 작성)가 포함됩니다.

참고

기본적으로 각 결과에 대해 장소 ID, 장소 유형 및 레이블 속성만 반환됩니다. 입력 AdditionalFeatures 속성을 설정하여 대화형 사용 사례에 대한 전체 주소 분석 및 입력 강조 표시 범위를 포함하여 풍부한 추가 세부 정보를 얻을 수 있지만 추가 기능을 요청하면 영향을 미칠 수 있습니다. Places 요금

참고

일본어 주소는 지원되지 않습니다.

결과는 항상 주소이거나 거리, 우편 번호 및 국가와 같은 주소 구성 요소입니다. 관심 지점은 반환되지 않습니다. 는 지오코딩이 아닌 주소 완성에 중점을 두기 때문에 결과에는 지오코드Autocomplete가 포함되지 않습니다. 주소 지오코드 좌표를 가져오려면 지오코드 작업을 사용합니다. 결과는 지리적 영역별로 필터링할 수 있습니다. 로캘만 포함하거나 우편 번호만 포함하도록 장소 유형별로 필터링할 수도 있습니다.

모든 자동 완성 요청 및 응답 속성에 대한 자세한 내용은 Amazon Location Service API 참조의 자동 완성을 참조하세요.

이 API에 대한 요청, 응답, cURL 및 CLI 명령의 예는 Autocomplete 사용 방법을 참조하세요.

사용 사례

  • 체크아웃 경험 향상: 고객이 전자 상거래 체크아웃 경험 및 웹 사이트 또는 앱의 기타 주소 입력 경험에 주소를 입력할 때 실시간 주소 완성을 제공합니다. 배달 또는 픽업 위치가 알려진 주소와 일치하는지 확인하여 비용이 많이 드는 오류를 줄이고 고객 만족도를 높입니다.

  • 고객 서비스 지원: 고객 센터 및 긴급 서비스 발송과 같은 분야의 고객 서비스 담당자에게 실시간 주소 제안을 제공하여 정확한 주소 정보를 수집하는 프로세스를 간소화하고 올바른 주소 정보를 얻는 데 필요한 시간을 줄여 사용자 만족도를 높입니다.

요청 이해

Autocomplete 작업은 여러 선택적 요청 속성을 지원하여 검색 결과를 구체화합니다. 요청 속성의 전체 목록은 Amazon Location Service API 참조의 자동 완성을 참조하세요.

요청은 다음 주요 파라미터를 수용합니다.

Authentication

자동 완성 API 작업은 두 가지 대체 인증 모드를 지원합니다. SigV4 서명으로 요청에 서명하거나 API 키를 제공하여 인증할 수 있습니다.

  • 언어별 AWS SDK 또는 AWS CLI를 사용하여 요청하는 경우 일반적으로 요청은 SigV4로 서명됩니다.

  • 예를 들어 웹 브라우저에서 요청하거나 AWS가 아닌 다른 SDK 클라이언트를 사용하는 경우 API 키가 더 적절한 인증 형식입니다. 선택적 키 요청 속성을 사용하여에 인증하기 위한 API 키를 제공합니다Autocomplete.

자세한 내용은 Amazon Location Service API 참조의 섹션을 참조Amazon Location Service로 인증하세요.

쿼리할 주소 지정

  • 필수 QueryText 요청 속성을 사용하여 쿼리할 자유 형식 텍스트를 제공합니다.

  • BiasPosition: 선택적 BiasPosition 요청 속성을 사용하여 [longitude, latitude] 좌표 페어로 핀 위치를 제공하여 반환된 결과의 관련성을 개선합니다.

자세한 내용은 Amazon Location Service API 참조의 섹션을 참조쿼리 및 편향하세요.

모든 응답 속성 포함

전체 주소 분류 및 대화형 강조 표시 위치를 포함하여 응답에 사용 가능한 모든 결과 속성을 포함하려면 선택적 필드인 AdditionalFeatures를 ["Core"] 값으로 설정합니다. 이러한 추가 속성을 요청하면 요금에 영향을 미칠 수 있습니다.

결과 구체화

필터 속성을 사용하여 특정 국가, 장소 유형 또는 지리적 영역을 기준으로 반환된 결과를 필터링합니다. 자세한 내용은 Amazon Location Service 개발자 안내서필터링의 섹션을 참조하세요.

응답 이해

응답 객체에는 관련성 오름차순으로 순위ResultItems가 매겨진 결과 목록을 포함하는 라는 배열 속성이 포함되어 있습니다. 결과 항목 속성의 전체 목록은 Amazon Location Service API 참조의 자동 완성을 참조하세요.

다음은 더 중요한 결과 항목 속성 중 일부의 간략한 목록입니다.

주소 및 관련 세부 정보

  • PlaceType 에는 주소에서 포인트 주소, 거리 등을 나타내는지 여부를 알려주는 결과의 장소 유형이 포함되어 있습니다. 에서 반환한 결과에Autocomplete는 항상 전체 주소 또는 도로명이나 우편 번호와 같은 주소 구성 요소를 나타내는 장소 유형이 있습니다. 결과에는 관심 지점이 포함되지 않습니다.

  • Address 에는 결과 레이블["Core"]이 포함되어 있으며,에가 지정된 경우 집 번호AdditionalFeatures, 도로명, 우편 번호, 국가 등을 포함한 구조화된 필드로 주소를 전체적으로 분류한 내용도 포함되어 있습니다.

결과 분석

입력 쿼리와 관련하여 각 결과에 대한 분석 데이터를 제공합니다.

  • Distance: 요청에이 BiasPosition 제공된 경우 각 결과 항목에는에서 나온 결과의 거리를 미터 단위로 나타내는 Distance 속성이 포함됩니다BiasPosition. AdditionalFeatures를 ["Core"]로 설정해야 합니다.

  • Highlights는 입력의 단어, 문구 및 하위 문자열이 결과 속성에 정확히 QueryText 표시되는 위치를 표시하므로 애플리케이션이 사용자에게 일치하는 항목을 강조 표시하는 유용한 사용자 경험을 제공할 수 있습니다. AdditionalFeatures를 ["Core"]로 설정해야 합니다.