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

# 地理编码
<a name="geocode"></a>

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

**注意**  
存储的结果会产生更高的存储费用。使用 `IntendedUse` 参数指示是一次性使用还是存储。要了解存储结果的成本影响，请参阅[地点定价](places-pricing.md)。

有关更多信息，请参阅《Amazon Location Service API 参考》**中的[地理编码](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Geocode.html)。

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

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

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

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

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

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

**查询和偏置**  
用于查询结果和对结果进行地理偏置的参数。  
+ `QueryText`：用于搜索位置的自由格式文本查询。
+ `QueryComponents`：用于精确搜索的结构化组件（例如地址号、国家、地区或邮政编码等）。
+ `BiasPosition`：搜索结果偏向的地理位置。
有关更多信息，请参阅 [查询和偏置](places-querying-biasing.md)。

**优化结果**  
应用筛选条件来优化结果。  
+ `Filter`：用于包括特定国家/地区或地点类型的筛选条件。有关更多信息，请参阅 [筛选](places-filtering.md)。

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

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

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

该响应提供 `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`：该位置的时区信息。