REST Resource: places

{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "areaSummary": {
    object (AreaSummary)
  },
  "utcOffsetMinutes": integer,
  "userRatingCount": integer,
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean,
  "curbsidePickup": boolean,
  "reservable": boolean,
  "servesBreakfast": boolean,
  "servesLunch": boolean,
  "servesDinner": boolean,
  "servesBeer": boolean,
  "servesWine": boolean,
  "servesBrunch": boolean,
  "servesVegetarianFood": boolean,
  "outdoorSeating": boolean,
  "liveMusic": boolean,
  "menuForChildren": boolean,
  "servesCocktails": boolean,
  "servesDessert": boolean,
  "servesCoffee": boolean,
  "goodForChildren": boolean,
  "allowsDogs": boolean,
  "restroom": boolean,
  "goodForGroups": boolean,
  "goodForWatchingSports": boolean,
  "accessibilityOptions": {
    object (AccessibilityOptions)
  }
}

string

このプレイスのリソース名（places/{placeId} 形式）。プレイスの検索に使用できます。

string

場所の一意の識別子です。

object (LocalizedText)

場所のローカライズされた名前です。人が読める短い説明に適しています。たとえば、「Google Sydney」、「Starbucks」、「Pyrmont」などです。

string

この結果の型タグのセット。例: 「政治」「地域区分」があります設定可能な値の一覧については、表 A と表 B（https://developers.google.com/maps/documentation/places/web-service/place-types）をご覧ください。

string

指定された結果のメインのタイプ。このタイプは、Places API でサポートされているタイプである必要があります。たとえば、「レストラン」、「カフェ」、「空港」などです。1 つの場所に設定できるメインタイプは 1 つだけです。設定可能な値の一覧については、表 A と表 B（https://developers.google.com/maps/documentation/places/web-service/place-types）をご覧ください。

object (LocalizedText)

必要に応じてリクエストの言語にローカライズされた、メインのタイプの表示名。設定可能な値の一覧については、表 A と表 B（https://developers.google.com/maps/documentation/places/web-service/place-types）をご覧ください。

string

人が読める形式の、スポットの電話番号（国内向け）。

string

人が読める形式のビジネスの電話番号（国際電話形式）。

string

この場所の完全な住所（人が読める形式）。

string

この場所の、人が読める短い住所。

object (AddressComponent)

地域区分レベルごとに繰り返すコンポーネント。addressComponents[] 配列については、次の点に注意してください。 - 住所コンポーネントの配列には、formattedAddress よりも多くのコンポーネントが含まれている場合があります。- 配列には、formattedAddress に含まれているものを除き、住所を含むすべての行政区画が含まれているとは限りません。特定の住所を含むすべての行政区画を取得するには、リバース ジオコーディングを使用して住所の緯度と経度をパラメータとしてリクエストに渡します。- レスポンスの形式は、リクエスト間で同じになるとは限りません。特に、addressComponents の数はリクエストされた住所によって異なり、同じ住所でも経時的に変化する可能性があります。コンポーネントは配列内の位置を変更できます。コンポーネントのタイプは変わる場合があります。特定のコンポーネントが後のレスポンスに含まれない場合があります。

object (PlusCode)

場所の緯度/経度の Plus Code。

object (LatLng)

この場所の位置。

object (Viewport)

平均サイズの地図で場所を表示するのに適したビューポート。

number

この場所に関するユーザーのクチコミに基づく 1.0 ～ 5.0 の評価。

string

この場所の詳細情報を表示する URL。

string

この場所の信頼できるウェブサイト（例:ビジネスできます。チェーンに加盟する場所（IKEA の店舗など）の場合は、チェーン全体ではなく個々の店舗のウェブサイトになります。

object (Review)

この場所に関するクチコミを、関連性の高い順に並べたリストです。最大 5 件のレビューが返されます。

object (OpeningHours)

通常の営業時間。

object (Photo)

この場所の写真に関する情報（参照を含む）。最大 10 枚の写真を返すことができます。

string

microformats の adr（http://microformats.org/wiki/adr）で表した場所の住所です。

enum (BusinessStatus)

その場所のビジネス ステータス。

enum (PriceLevel)

場所の価格レベル。

object (Attribution)

この結果に表示される必要があるデータ プロバイダのセット。

string

アイコンマスクの短縮 URL。末尾にタイプ サフィックス（「.svg」や「.png」など）を追加することで、さまざまなタイプのアイコンにアクセスできます。

string

16 進数形式の icon_mask の背景色。例:#909CE1。

object (OpeningHours)

今後 7 日間の営業時間（今日を含む）。期間はリクエストの日付の深夜 0 時から 6 日後の午後 11 時 59 分までです。このフィールドには、すべての営業時間の specialDays サブフィールドが含まれ、例外的な営業時間がある日付に設定されます。

object (OpeningHours)

ビジネスの第 2 の営業時間に関する情報を含む、今後 7 日間のエントリの配列が含まれます。予備の営業時間は、ビジネスのメインの営業時間とは異なります。たとえば、レストランの場合は、予備の営業時間としてドライブスルーや配達の営業時間を指定できます。このフィールドでは type サブフィールドに値が入力されます。これは、場所のタイプに基づいて事前定義された営業時間タイプ（DRIVE_THROUGH、PICKUP、TAKEOUT など）のリストから抽出されます。このフィールドには、すべての営業時間の specialDays サブフィールドが含まれ、例外的な営業時間がある日付に設定されます。

object (OpeningHours)

ビジネスの通常の第 2 営業時間に関する情報のエントリの配列を指定します。予備の営業時間は、ビジネスのメインの営業時間とは異なります。たとえば、レストランの場合は、予備の営業時間としてドライブスルーや配達の営業時間を指定できます。このフィールドでは type サブフィールドに値が入力されます。これは、場所のタイプに基づいて事前定義された営業時間タイプ（DRIVE_THROUGH、PICKUP、TAKEOUT など）のリストから抽出されます。

object (LocalizedText)

場所の概要が含まれます。まとめはテキストによる概要で構成され、該当する場合はそれらの言語コードも含まれます。概要テキストはそのままの状態で提示する必要があります。変更や変更はできません。

object (PaymentOptions)

その場所で利用できる支払い方法。支払いオプションのデータを利用できない場合、支払いオプション フィールドは設定されません。

object (ParkingOptions)

その場所が提供する駐車場のオプション。

object (SubDestination)

場所に関連するサブデスティネーションのリスト。

object (FuelOptions)

ガソリン スタンドの燃料オプションに関する最新情報。この情報は定期的に更新されます。

object (EVChargeOptions)

EV 充電オプションに関する情報。

object (GenerativeSummary)

試験運用版: 詳しくは、https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。

AI 生成による場所の概要。

object (AreaSummary)

試験運用版: 詳しくは、https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。

その場所があるエリアの AI 生成の概要。

integer

この場所のタイムゾーンと UTC とのオフセットを分数で示します。1 時間単位でオフセットするタイムゾーンをサポートするために、分数で表されます。例:X 時間 15 分。

integer

この場所に関するクチコミの合計数（テキストあり / なし）。

boolean

ビジネスがデータ エクスポートに対応しているかどうかを指定します。

boolean

ビジネスが配達に対応しているかどうかを指定します。

boolean

屋内席と屋外席のどちらのオプションを提供しているかを指定します。

boolean

店舗がピックアップに対応しているかどうかを指定します。

boolean

場所が予約に対応しているかどうかを指定します。

boolean

場所で朝食を提供するかどうかを指定します。

boolean

ランチを提供するかどうかを指定します。

boolean

ディナーを提供するかどうかを指定します。

boolean

ビールを提供するかどうかを指定します。

boolean

ワインを提供するかどうかを指定します。

boolean

ブランチを提供するかどうかを指定します。

boolean

ベジタリアン料理を提供しているかどうかを指定します。

boolean

テラス席あり。

boolean

生演奏も楽しめる。

boolean

子供向けメニューがある。

boolean

カクテルを提供する店。

boolean

デザートもある。

boolean

コーヒーを提供。

boolean

子ども連れに適した場所です。

boolean

犬の同伴可。

boolean

トイレあり。

boolean

団体客に対応しています。

boolean

スポーツ観戦に適しています。

object (AccessibilityOptions)

場所が提供するバリアフリーの情報。

{
  "text": string,
  "languageCode": string
}

string

下記の languageCode に対応する言語でローカライズされた文字列。

string

テキストの BCP-47 言語コード（「en-US」など）「sr-Latn」を指定します。

詳細については、http://www.unicode.org/reports/tr35/#Unicode_locale_identifier をご覧ください。

{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}

string

住所コンポーネントの詳細な説明または名前。たとえば、国がオーストラリアの住所コンポーネントの場合、long_name が「Australia」になる場合があります。

string

住所コンポーネントの略称（利用可能な場合）。たとえば、オーストラリアの住所コンポーネントの場合、short_name は「AU」になります。

string

住所コンポーネントのタイプを示す配列。

string

このコンポーネントのフォーマットに使用する言語（CLDR 表記）。

{
  "globalCode": string,
  "compoundCode": string
}

string

場所のグローバル（完全な）コード（「9FWM33GV+HQ」など）。1/8, 000 x 1/8,000 度（約 14 x 14 メートル）の領域を表します。

string

場所の複合コード（「33GV+HQ, Ramberg, Norway」など）。グローバル コードの接尾辞を含み、接頭辞が参照エンティティのフォーマットされた名前に置き換えられます。

{
  "latitude": number,
  "longitude": number
}

number

緯度（度単位）。範囲 [-90.0, +90.0] 内になければなりません。

number

経度（度単位）。範囲 [-180.0, +180.0] 内になければなりません。

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

必須。ビューポートの最低点。

object (LatLng)

必須。ビューポートの上限。

{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string
}

string

この場所のクチコミを表す参照。この場所のクチコミを再度検索するために使用できます（API「リソース名」places/{placeId}/reviews/{review} とも呼ばれます）。

string

現在の時刻を基準とした審査時刻を言語と国に応じた形式で表す、フォーマットされた最近の時刻の文字列。

object (LocalizedText)

ローカライズされたレビューのテキスト。

object (LocalizedText)

元の言語でのレビュー テキスト。

number

1.0 ～ 5.0 の数。星の数とも呼ばれます。

object (AuthorAttribution)

このレビューの投稿者です。

string (Timestamp format)

レビューのタイムスタンプ。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。

{
  "displayName": string,
  "uri": string,
  "photoUri": string
}

string

Photo または Review の作成者の名前。

string

Photo または Review の作成者の URI。

string

Photo または Review の作成者のプロフィール写真の URI。

{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "openNow": boolean
}

object (Period)

この場所が営業している 1 週間の期間。期間は時系列で表示され、場所のローカル タイムゾーンの日曜日から始まります。値が空の場合は、営業していない場所を示します。例:改装のため臨時休業しているためです。

string

この場所の営業時間を表すローカライズされた文字列です（曜日ごとに 1 つの文字列）。営業時間が不明な場合、またはローカライズされたテキストに変換できない場合は空になります。例: 「日: 18:00 ～ 06:00」

enum (SecondaryHoursType)

予備の営業時間のタイプを識別するために使用される文字列型です。

object (SpecialDay)

返された営業時間に含まれる特別な日に関する構造化された情報。特別な日とは、場所の営業時間に影響を与える可能性がある日のことです。クリスマス。例外的な営業時間がある場合は、currentOpeningHours と currentSecondaryOpeningHours に設定されます。

boolean

この場所は現在営業していますか？これらの営業時間について時間帯またはタイムゾーンのデータがない場合を除き、常に表示します。

{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}

object (Point)

店舗の開店時間です。

object (Point)

ビジネスが閉業を始める時間です。

{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}

object (Date)

場所のローカル タイムゾーンの日付。

boolean

このエンドポイントが切り捨てられたかどうか。切り捨てが発生するのは、実際の営業時間が、Google が返せる時間の範囲外である場合です。そのため、その時間数だけを切り詰めて戻します。これにより、リクエスト日の午前 0 時から最大で 24 × 7 時間後の結果が返されます。

integer

0 ～ 6 の整数で表した曜日。0 は日曜日、1 は月曜日のようになります。

integer

2 桁の時間。値の範囲は 00 ～ 23 です。

integer

分（2 桁）。値の範囲は 00 ～ 59 です。

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

その日付の年。1～9999、または年のない日付を指定する場合は 0 にする必要があります。

integer

1 年の中の月。1～12、または月と日のない年を指定する場合は 0 にする必要があります。

integer

1 月の中の日付。1～31 で、その年と月に対して有効である必要があります。または、日が重要でない場合に、年のみか年と月を指定するには 0 にする必要があります。

{
  "date": {
    object (Date)
  }
}

object (Date)

特別な日の日付。

{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ]
}

string

ID。この場所の写真を表す参照。この場所の写真を再度検索するために使用できます（API の「リソース名」places/{placeId}/photos/{photo}）。

integer

使用できる最大の幅（ピクセル単位）。

integer

使用できる最大の高さ（ピクセル単位）。

object (AuthorAttribution)

この写真の作成者です。

{
  "provider": string,
  "providerUri": string
}

string

場所のデータ プロバイダの名前。

string

プレイスのデータ プロバイダの URI。

{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}

boolean

クレジット カードによる支払いをご利用いただけます。

boolean

デビットカードでの支払いが可能です。

boolean

支払いは現金のみとなります。この属性を持つ場所では、他の支払い方法を引き続き利用できる場合があります。

boolean

このお店は NFC 支払いに対応しています。

{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}

boolean

無料駐車場あり。

boolean

有料駐車場あり。

boolean

無料の路上駐車スペースあり。

boolean

有料の路上駐車スペースあり。

boolean

係員による駐車サービスあり。

boolean

無料の屋内駐車場あり。

boolean

有料の屋内駐車場あり。

{
  "name": string,
  "id": string
}

string

サブ デスティネーションのリソース名。

string

サブデスティネーションのプレイス ID。

{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}

boolean

車椅子対応の駐車場あり。

boolean

車椅子対応の入り口があるお店や、

boolean

車椅子対応のトイレあり。

boolean

車椅子対応の席がある。

{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}

object (FuelPrice)

このステーションにある燃料タイプごとの、最後に確認された燃料価格。このステーションの燃料タイプごとに 1 つのエントリがあります。順序は重要ではありません。

{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}

enum (FuelType)

燃料の種類。

object (Money)

燃料の価格。

string (Timestamp format)

燃料価格が最後に更新された時刻。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

string

ISO 4217 で定義されている 3 文字の通貨コード。

string (int64 format)

金額の整数部分。たとえば、currencyCode が "USD" の場合、1 単位は 1 米ドルです。

integer

金額の小数部分をナノ（10^-9）単位で表した数。値は -999,999,999 以上 +999,999,999 以下でなければなりません。units が正の場合、nanos には正数または 0 を指定します。units がゼロの場合、nanos には正数、0、または負数を指定できます。units が負の場合、nanos は負数または 0 を指定します。たとえば、$-1.75 は units = -1、nanos = -750,000,000 と表されます。

{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}

integer

このステーションのコネクタの数。ただし、一部のポートは複数のコネクタを備えていても、一度に 1 台の車しか充電できないため（たとえば）、コネクタの数が、同時に充電できる自動車の総数よりも多くなることがあります。

object (ConnectorAggregation)

同じタイプ、同じ充電率のコネクタを含む EV 充電コネクタの集約リスト。

{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}

enum (EVConnectorType)

この集計のコネクタタイプ。

number

集計における各コネクタの静的な最大充電速度（キロワット単位）。

integer

この集約内のコネクタの数。

string (Timestamp format)

この集計のコネクタの可用性情報が最後に更新されたときのタイムスタンプ。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。

integer

この集約で現在利用可能なコネクタの数。

integer

この集約内で現在稼働していないコネクタの数。

{
  "overview": {
    object (LocalizedText)
  },
  "description": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}

object (LocalizedText)

場所の概要です。

object (LocalizedText)

場所の詳細な説明です。

object (References)

概要説明の生成に使用される参照。

{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}

object (Review)

参考になるレビュー。

string

参照先の場所のリソース名のリスト。この名前は、プレイス リソース名を受け入れる他の API で使用できます。

{
  "contentBlocks": [
    {
      object (ContentBlock)
    }
  ]
}

object (ContentBlock)

エリアの概要を構成するコンテンツ ブロック。各ブロックには、その地域に関する個別のトピックがあります。

{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}

string

コンテンツのトピック（「概要」など）検索します

object (LocalizedText)

トピックに関連するコンテンツ。

object (References)

試験運用版: 詳しくは、https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。

このコンテンツ ブロックに関連する参照。