GetPlace - Amazon Location Service
ユースケースリクエストを理解するレスポンスを理解する

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

GetPlace

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

注記

結果を保存すると、より高いストレージ料金階層で請求されます。IntendedUse パラメータを使用して、結果を単回使用するか保存するかを指定します。保存された結果に関連する料金の詳細については、「場所の料金」を参照してください。

詳細については、「Amazon Location Service API リファレンス」の「GetPlace」を参照してください。

この API のリクエスト、レスポンス、cURL、CLI コマンドの例については、「GetPlace の使用方法」を参照してください。

ユースケース

  • 保存済みデータの更新: アプリケーションが正確かつ最新の情報を提供するよう、保存済みデータを定期的に更新します。GetPlace API を使用して、企業と場所の詳細を更新し、ユーザーが最新情報を把握できるようにします。例えば地域のレストランやショップは、ユーザーからの信頼を高めてアプリケーションの機能を強化するために、営業時間、連絡先の詳細、ユーザーレビューを更新します。

  • 入力候補の後に場所の詳細を取得する: GetPlace API をオートコンプリートまたは提案機能に統合することにより、ユーザーエクスペリエンスを向上させます。ユーザーが住所、会社名、または対象ポイントを入力すると、関連する場所が提案され、選択後に GetPlace がより詳細な情報へのアクセスを可能にします。

リクエストを理解する

GetPlace API リクエストには、PlaceId などの特定のパラメータが必要です。また、追加機能や言語のローカリゼーションのためのオプションのパラメータをサポートしています。これらのパラメータは、言語、用途、地理的コンテキストに基づいて結果を調整するのに役立ちます。詳細については、GetPlace API リファレンスを参照してください。

リクエストは、次のキーパラメータを受け入れます。

認証

他の認証方法を使用する場合、Key パラメータはオプションです。

  • Key: 認証用の API キー。

詳細については、「Amazon Location Service を使用して認証する」を参照してください。

クエリ

場所情報を取得するための一意の識別子を定義します。

  • PlaceId - 場所の一意の識別子 (必須)。

詳細については、「クエリとバイアス」を参照してください。

国際化とローカリゼーション

言語をカスタマイズし、結果にポリティカルビューを適用するオプション。

  • Language: 結果の言語を指定します。

  • PoliticalView: 領土主張を反映したポリティカルビューを適用します。

詳細については、「ローカリゼーションと国際化」を参照してください。

その他の機能

タイムゾーンの詳細などの追加データをリクエストします。

  • AdditionalFeatures: タイムゾーンや音素の詳細などの追加情報をリクエストするオプション。

詳細については、「その他の機能」を参照してください。

レスポンスを理解する

GetPlace API からのレスポンスには、住所、座標、企業の詳細などの基本データや、リクエストパラメータに基づく追加データが含まれます。アクセス制限、タイムゾーン、発音の音素の詳細などの情報も提供できます。詳細については、GetPlace API リファレンスを参照してください。

このレスポンスには、以下のキーデータが含まれます。

住所と関連情報

ロケーションの完全な住所の詳細を提供します。

  • Address: 国、地域、郵便番号など、住所の完全な情報。

  • PostalCodeDetails: 郵便番号と機関に関する追加情報。

場所のタイプとカテゴリ

場所のタイプとカテゴリについて説明します。

  • BusinessChains: 関連するビジネスチェーンに関する情報。

  • Categories: 食料品や小売りなど、場所が属するカテゴリ。

  • PlaceType: 対象ポイントや場所など、場所のタイプ。

その他の詳細

リクエストで指定された場所に関する追加データを提供します。

  • Contacts: 電話番号、E メール、ウェブサイトなどの連絡方法。

  • OpeningHours: 営業時間またはアクセス時間。

  • AccessPoints: アクセスポイントの地理的座標 (経度と緯度)。

  • Phonemes: さまざまな住所の要素の発音。

  • TimeZone: オフセットを含むタイムゾーン情報。