このページは Cloud Translation API によって翻訳されました。

Place Details（新規）

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

欧州経済領域（EEA）のデベロッパー

はじめに

プレイス ID を取得したら、Place Details (New) リクエストを開始して、特定の店やスポットに関する詳細をリクエストできます。Place Details（新版）リクエストは、指定の場所に関する包括的な情報（完全な住所、電話番号、ユーザーのレビューや評価など）を返します。

プレイス ID を取得する方法は多数あります。次を使用できます。

API Explorer を使用すると、ライブリクエストを行って、API と API オプションを理解できます。

試してみる

Place Details (New) リクエスト

Place Details (New) リクエストは、次の形式の 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（新版）は、レスポンスとして JSON オブジェクトを返します。レスポンスの説明:

レスポンスは Place オブジェクトで表されます。Place オブジェクトには、場所に関する詳細情報が含まれています。
リクエストで渡される FieldMask は、Place オブジェクトで返されるフィールドのリストを指定します。

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

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

必須パラメータ

FieldMask

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

フィールドマスキングは、不要なデータをリクエストしないようにするための優れた設計手法です。これにより、不要な処理時間と請求料金を回避できます。

返す場所データのタイプのカンマ区切りリストを指定します。たとえば、場所の表示名と住所を取得する場合などです。
```
X-Goog-FieldMask: displayName,formattedAddress
```
注: フィールドリスト内の任意の場所にスペースを使用することはできません。
すべてのフィールドを取得するには、* を使用します。
```
X-Goog-FieldMask: *
```
ワイルドカード「*」はすべてのフィールドを選択します。
ただし、開発ではワイルドカードを使用しても問題ありませんが、返されるデータ量が多いため、本番環境ではワイルドカード（*）レスポンスフィールドマスクを使用しないことをおすすめします。
iconMaskBaseUri と iconBackgroundColor の使用に関する詳細なガイダンスについては、プレイスアイコンのセクションをご覧ください。
次のフィールドを 1 つ以上指定します。
- 次のフィールドは、Place Details Essentials IDs Only SKU をトリガーします。
  
  attributions
  id
  name^*
  photos
  
  ^* name フィールドには、places/PLACE_ID の形式で場所のリソース名が含まれます。場所のテキスト名を取得するには、Pro SKU で displayName フィールドをリクエストします。
- 次のフィールドは、Place Details Essentials SKU をトリガーします。
  
  addressComponents
  addressDescriptor^*
  adrFormatAddress
  formattedAddress
  location
  plusCode
  postalAddress
  shortFormattedAddress
  types
  viewport
  
  ^* アドレス記述子は、インドのお客様には一般提供されていますが、他の地域では試験運用されています。
- 次のフィールドは、Place Details Pro SKU をトリガーします。
  
  accessibilityOptions
  businessStatus
  containingPlaces
  displayName
  googleMapsLinks
  googleMapsUri
  iconBackgroundColor
  iconMaskBaseUri
  primaryType
  primaryTypeDisplayName
  pureServiceAreaBusiness
  subDestinations
  utcOffsetMinutes
- 次のフィールドは、Place Details Enterprise SKU をトリガーします。
  
  currentOpeningHours
  currentSecondaryOpeningHours
  internationalPhoneNumber
  nationalPhoneNumber
  priceLevel
  priceRange
  rating
  regularOpeningHours
  regularSecondaryOpeningHours
  userRatingCount
  websiteUri
- 次のフィールドは、Place Details Enterprise + Atmosphere SKU をトリガーします。
  
  allowsDogs
  curbsidePickup
  delivery
  dineIn
  editorialSummary
  evChargeAmenitySummary
  evChargeOptions
  fuelOptions
  generativeSummary
  goodForChildren
  goodForGroups
  goodForWatchingSports
  liveMusic
  menuForChildren
  neighborhoodSummary
  parkingOptions
  paymentOptions
  outdoorSeating
  reservable
  restroom
  reviews
  reviewSummary
  routingSummaries^*
  servesBeer
  servesBreakfast
  servesBrunch
  servesCocktails
  servesCoffee
  servesDessert
  servesDinner
  servesLunch
  servesVegetarianFood
  servesWine
  takeout
  
  ^* テキスト検索と周辺検索のみ
placeId

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

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

注: プレイスの詳細（以前のバージョン）では、レスポンスの name フィールドに、人が読める形式の場所の名前が含まれていました。新しい API では、このフィールドは displayName と呼ばれます。

オプションパラメータ

languageCode

結果を返す言語。
- サポートされている言語の一覧をご覧ください。サポート対象の言語は頻繁に更新されるため、このリストで網羅されていない場合があります。
- languageCode が指定されていない場合、API はデフォルトで en になります。無効な言語コードを指定すると、API は INVALID_ARGUMENT エラーを返します。
- API は、ユーザーと地元住民の両方が読める番地を可能な限り提供します。この目標を達成するため、優先言語を考慮し、必要に応じてユーザーが読める文字に音訳して、現地の言語で住所を返します。その他の住所はすべて、優先言語で返されます。住所コンポーネントはすべて同じ言語で返されます。この言語は最初のコンポーネントから選択されます。
- 優先言語で名前が使用できない場合、API は最も近い一致を使用します。
- 優先言語は、API が返す結果のセットと、それらが返される順序にわずかな影響を与えます。ジオコーダーは、言語に応じて略語（通りの種類を表す略語や、ある言語では有効だが別の言語では有効でない同義語など）を異なる方法で解釈します。
regionCode

レスポンスのフォーマットに使用される地域コード。 2 文字の CLDR コード値として指定します。デフォルト値はありません。

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

大半の CLDR コードは ISO 3166-1 コードと同一ですが、いくつか注意が必要な例外もあります。たとえば、英国の ccTLD は「uk」（.co.uk）ですが、ISO 3166-1 コードは「gb」（厳密には「グレートブリテンおよび北アイルランド連合王国」のエンティティ用）です。このパラメータは、適用される法律に基づいて結果に影響を与える可能性があります。
sessionToken

セッショントークンは、Autocomplete（新版）の呼び出しを「セッション」として追跡するユーザー生成の文字列です。Autocomplete（新版）は、セッショントークンを使用して、予測入力検索でのユーザーのクエリと場所の選択フェーズを、請求処理のために個別のセッションにグループ化します。セッショントークンは、Autocomplete（新規）呼び出しに続く 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 を含めます。

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"
  }
}

住所記述子を取得する

住所記述子は、近くのランドマークや含まれるエリアなど、場所の位置に関する関係情報を提供します。

注: 住所記述子は、通常はインドのお客様にご利用いただけますが、その他の地域では試験運用中です。フィールドマスクで addressDescriptor のみを使用する Places API リクエストは、SKU: Places API Place Details Essentials で課金されます。

次の例は、サンノゼのショッピングモールにあるデパートの Place Details（新版）リクエストを示しています。この例では、フィールドマスクに addressDescriptors を含めます。

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

レスポンスには、リクエストで指定された場所、近くのランドマークのリストとその場所からの距離、エリアのリストとその場所との包含関係が含まれます。

  {
    "name": "places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4",
    "displayName": {
      "text": "Macy's",
      "languageCode": "en"
    },
    "addressDescriptor": {
      "landmarks": [
        {
          "name": "places/ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
          "placeId": "ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "types": [
            "clothing_store",
            "department_store",
            "establishment",
            "food",
            "movie_theater",
            "point_of_interest",
            "restaurant",
            "shoe_store",
            "shopping_mall",
            "store"
          ],
          "spatialRelationship": "WITHIN",
          "straightLineDistanceMeters": 220.29175
        },
        {
          "name": "places/ChIJ62_oCR7Lj4AR_MGWkSPotD4",
          "placeId": "ChIJ62_oCR7Lj4AR_MGWkSPotD4",
          "displayName": {
            "text": "Nordstrom",
            "languageCode": "en"
          },
          "types": [
            "clothing_store",
            "department_store",
            "establishment",
            "point_of_interest",
            "shoe_store",
            "store"
          ],
          "straightLineDistanceMeters": 329.45178
        },
        {
          "name": "places/ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "placeId": "ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "displayName": {
            "text": "Monroe Parking Garage",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "parking",
            "point_of_interest"
          ],
          "straightLineDistanceMeters": 227.05153
        },
        {
          "name": "places/ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "placeId": "ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "displayName": {
            "text": "Studios Inn by Daiwa Living California Inc.",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "lodging",
            "point_of_interest",
            "real_estate_agency"
          ],
          "straightLineDistanceMeters": 299.9955
        },
        {
          "name": "places/ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "placeId": "ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "displayName": {
            "text": "Din Tai Fung",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "food",
            "point_of_interest",
            "restaurant"
          ],
          "straightLineDistanceMeters": 157.70943
        }
      ],
      "areas": [
        {
          "name": "places/ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "placeId": "ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "placeId": "ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "displayName": {
            "text": "Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "placeId": "ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "displayName": {
            "text": "Central San Jose",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        }
      ]
    }
  }

試してみよう:

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

ページの右側にある API アイコン api を選択します。
必要に応じてリクエストパラメータを編集します。
[Execute] ボタンを選択します。ダイアログで、リクエストに使用するアカウントを選択します。
API Explorer パネルで、全画面アイコン fullscreen を選択して API Explorer ウィンドウを拡大します。

Place Details（新規） コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

はじめに

Place Details (New) リクエスト

Place Details（新版）のレスポンス

必須パラメータ

FieldMask

placeId

オプション パラメータ

languageCode

regionCode

sessionToken

Place Details（新規）の例

住所記述子を取得する

試してみよう:

Place Details（新規）

オプションパラメータ