本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Autocomplete
<a name="autocomplete"></a>

 `Autocomplete`根据部分输入返回完整的地址和地址组成部分。主要用例包括地址表单自动填写和提前键入地址完成（在最终用户键入地址的同时以交互方式填写地址）。

**注意**  
默认情况下，仅返回每个结果的地点 ID、地点类型和标签属性。通过设置 input 属性可以获得更多更多详细信息，包括完整的地址细分和交互式用例的`AdditionalFeatures`输入亮点范围，但请注意，请求其他功能可能会产生影响 [地点定价](places-pricing.md) 

**注意**  
不支持日语地址。

结果始终是地址或地址组成部分，例如街道、邮政编码和国家。兴趣点永远不会被退回。结果不包括地理编码，因为结果侧重`Autocomplete`于地址补全，而不是地理编码。要获取地址地理编码坐标，请使用[地理编码操作](https://docs.aws.amazon.com/location/latest/developerguide/geocode.html)。结果可以按地理区域进行筛选。也可以按地点类型对其进行筛选，例如仅包含地区或仅包含邮政编码。

有关所有自动完成请求和响应属性的完整详情，请参阅《A *mazon Location Service API* 参考》中的 “[自动完成](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Autocomplete.html)”。

有关此 API 的请求、响应、cURL 和 CLI 命令示例，请参阅[如何使用自动补全](https://docs.aws.amazon.com/location/latest/developerguide/autocomplete-how-to.html)。

## 使用案例
<a name="autocomplete-use-cases"></a>
+  **增强结账体验：**当客户在电子商务结账体验以及网站或应用程序上的其他地址输入体验中输入地址时，提供实时地址填写功能。确保配送或提货地点与已知地址相匹配，从而减少代价高昂的错误并提高客户满意度。
+  Su@@ **pport customer services：**向联络中心和紧急服务调度等领域的客户服务代表提供实时地址建议，简化收集准确地址信息的流程，并通过缩短获取正确地址信息所需的时间来提高用户满意度。

## 了解请求
<a name="autocomplete-request-parameters"></a>

该`Autocomplete`操作支持许多可选的请求属性，以优化搜索结果。有关请求属性的完整列表，请参阅《A *mazon Location Service API 参考*》中的 “[自动完成](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Autocomplete.html)”。

该请求接受以下关键参数：

 **身份验证**   
自动完成 API 操作支持两种替代身份验证模式。您可以通过使用 [Sigv4 签名对请求进行签名或提供 [API](https://docs.aws.amazon.com/location/latest/developerguide/access.html) 密](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)钥来进行身份验证。  
+  如果您使用特定语言的 AWS 开发工具包或 AWS CLI 发出请求，则默认情况下，您的请求通常会使用 Sigv4 进行签名。
+  在某些用例中，例如从 Web 浏览器发出请求或使用其他非 AWS SDK 客户端，API 密钥是一种更合适的身份验证形式。使用可选的密钥请求属性提供用于进行身份验证的 API 密钥。`Autocomplete`
有关更多信息，请参阅[使用 Amazon Location Service 进行身份验证](access.md)《*亚马逊定位服务 API 参考*》。

 **指定要查询的地址**   
+  使用必填的 re `QueryText` quest 属性提供要查询的自由格式文本。
+  `BiasPosition`：使用可选的 re `BiasPosition` quest 属性以`[longitude, latitude]`坐标对的形式提供引脚位置，以提高返回结果的相关性。
有关更多信息，请参阅[查询和偏置](places-querying-biasing.md)《*亚马逊定位服务 API 参考*》。

 **包括所有响应属性**   
将可选字段设置 AdditionalFeatures 为值 ["Core"]，以在响应中包含所有可用的结果属性，包括完整的地址细分和交互式突出显示位置。请注意，请求这些额外属性可能会影响[定价](https://aws.amazon.com/location/pricing/) 

 **优化结果**   
使用 “筛选” 属性根据特定国家/地区、地点类型或地理区域筛选返回的结果。有关更多详情，请参阅《*Amazon L [筛选](places-filtering.md) ocation Service 开发者指南》*。

## 了解响应
<a name="autocomplete-response-details"></a>

response 对象包含一个名为的数组属性`ResultItems`，该属性包含按相关性升序排列的结果列表。有关结果商品属性的完整列表，请参阅《A *mazon 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"]`。