자동 완성 - Amazon Location Service

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

자동 완성

자동 완성 API는 부분 입력을 기반으로 사용자 유형으로 잠재적 위치와 주소를 완료합니다. 몇 번의 키 입력 후 유효한 주소 정보로 쿼리를 완료하여 주소 입력의 효율성과 정확도를 높입니다. 또한 Autocomplete는 지리적 위치, 국가 또는 특정 장소 유형을 기반으로 결과 필터링을 지원하며 언어 및 정치적 관점과 같은 선택적 파라미터를 사용하여 조정할 수 있습니다.

참고

기본적으로 자동 완성은 IDTitle 필드만 반환하여 비용 효율적인 옵션을 제공합니다. 를 로 설정하여 추가 주소 구성 요소 및 하이라이트additionalFeatures를 요청할 수 있습니다Core. 저장된 결과와 관련된 비용 세부 정보는 섹션을 참조장소 요금하세요. Autocomplete는 지오코드를 반환하지 않으며 현재 일본에서는이 기능을 사용할 수 없습니다.

자세한 내용은 Amazon Location Service API 참조의 자동 완성을 참조하세요.

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

사용 사례

  • 체크아웃 경험 향상: 고객이 웹 사이트 또는 앱에서 자신의 위치에 들어갈 때 실시간 주소 완성을 제공합니다. 배달 또는 픽업 위치가 알려진 주소와 일치하는지 확인하여 주소 검증을 간소화하고 오류를 줄이며 원활한 체크아웃 환경을 만듭니다.

  • 고객 서비스 지원: 고객 센터 또는 긴급 서비스와 같은 고객 서비스에 대한 실시간 주소 제안을 제공하여 정확한 주소를 찾는 프로세스를 간소화하고 올바른 주소 정보를 얻는 데 필요한 시간을 줄여 사용자 만족도를 높입니다.

요청 이해

자동 완성 요청은 선택적 파라미터를 사용하여 검색 결과를 구체화합니다. 자세한 내용은 자동 완성 API 참조를 참조하세요.

요청은 다음 키 파라미터를 수락합니다.

인증

다른 인증 방법을 사용하는 경우 Key 파라미터는 선택 사항입니다.

  • Key: 인증을 위한 선택적 파라미터입니다.

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

쿼리

결과 제안에 대한 부분 텍스트 쿼리와 지리적 편향을 정의합니다.

  • QueryText: 위치 결과를 찾는 데 사용되는 자유 형식 텍스트 쿼리로,이 파라미터는 필수입니다.

  • BiasPosition: 지정된 경도 및 위도 좌표에 가장 가까운 결과를 제안하며,이 파라미터는 선택 사항입니다.

자세한 내용은 쿼리 및 편향 섹션을 참조하세요.

결과 구체화

필터를 적용하여 결과를 특정 국가 또는 장소 유형으로 제한합니다.

  • Filter: 지정된 국가 또는 장소 유형을 기반으로 필터링할 수 있습니다.

자세한 내용은 필터링 섹션을 참조하세요.

응답 이해

자동 완성 API는 결과를 로 반환하며ResultItems, 각 결과는 요청 파라미터를 기반으로 일치하는 위치를 나타냅니다. 자세한 내용은 자동 완성 API 참조를 참조하세요.

응답에는 다음 키 데이터가 포함됩니다.

주소 및 관련 세부 정보

각 위치에 대한 자세한 주소 구성 요소를 포함합니다.

  • Address: 도로명, 우편 번호 및 국가를 포함한 전체 주소 구성 요소를 제공합니다.

결과 분석

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

  • Distance: 지정된 바이어스 위치에서 결과까지의 거리입니다.

  • Highlights: 명확성을 위해 결과 내에서 쿼리의 일부를 강조 표시합니다.