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

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

地理编码

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

注意

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

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

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

使用案例

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

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

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

理解请求

该请求接受可选参数AdditionalFeatures，例如BiasPositionFilter、和，以优化搜索结果。其他选项（例如LanguageMaxResultsPoliticalView、和）可进一步自定义响应。必填参数是Query，它可以作为自由格式文本提供，也可以以结构化形式提供。QueryComponents有关更多信息，请参阅地理编码 API 参考。

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

身份验证

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

  • Key: 身份验证的可选参数。

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

查询和偏差

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

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

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

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

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

精炼结果

应用过滤器来优化结果。

  • Filter：筛选以包括特定的国家或地点类型。有关更多信息，请参阅 过滤。

国际化和本地化

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

  • Language: 结果所用语言。

  • PoliticalView: 采用反映领土主张的政治观点。

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

其他功能

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

  • AdditionalFeatures：可以选择请求其他详细信息，例如时区。有关更多信息，请参阅 其他功能。

了解回应

响应中提供的ResultItems，其中包含详细的位置数据Address，例如PlaceIdPosition、、和其他相关属性。还可能包括其他功能MatchScores，例如TimeZone信息或每个查询组件。每个都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%）的等级进行单独评分。这些分数表示地址的每个部分与结果匹配的准确程度。例如，如果AddressNumberStreet、和PostalCode分数接近 1.0，则即使由于其他查询详细信息导致总分较低，您也可以信任匹配项。

    注意

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

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

其他详细信息

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

  • AccessPoints：代表接入点的地理坐标。

  • TimeZone：该地点的时区信息。