Method: places.get

リソース名（places/{placeId} 形式の文字列）に基づいてプレイスの詳細を取得します。

HTTP リクエスト

GET https://places.googleapis.com/v1/{name=places/*}

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
name

string

必須。場所のリソース名（places/{placeId} 形式）。

クエリ パラメータ

パラメータ
languageCode

string

省略可。場所の詳細が使用言語で表示されます（使用可能な場合）。

現在サポートされている言語の一覧: https://developers.google.com/maps/faq#languagesupport。
regionCode

string

省略可。リクエストの送信元の場所の Unicode 国/地域コード（CLDR）。このパラメータは、地域固有のプレイス名などのプレイスの詳細を表示するために使用されます（利用可能な場合）。このパラメータは、適用される法律に基づいて結果に影響する可能性があります。詳細については、https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html をご覧ください。

なお、現在のところ 3 桁の地域コードはサポートされていません。
sessionToken

string

省略可。請求目的で Autocomplete セッションを識別する文字列。URL とファイル名に安全な base64 文字列で、ASCII 文字で 36 文字以内にする必要があります。それ以外の場合は、INVALID_ARGUMENT エラーが返されます。

セッションは、ユーザーが検索語句を入力し始めたときに開始され、ユーザーが場所を選択し、Place Details または住所検証が呼び出されると終了します。セッションによっては、複数の検索語句が入力された後に、1 つのプレイス詳細リクエストまたは住所検証リクエストが送信される場合もあります。セッション内の各リクエストに使用する認証情報は、同じ Google Cloud コンソール プロジェクトに属している必要があります。セッションが終了すると、トークンは無効になります。アプリでは、セッションごとに新しいトークンを生成する必要があります。sessionToken パラメータを省略した場合、またはセッション トークンを再利用する場合は、セッション トークンが指定されていない場合と同様にセッションが課金されます（各リクエストは個別に課金されます）。

次のガイドラインに従うことをおすすめします。

  • すべての Place Autocomplete 呼び出しにセッション トークンを使用します。
  • セッションごとに新しいトークンを生成します。バージョン 4 の UUID を使用することをおすすめします。
  • セッション内ですべての Place Autocomplete、Place Details、Address Validation リクエストで使用する認証情報が同じ Cloud コンソール プロジェクトに属していることを確認する。
  • 新しいセッションごとに固有のセッション トークンを渡すようにしてください。複数のセッションで同じトークンを使用すると、リクエストごとに課金されます。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功した場合、レスポンスの本文には Place のインスタンスが含まれます。