本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
反向地理编码
反向地理编码是将地理坐标转换为人类可读的地址或地点。它提供详细的地址组成部分、地点类型、类别和街道信息,并提供基于地点类型的筛选选项来优化结果。该 API 还可包含其他功能,例如时区信息和政治观点调整。
注意
如果存储了结果,则将按更高的“存储”定价套餐进行计费。使用 IntendedUse 参数指定结果是供一次性使用还是用于存储。有关与存储结果相关的成本影响,请参阅地点定价。
有关更多信息,请参阅《Amazon Location Service API 参考》中的 ReverseGeocode。
有关此 API 的请求、响应、cURL 和 CLI 命令示例,请参阅如何使用反向地理编码。
使用案例
-
向客户位置数据添加补充数据:通过包括邮政编码、坐标以及利用永久存储来完善位置数据记录,从而支持做出明智的业务和营销决策。
-
位置数据标准化:在数据管道或批处理中应用地理编码来标准化位置数据,并利用永久存储进行持续参考。
-
确定时区:确定城市或地址所处的时区,以便为旅行、日程安排和开具发票等应用提供准确的时间戳。
了解请求
反向地理编码 API 请求接受必需参数与可选参数的组合以自定义结果。必需参数 QueryPosition(经度和纬度)指定要进行反向地理编码的坐标。可选参数包括用于获取额外数据的 AdditionalFeatures、用于优化结果的 Filter 以及用于限制返回结果数量的 MaxResults。其他选项(例如 Language、PoliticalView 和 IntendedUse)允许进一步自定义。有关更多详细信息,请参阅《反向地理编码 API 参考》。
该请求接受以下关键参数:
- 身份验证
-
如果使用其他身份验证方法,则
Key为可选参数。-
Key:用于身份验证的可选参数。
有关更多信息,请参阅 使用 Amazon Location Service 进行身份验证。
-
- 查询
-
用于定义地理位置和搜索半径的参数。
-
QueryPosition:指定反向地理编码请求的经度和纬度。 -
QueryRadius:定义围绕坐标的搜索半径。
有关更多信息,请参阅 查询和偏置。
-
- 优化结果
-
应用筛选条件,以将搜索结果限制为特定的国家/地区或地点类型。
-
Filter:根据国家/地区或地点类型筛选结果。
有关更多详细信息,请参阅 筛选。
-
- 国际化和本地化
-
用于自定义语言和对结果应用政治观点的选项。
-
Language:指定结果的语言。 -
PoliticalView:应用反映领土主张的政治观点。
有关更多信息,请参阅 本地化和国际化。
-
- 其他功能
-
索取额外数据,例如时区信息。
-
AdditionalFeatures:索取其他数据(例如时区详细信息)的选项。
有关更多信息,请参阅 其他功能。
-
了解响应
来自反向地理编码 API 的响应提供了有关指定坐标处位置的详细信息。ResultItems 数组包括地点对象列表,每个对象都包含地址详细信息、类别和地理位置。诸如 TimeZone、FoodTypes 和 PostalCodeDetails 之类的其他数据提供了进一步的上下文。该响应还包含用于绘图的边界框信息,以及与查询位置的距离。有关更多详细信息,请参阅《反向地理编码 API 参考》。
响应包含以下关键数据:
- 地址和相关详细信息
-
所返回位置的详细地址信息。
-
Address:完整地址信息,包括国家/地区、区域、邮政编码和街道详细信息。 -
PostalCodeDetails:与邮政编码相关的其他详细信息,例如分类和邮政当局。 -
StreetComponents:有关街道的其他详细信息,包括基本名称和类型。
-
- 地点类型和类别
-
描述所返回地点的类型和类别。
-
Categories:描述地点的类别,例如餐厅 或学校。 -
PlaceType:指定地点的类型,例如城市、地址或区域。
-
- 结果分析
-
有关每个结果与输入查询的匹配程度的信息。
-
MatchScores:表示每个结果与输入查询的匹配精度的分数。
-
- 其他详细信息
-
提供额外的位置相关数据。
-
TimeZone:该位置的时区信息。 -
AccessPoints:表示该位置入口点的地理坐标。
-