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

# GetPlace
<a name="get-place"></a>

GetPlace 使用地点的唯一`PlaceId`信息检索有关该地点的详细信息。该请求支持一些可选参数，用于实现其他功能，例如时区数据、音素以及语言本地化。该 API 会返回地址、坐标、企业详细信息、联系方式和时区信息等信息。

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

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

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

## 使用案例
<a name="get-place-use-cases"></a>
+ **刷新存储的数据：**定期刷新存储的数据，以确保您的应用程序提供准确的最新信息。使用 GetPlace API 更新有关企业和场所的详细信息，确保用户获得最新信息。例如，刷新当地餐厅或商店的营业时间、联系方式和用户评价，以增强用户信任和应用程序功能。
+ 根据@@ **预先输入建议检索地点详情：**将 GetPlace API 与自动完成功能或建议功能集成，从而改善用户体验。当用户键入地址、公司名称或兴趣点时，建议会提供相关地点，并在做出选择后 GetPlace可以访问更详细的信息。

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

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

 GetPlace API 请求需要特定的参数，例如`PlaceId`，并且支持用于其他功能或语言本地化的可选参数。这些参数可帮助用户根据语言、预期用途和地理环境来定制结果。如需了解更多详情，请参阅 GetPlace API 参考。

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

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

**查询**  
定义用于检索地点信息的唯一标识符。  
+ `PlaceId`：地点的唯一标识符。（必需）
有关更多信息，请参阅 [查询和偏置](places-querying-biasing.md)。

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

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

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

来自 GetPlace API 的响应包括地址、坐标和业务详细信息等基本数据，以及基于请求参数的其他数据。还可以提供诸如通行限制、时区和发音的音素详细信息之类的信息。有关更多详细信息，请参阅 GetPlace API 参考。

响应包含以下关键数据：

**地址和相关详细信息**  
提供该位置的完整地址详细信息。  
+ `Address`：完整的地址信息，包括国家/地区、区域和邮政编码。
+ `PostalCodeDetails`：有关邮政编码和相关机构的更多信息。

**地点类型和类别**  
描述地点的类型和类别。  
+ `BusinessChains`：有关任何相关连锁企业的信息。
+ `Categories`：该地点所属的类别，例如餐饮类或零售类。
+ `PlaceType`：地点的类型，例如兴趣点或地区。

**其他细节**  
提供有关该地点的其他数据（如请求中所指定）。  
+ `Contacts`：联系方式，包括电话号码、电子邮件地址和网站。
+ `OpeningHours`：营业时间或通行时间。
+ `AccessPoints`：出入口的地理坐标（经度和纬度）。
+ `Phonemes`：各种地址组成部分的发音。
+ `TimeZone`：时区信息，包括偏移量。