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

# 反向地理编码
<a name="reverse-geocode"></a>

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

**注意**  
如果存储了结果，则将按更高的“存储”定价套餐进行计费。使用 `IntendedUse` 参数指定结果是供一次性使用还是用于存储。有关与存储结果相关的成本影响，请参阅[地点定价](places-pricing.md)。

有关更多信息，请参阅[ReverseGeocode](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_ReverseGeocode.html)《*亚马逊定位服务 API 参考*》。

有关此 API 的请求、响应、cURL 和 CLI 命令示例，请参阅[如何使用反向地理编码](https://docs.aws.amazon.com/location/latest/developerguide/reverse-geocode-how-to.html)。

## 使用案例
<a name="reverse-geocode-use-cases"></a>
+ **向客户位置数据添加补充数据：**通过包括邮政编码、坐标以及利用永久存储来完善位置数据记录，从而支持做出明智的业务和营销决策。
+ **位置数据标准化：**在数据管道或批处理中应用地理编码来标准化位置数据，并利用永久存储进行持续参考。
+ **确定时区：**确定城市或地址所处的时区，以便为旅行、日程安排和开具发票等应用提供准确的时间戳。

## 了解请求
<a name="reverse-geocode-request-parameters"></a>

**注意**  
 对于`ap-southeast-1`和中的客户`ap-southeast-5`，支持的请求和响应字段可能有所不同。有关详细信息，请参阅 [ReverseGeocode API 参考](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_ReverseGeocode.html)。

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

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

**身份验证**  
如果使用其他身份验证方法，则 `Key` 为可选参数。  
+ `Key`：用于身份验证的可选参数。
有关更多信息，请参阅 [使用 Amazon Location Service 进行身份验证](access.md)。

**查询**  
用于定义地理位置和搜索半径的参数。  
+ `QueryPosition`：指定反向地理编码请求的经度和纬度。
+ `QueryRadius`：定义围绕坐标的搜索半径。
有关更多信息，请参阅 [查询和偏置](places-querying-biasing.md)。

**优化结果**  
应用筛选条件，以将搜索结果限制为特定的国家/地区或地点类型。  
+ `Filter`：根据国家/地区或地点类型筛选结果。
有关更多详细信息，请参阅[筛选](places-filtering.md)。

**国际化和本地化**  
用于自定义语言和对结果应用政治观点的选项。  
+ `Language`：指定结果的语言。
+ `PoliticalView`：应用反映领土主张的政治观点。
有关更多信息，请参阅 [本地化和国际化](places-localization-internationalization.md)。

**其他功能**  
索取额外数据，例如时区信息。  
+ `AdditionalFeatures`：索取其他数据（例如时区详细信息）的选项。
有关更多信息，请参阅 [其他功能](additional-features.md)。

## 了解响应
<a name="reverse-geocode-response-details"></a>

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

响应包含以下关键数据：

**地址和相关详细信息**  
所返回位置的详细地址信息。  
+ `Address`：完整地址信息，包括国家/地区、区域、邮政编码和街道详细信息。
+ `PostalCodeDetails`：与邮政编码相关的其他详细信息，例如分类和邮政当局。
+ `StreetComponents`：有关街道的其他详细信息，包括基本名称和类型。

**地点类型和类别**  
描述所返回地点的类型和类别。  
+ `Categories`：描述地点的类别，例如*餐厅* 或*学校*。
+ `PlaceType`：指定地点的类型，例如城市、地址或区域。

**结果分析**  
有关每个结果与输入查询的匹配程度的信息。  
+ `MatchScores`：表示每个结果与输入查询的匹配精度的分数。

**其他详细信息**  
提供额外的位置相关数据。  
+ `TimeZone`：该位置的时区信息。
+ `AccessPoints`：表示该位置入口点的地理坐标。