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)
  },
  "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} 形式）。Place の検索に使用できます。

string

場所の一意の識別子。

object (LocalizedText)

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

string

この結果に対するタイプタグのセット。例: 「political」や「locality」。使用可能な値の一覧については、https://developers.google.com/maps/documentation/places/web-service/place-types の表 A と表 B をご覧ください。

string

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

object (LocalizedText)

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

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

場所の住所（adr microformat: http://microformats.org/wiki/adr）。

enum (BusinessStatus)

場所のビジネス ステータスです。

enum (PriceLevel)

場所の価格レベル。

object (Attribution)

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

string

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

string

icon_mask の背景色（16 進数形式）（例: #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 充電オプションに関する情報。

integer

この場所のタイムゾーンの UTC からのオフセット（分）数。時間の小数点でオフセットされるタイムゾーンをサポートするため、分単位で表現されます（例: 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

住所コンポーネントの完全な説明または名前。たとえば、オーストラリアの住所コンポーネントに「Australia」という long_name が含まれているとします。

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)

このお店が営業している時間帯です。期間は、プレイス ローカルのタイムゾーンで日曜日から始まる、時系列で表示されます。値が空（ただし空ではない）は、改装のため一時的に閉鎖されているなど、決して営業していない場所を示します。

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

このエンドポイントが切り捨てられたかどうか。実際の営業時間が、指定された営業時間外に切り捨てられるため、これらの境界に合わせて切り詰められます。これにより、リクエスト日の午前 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 ～ 12 にする必要があります。月と日のない年を指定するには 0 にする必要があります。

integer

日。その年と月に対して有効な 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

Place はクレジット カードでのお支払いに対応しています。

boolean

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

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 は正、ゼロ、負の値のいずれかになります。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

この集計で現在使用されていないコネクタの数。