本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
自动完成
当用户键入时,自动补全 API 会根据部分输入完成潜在的地点和地址。它通过在几次击键后使用有效的地址信息完成查询,从而提高了地址输入的效率和准确性。此外,自动完成功能支持基于地理位置、国家/地区或特定地点类型的结果筛选,并且可以使用语言和政治观点等可选参数进行定制。
注意
默认情况下,“自动完成” 仅返回ID和Title字段,这提供了一种经济实惠的选项。通过将设置为additionalFeatures,可以请求其他地址组成部分和亮点Core。地点定价有关与存储结果相关的费用详情,请参阅。请注意,自动完成功能不会返回地理编码,而且此功能目前在日本不可用。
有关更多信息,请参阅《A mazon Location Service API 参考》中的 “自动完成”。
有关此 API 的请求、响应、curl 和 CLI 命令示例,请参阅如何使用自动完成。
使用案例
-
增强结账体验:当客户在网站或应用程序上输入位置时,提供实时地址填写功能。确保配送或取件地点与已知地址相匹配,以简化地址验证、减少错误并营造无缝的结账体验。
-
Su@@ pport customer services:为客户服务(例如联络中心或紧急服务)提供实时地址建议,简化定位准确地址的流程,并通过缩短获取正确地址信息所需的时间来提高用户满意度。
理解请求
自动完成请求使用可选参数来优化搜索结果。如需了解更多详情,请参阅自动补全 API 参考。
该请求接受以下关键参数:
- 身份验证
-
如果使用其他身份验证方法,则该
Key参数是可选的。-
Key: 身份验证的可选参数。
有关更多信息,请参阅 使用亚马逊 Location Service 进行身份验证。
-
- 查询
-
定义结果建议的部分文本查询和地理偏差。
-
QueryText:用于查找位置结果的自由格式文本查询,此参数是必需的。 -
BiasPosition:建议最接近指定经度和纬度坐标的结果,此参数是可选的。
有关更多信息,请参阅 查询和偏差。
-
- 优化结果
-
应用筛选条件将搜索结果限制为特定国家/地区或地点类型。
-
Filter:允许根据指定的国家或地点类型进行筛选。
有关更多详细信息,请参阅 过滤
-
了解回应
Autocomplete API 返回的结果为ResultItems,每个结果都表示基于请求参数的匹配位置。如需了解更多详情,请参阅自动补全 API 参考。
响应包含以下关键数据:
- 地址和相关详情
-
包含每个位置的详细地址组成部分。
-
Address:提供完整的地址组件,包括街道、邮政编码和国家。
-
- 结果分析
-
为与输入查询相关的每个结果提供分析数据。
-
Distance:从指定偏置位置到结果的距离。 -
Highlights:为清楚起见,在结果中突出显示查询的各个部分。
-