翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

GetPlace は、一意の `PlaceId` を使用して場所に関する詳細情報を取得します。リクエストは、タイムゾーンデータや音素、言語のローカリゼーションなどの追加機能のオプションのパラメータをサポートしています。API は、住所、座標、企業の詳細、問い合わせ方法、タイムゾーン情報などの情報を返します。

**注記**  
結果を保存すると、より高いストレージ料金階層で請求されます。`IntendedUse` パラメータを使用して、結果を単回使用するか保存するかを指定します。保存された結果に関連する料金の詳細については、「[場所の料金](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`: 電話番号、E メール、ウェブサイトなどの連絡方法。
+ `OpeningHours`: 営業時間またはアクセス時間。
+ `AccessPoints`: アクセスポイントの地理的座標 (経度と緯度)。
+ `Phonemes`: さまざまな住所の要素の発音。
+ `TimeZone`: オフセットを含むタイムゾーン情報。