기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Autocomplete
`Autocomplete`는 부분 입력을 기반으로 전체 주소와 주소 구성 요소를 반환합니다. 주요 사용 사례에는 주소 양식 자동 채우기 및 미리 주소 입력 완료(최종 사용자가 주소를 입력하는 동안 대화형으로 주소 작성)가 포함됩니다.
**참고**
기본적으로 각 결과에 대해 장소 ID, 장소 유형 및 레이블 속성만 반환됩니다. 입력 `AdditionalFeatures` 속성을 설정하여 대화형 사용 사례에 대한 전체 주소 분석 및 입력 강조 표시 범위를 포함하여 풍부한 추가 세부 정보를 얻을 수 있지만 추가 기능을 요청하면 영향을 미칠 수 있습니다. [Places 요금](places-pricing.md)
**참고**
일본어 주소는 지원되지 않습니다.
결과는 항상 주소이거나 거리, 우편 번호 및 국가와 같은 주소 구성 요소입니다. 관심 지점은 반환되지 않습니다. 는 지오코딩이 아닌 주소 완성에 중점을 두기 때문에 결과에는 지오코드`Autocomplete`가 포함되지 않습니다. 주소 지오코드 좌표를 가져오려면 [지오코드](https://docs.aws.amazon.com/location/latest/developerguide/geocode.html) 작업을 사용합니다. 결과는 지리적 영역별로 필터링할 수 있습니다. 로캘만 포함하거나 우편 번호만 포함하도록 장소 유형별로 필터링할 수도 있습니다.
모든 자동 완성 요청 및 응답 속성에 대한 자세한 내용은 *Amazon Location Service API* 참조의 [자동 완성](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Autocomplete.html)을 참조하세요.
이 API에 대한 요청, 응답, cURL 및 CLI 명령의 예는 [Autocomplete 사용 방법](https://docs.aws.amazon.com/location/latest/developerguide/autocomplete-how-to.html)을 참조하세요.
## 사용 사례
+ **체크아웃 경험 향상:** 고객이 전자 상거래 체크아웃 경험 및 웹 사이트 또는 앱의 기타 주소 입력 경험에 주소를 입력할 때 실시간 주소 완성을 제공합니다. 배달 또는 픽업 위치가 알려진 주소와 일치하는지 확인하여 비용이 많이 드는 오류를 줄이고 고객 만족도를 높입니다.
+ **고객 서비스 지원:** 고객 센터 및 긴급 서비스 발송과 같은 분야의 고객 서비스 담당자에게 실시간 주소 제안을 제공하여 정확한 주소 정보를 수집하는 프로세스를 간소화하고 올바른 주소 정보를 얻는 데 필요한 시간을 줄여 사용자 만족도를 높입니다.
## 요청 이해
`Autocomplete` 작업은 여러 선택적 요청 속성을 지원하여 검색 결과를 구체화합니다. 요청 속성의 전체 목록은 *Amazon Location Service API* 참조의 [자동 완성](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Autocomplete.html)을 참조하세요.
요청은 다음 주요 파라미터를 수용합니다.
**Authentication**
자동 완성 API 작업은 두 가지 대체 인증 모드를 지원합니다. [SigV4 서명](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)으로 요청에 서명하거나 [API 키를](https://docs.aws.amazon.com/location/latest/developerguide/access.html) 제공하여 인증할 수 있습니다.
+ 언어별 AWS SDK 또는 AWS CLI를 사용하여 요청하는 경우 일반적으로 요청은 SigV4로 서명됩니다.
+ 예를 들어 웹 브라우저에서 요청하거나 AWS가 아닌 다른 SDK 클라이언트를 사용하는 경우 API 키가 더 적절한 인증 형식입니다. 선택적 키 요청 속성을 사용하여에 인증하기 위한 API 키를 제공합니다`Autocomplete`.
자세한 내용은 *Amazon Location Service API 참조의 섹션을 참조*[Amazon Location Service로 인증](access.md)하세요.
**쿼리할 주소 지정**
+ 필수 `QueryText` 요청 속성을 사용하여 쿼리할 자유 형식 텍스트를 제공합니다.
+ `BiasPosition`: 선택적 `BiasPosition` 요청 속성을 사용하여 `[longitude, latitude]` 좌표 페어로 핀 위치를 제공하여 반환된 결과의 관련성을 개선합니다.
자세한 내용은 *Amazon Location Service API 참조의 섹션을 참조*[쿼리 및 편향](places-querying-biasing.md)하세요.
**모든 응답 속성 포함**
전체 주소 분류 및 대화형 강조 표시 위치를 포함하여 응답에 사용 가능한 모든 결과 속성을 포함하려면 선택적 필드인 AdditionalFeatures를 ["Core"] 값으로 설정합니다. 이러한 추가 속성을 요청하면 [요금](https://aws.amazon.com/location/pricing/)에 영향을 미칠 수 있습니다.
**결과 구체화**
필터 속성을 사용하여 특정 국가, 장소 유형 또는 지리적 영역을 기준으로 반환된 결과를 필터링합니다. 자세한 내용은 *Amazon Location Service 개발자 안내서*[필터링](places-filtering.md)의 섹션을 참조하세요.
## 응답 이해
응답 객체에는 관련성 오름차순으로 순위`ResultItems`가 매겨진 결과 목록을 포함하는 라는 배열 속성이 포함되어 있습니다. 결과 항목 속성의 전체 목록은 *Amazon Location Service API* 참조의 [자동 완성](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Autocomplete.html)을 참조하세요.
다음은 더 중요한 결과 항목 속성 중 일부의 간략한 목록입니다.
**주소 및 관련 세부 정보**
+ `PlaceType` 에는 주소에서 포인트 주소, 거리 등을 나타내는지 여부를 알려주는 결과의 장소 유형이 포함되어 있습니다. 에서 반환한 결과에`Autocomplete`는 항상 전체 주소 또는 도로명이나 우편 번호와 같은 주소 구성 요소를 나타내는 장소 유형이 있습니다. 결과에는 관심 지점이 포함되지 않습니다.
+ `Address` 에는 결과 레이블`["Core"]`이 포함되어 있으며,에가 지정된 경우 집 번호`AdditionalFeatures`, 도로명, 우편 번호, 국가 등을 포함한 구조화된 필드로 주소를 전체적으로 분류한 내용도 포함되어 있습니다.
**결과 분석**
입력 쿼리와 관련하여 각 결과에 대한 분석 데이터를 제공합니다.
+ `Distance`: 요청에이 `BiasPosition` 제공된 경우 각 결과 항목에는에서 나온 결과의 거리를 미터 단위로 나타내는 `Distance` 속성이 포함됩니다`BiasPosition`. `AdditionalFeatures`를 `["Core"]`로 설정해야 합니다.
+ `Highlights`는 입력의 단어, 문구 및 하위 문자열이 결과 속성에 정확히 `QueryText` 표시되는 위치를 표시하므로 애플리케이션이 사용자에게 일치하는 항목을 강조 표시하는 유용한 사용자 경험을 제공할 수 있습니다. `AdditionalFeatures`를 `["Core"]`로 설정해야 합니다.