本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

GetPlace 會使用其唯一的 擷取有關位置的詳細資訊`PlaceId`。請求支援其他功能的選用參數，例如時區資料或音素，以及語言當地語系化。API 會傳回地址、座標、業務詳細資訊、聯絡方式和時區資訊等資訊。

**注意**  
如果儲存結果，則會以較高的儲存體定價方案來計費。使用 `IntendedUse` 參數來指定結果是用於單次使用或儲存。如需與預存結果相關聯的成本詳細資訊[Places 定價](places-pricing.md)，請參閱 。

如需詳細資訊，請參閱《*Amazon Location Service API 參考*》中的 [GetPlace](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_GetPlace.html)。

如需此 API 的請求、回應、cURL 和 CLI 命令範例，請參閱[如何使用 GetPlace](https://docs.aws.amazon.com/location/latest/developerguide/get-place-how-to.html)。

## 使用案例
<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`：時區資訊，包括位移。