地理编码 - Amazon Location Service
使用案例了解请求了解响应

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

地理编码

地理编码可将文本地址或地名转换为地理坐标，同时还会附带详细的地址组成部分和其他信息。此 API 支持灵活查询，包括自由格式文本查询以及带有街道名称、邮政编码和区域的结构化查询。可选功能包括时区数据和政治观点调整。

注意

存储的结果会产生更高的存储费用。使用 IntendedUse 参数指示是一次性使用还是存储。要了解存储结果的成本影响，请参阅地点定价。

有关更多信息，请参阅《Amazon Location Service API 参考》中的地理编码。

有关此 API 的请求、响应、cURL 和 CLI 命令示例，请参阅如何使用地理编码。

使用案例

  • 向客户地址添加补充数据：通过包括邮政编码、坐标以及利用永久存储来完善地址记录，从而支持做出明智的业务和营销决策。

  • 地址数据标准化：在数据管道或批处理中应用地理编码来标准化地址数据，并利用永久存储进行持续参考。

  • 确定时区：确定城市或地址所处的时区，以便为旅行、日程安排和开具发票等应用提供准确的时间戳。

了解请求

该请求接受可选参数（例如 AdditionalFeatures、BiasPosition 和 Filter）以优化搜索结果。其他选项（例如 Language、MaxResults 和 PoliticalView）可进一步对响应进行自定义。所需参数为 Query，它可以作为自由格式文本提供，也可以作为 QueryComponents 进行结构化处理。有关更多信息，请参阅《地理编码 API 参考》。

该请求包括以下关键参数：

身份验证

对于身份验证，如果正在使用其他方法，则 Key 为可选参数。

  • Key：用于身份验证的可选参数。

有关更多信息，请参阅 使用 Amazon Location Service 进行身份验证。

查询和偏置

用于查询结果和对结果进行地理偏置的参数。

  • QueryText：用于搜索位置的自由格式文本查询。

  • QueryComponents：用于精确搜索的结构化组件（例如地址号、国家、地区或邮政编码等）。

  • BiasPosition：搜索结果偏向的地理位置。

有关更多信息，请参阅 查询和偏置。

优化结果

应用筛选条件来优化结果。

  • Filter：用于包括特定国家/地区或地点类型的筛选条件。有关更多信息，请参阅 筛选。

国际化和本地化

为本地化结果指定语言并应用政治观点。

  • Language：结果所采用的语言。

  • PoliticalView：应用反映领土主张的政治观点。

有关更多信息，请参阅 本地化和国际化。

其他 功能

索取其他信息，例如时区详细信息。

  • AdditionalFeatures：索取其他详细信息（例如时区）的选项。有关更多信息，请参阅 其他功能。

了解响应

该响应提供 ResultItems，其中包含详细的位置数据（例如 Address、PlaceId、Position）和其他相关属性。此外，还可能包含诸如 TimeZone 信息或每个查询组件的 MatchScores 等其他功能。每个 ResultItem 都表示基于指定请求参数的匹配位置或地理编码结果。有关更多详细信息，请参阅《地理编码 API 参考》。

该响应包括以下关键参数：

地址和相关详细信息

有关返回的位置的详细信息，包括地址组成部分。

  • Address：完整地址，包括国家/地区、区域、邮政编码和街道详细信息。

  • PostalCodeDetails：与邮政编码相关的其他信息。

  • StreetComponents：街道详细信息，包括基本名称和类型。

地点类型和类别

有关所返回地点的类型和类别的信息。

  • Categories：描述地点的类别列表，例如餐厅、学校。

  • PlaceType：指定地点的类型，例如城市、地址或区域。

结果分析

表示结果与输入查询匹配程度的分数。

  • MatchScores：表示匹配精度的分数。

    • Overall：衡量地址搜索与输入内容的匹配程度，范围从 0.0 到 1.0（0% 到 100%）。满分为 1.0，表示搜索的每个部分都已在数据库中找到。在包括联系人姓名或送货说明等额外详细信息时，出现较低分数是正常的。这些自然会使分数降低，但不一定意味着地址有误。

    • Component Score：每个地址组成部分（例如 AddressNumber 或 PostalCode）都按照 0.0 到 1.0（0% 到 100%）的范围进行单独评分。这些分数表示地址的每个部分与结果匹配的准确程度。例如，如果 AddressNumber、Street 和 PostalCode 分数接近 1.0，则即使由于其他查询详细信息导致总分较低，您也可以信任匹配项。

    注意

    如果没有显示特定组成部分（例如 Street）的分数，则该组成部分计为 0。这有助于识别地址中可能需要验证的部分。

    处理通常包含额外信息的现实世界地址搜索时，这种评分系统有助于在精确匹配和实际可用性之间取得平衡。

其他详细信息

根据需要包含与位置相关的额外信息。

  • AccessPoints：代表出入口的地理坐标。

  • TimeZone：该位置的时区信息。