Place Details（新規）

プラットフォームを選択: Android iOS JavaScript ウェブサービス

プレイス ID を取得したら、 特定の施設の詳細情報や 開始して Place Details（New） リクエストできます。A Place Details（新） リクエストにより、指定された場所に関するより包括的な情報が返される 詳細な住所、電話番号、ユーザーの評価、クチコミなど、

プレイス ID はさまざまな方法で取得できます。次を使用できます。

API Explorer を使用すると、ライブ リクエストを発行できるため、API と API オプション:

試してみる

Place Details (New) リクエスト

Place Details リクエストは、次の形式の HTTP GET リクエストです。

https://places.googleapis.com/v1/places/PLACE_ID

すべてのパラメータを URL パラメータとして、または GET リクエスト。例:

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY

または、cURL コマンドで次のようにします。

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Place Details（新）レスポンス

Place Details (New) は、 <ph type="x-smartling-placeholder"></ph> レスポンスとしての JSON オブジェクト。レスポンスの説明:

  • レスポンスは、トレーニング データの Place 渡されます。Place オブジェクトには、インスタンスに関する詳細情報が含まれます。 できます。
  • リクエストで渡される FieldMask はフィールドのリストを指定します。 Place オブジェクトで返されます。

完全な JSON オブジェクトの形式は次のとおりです。

{
  "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "displayName": {
    "text": "Trinidad"
  }
  ...
}

必須パラメータ

  • FieldMask

    レスポンスで返すフィールドのリストを指定するには、 レスポンス フィールド マスク。 URL パラメータを使用してレスポンス フィールド マスクをメソッドに渡します。 $fields または fields、または HTTP ヘッダーを使用する X-Goog-FieldMask。レスポンスで返されるフィールドのデフォルトのリストはありません。 フィールド マスクを省略すると、メソッドはエラーを返します。

    フィールド マスキングは、API 呼び出しのリクエストを 保存し、不要な処理時間を回避して、 請求料金を管理できます。

    返される場所のデータタイプをカンマ区切りのリストで指定します。たとえば 場所の表示名と住所を取得できます。

    X-Goog-FieldMask: displayName,formattedAddress

    * を使用してすべてのフィールドを取得します。

    X-Goog-FieldMask: *

    次のフィールドを 1 つ以上指定します。

    • 以下のフィールドで Place Details（ID のみ）SKU がトリガーされます。

      attributions, id, name*、 photos

      * name フィールドには場所のリソース名が含まれます 次の形式にします: places/PLACE_ID。displayName を使用する 場所のテキスト名にアクセスします。

    • 次のフィールドで Place Details（場所のみ）SKU がトリガーされます。

      addressComponents, adrFormatAddress, formattedAddress, location, plusCode, shortFormattedAddress, types, viewport

    • 以下のフィールドで Place Details（Basic）SKU がトリガーされます。

      accessibilityOptions, businessStatus, displayName, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType, primaryTypeDisplayName, subDestinations, utcOffsetMinutes

    • 以下のフィールドで Place Details（Advanced）SKU がトリガーされます。

      currentOpeningHours, currentSecondaryOpeningHours, internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, regularSecondaryOpeningHours, userRatingCount, websiteUri

    • 以下のフィールドで Place Details（Preferred）SKU がトリガーされます。

      allowsDogs, curbsidePickup, delivery, dineIn, editorialSummary, evChargeOptions, fuelOptions, goodForChildren, goodForGroups, goodForWatchingSports, liveMusic, menuForChildren, parkingOptions, paymentOptions, outdoorSeating, reservable, restroom, reviews, servesBeer, servesBreakfast, servesBrunch, servesCocktails, servesCoffee, servesDessert, servesDinner, servesLunch, servesVegetarianFood, servesWine, takeout

  • placeId

    場所を一意に識別するテキスト表記の ID。 テキスト検索（新版） Nearby Search（新版）。 プレイス ID について詳しくは、 プレイス ID の概要をご覧ください。

    文字列 places/PLACE_ID は「場所」とも呼ばれます。 リソース名。Place Details（New）からのレスポンスで、 Nearby Search（新版）、テキスト検索（新版） この文字列はレスポンスの name フィールドに格納されます。スタンドアロン プレイス ID はレスポンスの id フィールドに含まれます。

オプション パラメータ

  • languageCode

    結果を返す言語。

    • 詳しくは、 サポートされている言語の一覧をご覧ください。Google は頻繁に更新 対応言語が限られているため、このリストがすべてを網羅しているとは限りません。
    • languageCode が指定されていない場合、API はデフォルトで en になります。条件 無効な言語コードを指定すると、API から INVALID_ARGUMENT エラーが返されます。
    • API は可能な限り判読可能な番地を提供する ローカルユーザーの両方に対応しますこの目標を達成するために、 ローカル言語で記述されたアドレスを、API によって読み取り可能なスクリプトに ユーザーが必要に応じて言語を観察します。その他 住所は優先言語で返されます。住所項目は次のとおりです。 すべて同じ言語が返されます。言語は、最初の言語から 説明します。
    • 使用したい言語で名前が使用できない場合、API は 最も近いものを選択します
    • 優先言語は、表示される結果セットにほとんど影響しません。 返される順序を指定します。「 ジオコーダは、略語を言語、 道路の種類の略語や同義語など、 ある言語では有効であっても別の言語では有効でない場合があります

  • regionCode

    レスポンスのフォーマットに使用される地域コード。 <ph type="x-smartling-placeholder"></ph> 2 文字の CLDR コードの値。デフォルト値はありません。

    レスポンスの formattedAddress フィールドの国名が regionCode の場合、国コードは formattedAddress から省略されます。 このパラメータは adrFormatAddress（常に国を含む）には影響しません。 これを含まない shortFormattedAddress で使用できます。

    ほとんどの CLDR コードは ISO 3166-1 コードと同一です。 いくつか例外がありますたとえば、英国の ccTLD は 「uk」（.co.uk）、ISO 3166-1 コードは「gb」（技術的には、 「グレート ブリテンおよび北アイルランド連合王国」という当事者である必要があります）。 このパラメータは、適用される法律に基づき、結果に影響する場合があります。

  • sessionToken

    セッション トークンは、予測入力を追跡するユーザー生成文字列です。 （新規）通話を「セッション」と呼びます。予測入力（新版）ではセッション トークンを使用して ユーザーの予測入力検索のクエリと場所選択のフェーズを個別のセッションにグループ化する 請求に使用されます。セッション トークンが Place Details に渡される（新） 。詳細については、次をご覧ください: セッション トークン。

Place Details の例

次の例では、場所の詳細をリクエストしています。 placeId:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

X-Goog-FieldMask ヘッダーは、 レスポンス データ フィールド id,displayName が含まれています。 レスポンスは次の形式になります。

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

追加情報を返すには、フィールド マスクにデータ型を追加します。 たとえば、formattedAddress,plusCode を追加して メールアドレスと Plus Code response:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

レスポンスは次の形式になります。

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "plusCode": {
    "globalCode": "849VCWC7+RW",
    "compoundCode": "CWC7+RW Mountain View, CA, USA"
  },
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

試してみよう:

API Explorer を使用すると、サンプル リクエストを作成して、 API と API オプションに慣れることができます。

リクエストを行うには:

  1. API アイコン API Explorer を開きます。 を選択します。 。
  2. 必要に応じて、name パラメータを次のように設定します。 
    places/PLACE_ID
  3. 必要に応じて [標準パラメータを表示] を展開し、次のように設定します。 fields パラメータ フィールド マスクに追加します。
  4. [Execute] ボタンを選択します。ポップアップで、削除するアカウントを選択します。 使用します。

  5. [API Explorer] パネルで、展開アイコンを選択します。 API Explorer を開きます。: API Explorer ウィンドウを展開します。