反向地理编码 - Amazon Location Service

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

反向地理编码

反向地理编码是将地理坐标转换为人类可读的地址或地点。它提供详细的地址组成部分、地点类型、类别和街道信息,并提供基于地点类型的筛选选项来优化结果。该 API 还可包含其他功能,例如时区信息和政治观点调整。

注意

如果存储了结果,则将按更高的“存储”定价套餐进行计费。使用 IntendedUse 参数指定结果是供一次性使用还是用于存储。有关与存储结果相关的成本影响,请参阅地点定价

有关更多信息,请参阅《Amazon Location Service API 参考》中的 ReverseGeocode

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

使用案例

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

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

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

了解请求

反向地理编码 API 请求接受必需参数与可选参数的组合以自定义结果。必需参数 QueryPosition(经度和纬度)指定要进行反向地理编码的坐标。可选参数包括用于获取额外数据的 AdditionalFeatures、用于优化结果的 Filter 以及用于限制返回结果数量的 MaxResults。其他选项(例如 LanguagePoliticalViewIntendedUse)允许进一步自定义。有关更多详细信息,请参阅《反向地理编码 API 参考》。

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

身份验证

如果使用其他身份验证方法,则 Key 为可选参数。

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

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

查询

用于定义地理位置和搜索半径的参数。

  • QueryPosition:指定反向地理编码请求的经度和纬度。

  • QueryRadius:定义围绕坐标的搜索半径。

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

优化结果

应用筛选条件,以将搜索结果限制为特定的国家/地区或地点类型。

  • Filter:根据国家/地区或地点类型筛选结果。

有关更多详细信息,请参阅 筛选

国际化和本地化

用于自定义语言和对结果应用政治观点的选项。

  • Language:指定结果的语言。

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

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

其他功能

索取额外数据,例如时区信息。

  • AdditionalFeatures:索取其他数据(例如时区详细信息)的选项。

有关更多信息,请参阅 其他功能

了解响应

来自反向地理编码 API 的响应提供了有关指定坐标处位置的详细信息。ResultItems 数组包括地点对象列表,每个对象都包含地址详细信息、类别和地理位置。诸如 TimeZoneFoodTypesPostalCodeDetails 之类的其他数据提供了进一步的上下文。该响应还包含用于绘图的边界框信息,以及与查询位置的距离。有关更多详细信息,请参阅《反向地理编码 API 参考》。

响应包含以下关键数据:

地址和相关详细信息

所返回位置的详细地址信息。

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

  • PostalCodeDetails:与邮政编码相关的其他详细信息,例如分类和邮政当局。

  • StreetComponents:有关街道的其他详细信息,包括基本名称和类型。

地点类型和类别

描述所返回地点的类型和类别。

  • Categories:描述地点的类别,例如餐厅学校

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

结果分析

有关每个结果与输入查询的匹配程度的信息。

  • MatchScores:表示每个结果与输入查询的匹配精度的分数。

其他详细信息

提供额外的位置相关数据。

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

  • AccessPoints:表示该位置入口点的地理坐标。