REST Resource: places

リソース: 場所

プレイスを表すすべての情報。

JSON 表現 
{
  "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)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "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)
  },
  "pureServiceAreaBusiness": boolean
}
フィールド
name

string

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

string

プレイスの一意の識別子。
displayName

object (LocalizedText)

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

string

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

string

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

object (LocalizedText)

メインタイプの表示名（該当する場合はリクエスト言語にローカライズ）。使用可能な値の一覧については、https://developers.google.com/maps/documentation/places/web-service/place-types の表 A と表 B をご覧ください。
nationalPhoneNumber

string

プレイスの電話番号（国内形式）。
internationalPhoneNumber

string

プレイスの電話番号（国際形式）。
formattedAddress

string

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

string

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

object (AddressComponent)

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

object (PlusCode)

場所の緯度/経度の plus code。
location

object (LatLng)

この場所の位置。
viewport

object (Viewport)

平均サイズの地図にプレイスを表示するのに適したビューポート。このビューポートは、ビジネスの物理的な境界やサービス提供エリアとして使用しないでください。
rating

number

この場所のユーザー レビューに基づく 1.0 ～ 5.0 の評価。
googleMapsUri

string

この場所の詳細情報を提供する URL。
websiteUri

string

この場所の公式ウェブサイト（ビジネスのホームページなど）。チェーンに属する場所（IKEA 店舗など）の場合は、通常、チェーン全体ではなく個々の店舗のウェブサイトを指定します。
reviews[]

object (Review)

この場所に関するクチコミのリスト（関連性の高い順に並べ替え）。返されるレビューは最大 5 件です。
regularOpeningHours

object (OpeningHours)

通常の営業時間。場所が年中無休（24 時間営業）の場合は、close フィールドは設定されません。[open][google.foo.OpeningHours.Period.open] 期間に値が 0 の [day][google.foo.Point.day]、値が 0 の [hour][google.foo.Point.hour]、値が 0 の [minute][google.foo.Point.minute] が含まれており、 が含まれていなければ、年中無休であると判断できます。
photos[]

object (Photo)

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

string

場所の住所（adr マイクロフォーマット）: http://microformats.org/wiki/adr。
businessStatus

enum (BusinessStatus)

場所の営業状況。
priceLevel

enum (PriceLevel)

場所の価格帯。
attributions[]

object (Attribution)

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

string

アイコン マスクへの URL の切り捨て。ユーザーは、タイプ サフィックス（「.svg」や「.png」など）を末尾に追加することで、さまざまなアイコンタイプにアクセスできます。
iconBackgroundColor

string

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

object (OpeningHours)

次の 7 日間（本日を含む）の営業時間。期間はリクエストの日付の午前 0 時から 6 日後の午後 11 時 59 分までです。このフィールドには、特別な営業時間がある日付に設定された、すべての営業時間の specialDays サブフィールドが含まれます。
currentSecondaryOpeningHours[]

object (OpeningHours)

ビジネスの営業時間に関する情報など、今後 7 日間のエントリの配列が含まれます。副業は、ビジネスのメインの営業時間とは異なります。たとえば、レストランはドライブスルーの時間帯やデリバリーの時間帯を 2 番目の営業時間として指定できます。このフィールドには、type サブフィールドが入力されます。このサブフィールドには、場所のタイプに基づいて、営業時間のタイプ（DRIVE_THROUGH、PICKUP、TAKEOUT など）の事前定義済みリストから値が取得されます。このフィールドには、特別な営業時間がある日付に設定された、すべての営業時間の specialDays サブフィールドが含まれます。
regularSecondaryOpeningHours[]

object (OpeningHours)

ビジネスの通常の第 2 営業時間に関する情報のエントリの配列が含まれます。副業は、ビジネスのメインの営業時間とは異なります。たとえば、レストランはドライブスルーの時間帯やデリバリーの時間帯を 2 番目の営業時間として指定できます。このフィールドに、営業時間の種類のサブフィールドが入力されます。このサブフィールドには、場所の種類に基づいて、事前定義された営業時間の種類のリスト（DRIVE_THROUGH、PICKUP、TAKEOUT など）から値が取得されます。
editorialSummary

object (LocalizedText)

場所の概要が含まれています。概要はテキストによる概要で構成され、該当する場合は言語コードも含まれます。概要テキストは現状のまま表示する必要があり、変更や改変はできません。
paymentOptions

object (PaymentOptions)

施設で利用できるお支払い方法。お支払い方法のデータが利用できない場合は、お支払い方法のフィールドが設定解除されます。
parkingOptions

object (ParkingOptions)

スポットで提供されている駐車場のオプション。
subDestinations[]

object (SubDestination)

プレイスに関連するサブ デスティネーションのリスト。
fuelOptions

object (FuelOptions)

ガソリンスタンドで利用できる燃料に関する最新情報。この情報は定期的に更新されます。
evChargeOptions

object (EVChargeOptions)

電気自動車の充電オプションに関する情報。
generativeSummary

object (GenerativeSummary)

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

場所の AI 生成の概要。
areaSummary

object (AreaSummary)

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

場所が存在する地域の AI 生成の概要。
containingPlaces[]

object (ContainingPlace)

現在の場所が含まれる場所のリスト。
addressDescriptor

object (AddressDescriptor)

場所の住所記述子。住所記述子には、ランドマークやエリアを使用して場所を説明するのに役立つ追加情報が含まれます。住所記述子の地域別の対応状況については、https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage をご覧ください。
priceRange

object (PriceRange)

場所に関連付けられた価格帯。
utcOffsetMinutes

integer

プレイスの現在のタイムゾーンに対する UTC からのオフセット値（分単位）。分単位で表されます。これにより、X 時間 15 分などの時間の端数があるタイムゾーンに対応できます。
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)

場所で利用できるユーザー補助オプションに関する情報。
pureServiceAreaBusiness

boolean

場所が純粋な非店舗型ビジネスかどうかを示します。純粋な非店舗型ビジネスは、客先に出向いてサービスを提供し、ビジネス拠点の住所では接客しないビジネスです。清掃サービスや配管工事などのビジネスが該当します。これらのビジネスには、Google マップに物理的な住所や所在地が登録されていない場合があります。

LocalizedText

特定の言語のテキストのローカライズされたバリエーション。

JSON 表現 
{
  "text": string,
  "languageCode": string
}
フィールド
text

string

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

string

テキストの BCP-47 言語コード（「en-US」や「sr-Latn」など）。

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

AddressComponent

住所の表示形式を構成する構造化コンポーネント（この情報が利用可能な場合）。

JSON 表現 
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
フィールド
longText

string

住所コンポーネントの完全な説明や名前です。たとえば、オーストラリアの国の国名コンポーネントの long_name は「Australia」になります。
shortText

string

住所コンポーネントの略称です（略称がある場合）。たとえば、オーストラリアの国を表す住所コンポーネントの short_name は「AU」になります。
types[]

string

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

string

このコンポーネントの書式設定に使用される言語（CLDR 表記）。

PlusCode

Plus Code（http://plus.codes）は、2 つの形式の場所の参照情報です。14 m x 14 m（8000 分の 1）以下の長方形を定義するグローバル コードと、プレフィックスを参照地に置き換えた複合コードです。

JSON 表現 
{
  "globalCode": string,
  "compoundCode": string
}
フィールド
globalCode

string

場所のグローバル（完全）コード（「9FWM33GV+HQ」など）。8000 分の 1 x 8000 分の 1 度（約 14 メートル x 14 メートル）のエリアを表します。
compoundCode

string

場所の複合コード（「33GV+HQ, Ramberg, Norway」など）。グローバル コードの接尾辞が含まれ、接頭辞は参照エンティティの形式付きの名前に置き換えられています。

LatLng

緯度と経度のペアを表すオブジェクト。これは緯度を表す倍精度値と経度を表す倍精度値のペアで表現されます。特に明記されていない場合、このオブジェクトは WGS84 規格に準拠する必要があります。値は正規化範囲内で指定する必要があります。

JSON 表現 
{
  "latitude": number,
  "longitude": number
}
フィールド
latitude

number

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

number

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

ビューポート

緯度と経度のビューポート。対角線上の 2 つの low ポイントと high ポイントで表されます。ビューポートは閉じた領域と見なされます。つまり、境界が含まれます。緯度の範囲は -90 ～ 90 度、経度の範囲は -180 ～ 180 度の範囲内で指定する必要があります。さまざまなケースには次のようなものがあります。

  • low = high の場合、ビューポートは単一のポイントで構成されます。

  • low.longitude > high.longitude の場合、経度の範囲が反転します（ビューポートが経度 180 度線を越えます）。

  • low.longitude = -180 度、high.longitude = 180 度の場合、ビューポートにはすべての経度が含まれます。

  • low.longitude = 180 度、high.longitude = -180 度の場合、経度の範囲は空になります。

  • low.latitude > high.latitude の場合、緯度範囲は空になります。

low と high の両方に値を入力する必要があります。また、（上記の定義で指定されているように）表されるボックスを空にすることはできません。ビューポートが空の場合、エラーが発生します。

たとえば、このビューポートはニューヨーク市を完全に囲んでいます。

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON 表現 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
フィールド
low

object (LatLng)

必須。ビューポートの低い部分。
high

object (LatLng)

必須。ビューポートの高さ。

確認

場所のレビューに関する情報。

JSON 表現 
{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string,
  "flagContentUri": string,
  "googleMapsUri": string
}
フィールド
name

string

このスポットのクチコミを表す参照。このスポットのクチコミを再度検索するために使用できます（API の「リソース」名: places/{placeId}/reviews/{review}）。
relativePublishTimeDescription

string

書式設定された最近の時点の文字列。レビューの時点を現在の時刻と比較して、言語と国に適した形式で表します。
text

object (LocalizedText)

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

object (LocalizedText)

レビューのテキスト（元の言語）。
rating

number

1.0 ～ 5.0 の数値（星の数）。
authorAttribution

object (AuthorAttribution)

このレビューの投稿者。
publishTime

string (Timestamp format)

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

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

string

ユーザーがレビューに関する問題を報告できるリンク。
googleMapsUri

string

Google マップでクチコミを表示するためのリンク。

AuthorAttribution

UGC データの作成者に関する情報。Photo と Review で使用。

JSON 表現 
{
  "displayName": string,
  "uri": string,
  "photoUri": string
}
フィールド
displayName

string

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

string

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

string

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

OpeningHours

場所の営業時間に関する情報。

JSON 表現 
{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "nextOpenTime": string,
  "nextCloseTime": string,
  "openNow": boolean
}
フィールド
periods[]

object (Period)

1 週間のうち、この場所が営業している期間。期間は、場所のローカル タイムゾーンの日曜日から時系列で指定します。値が空（ただし存在する）場合は、改装のため臨時休業中など、営業していない場所を示します。
weekdayDescriptions[]

string

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

enum (SecondaryHoursType)

副業時間のタイプを識別するために使用されるタイプ文字列。
specialDays[]

object (SpecialDay)

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

string (Timestamp format)

現在の営業時間の次の開始日（最大 7 日後）。このフィールドには、リクエストの処理時に営業時間の期間が有効でない場合のみ値が入力されます。

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

string (Timestamp format)

現在の営業時間の終了日（最大 7 日後）。このフィールドには、リクエストの処理時に営業時間帯が有効な場合にのみ値が入力されます。

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

boolean

営業時間の期間が現在有効かどうか。通常の営業時間と現在の営業時間の場合、このフィールドは営業しているかどうかを示します。サブ営業時間と現在のサブ営業時間の場合、このフィールドは、この場所のサブ営業時間が有効かどうかを示します。

期間

スポットが openNow ステータスのままになる期間。

JSON 表現 
{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}
フィールド
open

object (Point)

営業を開始する時間。
close

object (Point)

閉店が開始される時刻。

ポイント

ステータス変更ポイント。

JSON 表現 
{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}
フィールド
date

object (Date)

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

boolean

このエンドポイントが切り捨てられたかどうか。切り捨てが発生するのは、実際の時間が、返すことができる時間の範囲外にある場合です。その場合は、時間の範囲内に切り捨てられます。これにより、リクエストの日付の午前 0 時から 24 時間以内のデータが返されます。
day

integer

0 ～ 6 の整数で表される曜日。0 は日曜日、1 は月曜日、など
hour

integer

24 時間形式の時刻。範囲は 0 ～ 23 です。
minute

integer

分。範囲は 0 ～ 59 です。

日付

誕生日などのように、カレンダーの日付全体またはその一部を表します。時間帯とタイムゾーンは、他の場所で指定されているか、重要ではありません。日付はグレゴリオ暦を基準にしています。これは次のいずれかを表します。

  • ゼロ以外の年、月、日の値を含む完全な日付。
  • 年の値がゼロである月と日（記念日など）。
  • 月と日の値がゼロである単独の年。
  • 日がゼロである年と月（クレジット カードの有効期限など）

関連するタイプ:

JSON 表現 
{
  "year": integer,
  "month": integer,
  "day": integer
}
フィールド
year

integer

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

integer

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

integer

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

SecondaryHoursType

副業時間の種類を識別するために使用されるタイプ。

列挙型
SECONDARY_HOURS_TYPE_UNSPECIFIED 2 番目の時間帯のタイプが指定されていない場合のデフォルト値。
DRIVE_THROUGH 銀行、レストラン、薬局の営業時間。
HAPPY_HOUR ハッピーアワー。
DELIVERY 配達時間。
TAKEOUT テイクアウトの営業時間。
KITCHEN キッチンの時間。
BREAKFAST 朝食の時間。
LUNCH 昼休み。
DINNER 夕食の時間。
BRUNCH ブランチの時間帯。
PICKUP 集荷時間。
ACCESS 保管場所の利用時間。
SENIOR_HOURS シニア向けの特別営業時間。
ONLINE_SERVICE_HOURS オンライン サービスの提供時間。

SpecialDay

返された営業時間の範囲内にある特別な日の構造化情報。特別な日とは、クリスマスなど、場所の営業時間に影響する可能性がある日です。

JSON 表現 
{
  "date": {
    object (Date)
  }
}
フィールド
date

object (Date)

この特別な日の日付。

写真

場所の写真に関する情報。

JSON 表現 
{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ],
  "flagContentUri": string,
  "googleMapsUri": string
}
フィールド
name

string

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

integer

使用可能な最大幅（ピクセル単位）。
heightPx

integer

使用可能な最大高さ（ピクセル単位）。
authorAttributions[]

object (AuthorAttribution)

この写真の作成者。
flagContentUri

string

写真に関する問題を報告できるリンク。
googleMapsUri

string

Google マップに写真を表示するためのリンク。

BusinessStatus

場所の営業状況。

列挙型
BUSINESS_STATUS_UNSPECIFIED デフォルト値。この値は使用されません。
OPERATIONAL 営業中である。現在営業中とは限らない。
CLOSED_TEMPORARILY 施設は臨時休業中です。
CLOSED_PERMANENTLY 施設が閉業している。

PriceLevel

場所の価格帯。

列挙型
PRICE_LEVEL_UNSPECIFIED 場所の料金レベルが指定されていないか不明です。
PRICE_LEVEL_FREE 場所が無料サービスを提供している。
PRICE_LEVEL_INEXPENSIVE 低価格のサービスを提供している。
PRICE_LEVEL_MODERATE 手頃な価格でサービスを提供している場所。
PRICE_LEVEL_EXPENSIVE 高額なサービスを提供している。
PRICE_LEVEL_VERY_EXPENSIVE 非常に高価なサービスを提供している場所。

アトリビューション

この場所のデータ プロバイダに関する情報。

JSON 表現 
{
  "provider": string,
  "providerUri": string
}
フィールド
provider

string

プレイスのデータ プロバイダの名前。
providerUri

string

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

PaymentOptions

施設で利用できるお支払い方法。

JSON 表現 
{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}
フィールド
acceptsCreditCards

boolean

クレジット カードによる支払いを受け付けている場所。
acceptsDebitCards

boolean

デビットカードによる支払いが可能です。
acceptsCashOnly

boolean

支払い方法として現金のみが利用できます。この属性が設定されている場所でも、他のお支払い方法を受け付けている場合があります。
acceptsNfc

boolean

店舗で NFC 決済が利用可能。

ParkingOptions

場所の駐車オプションに関する情報。駐車場は複数のオプションを同時にサポートできます。

JSON 表現 
{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
フィールド
freeParkingLot

boolean

駐車場が無料。
paidParkingLot

boolean

有料駐車場あり。
freeStreetParking

boolean

路上駐車場が無料です。
paidStreetParking

boolean

有料の路上駐車場あり。
valetParking

boolean

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

boolean

屋内駐車場を無料で利用できます。
paidGarageParking

boolean

有料の屋内駐車場を利用できます。

SubDestination

場所のリソース名と、その場所に関連するサブデスティネーションの ID。たとえば、ターミナルは空港内の異なるデスティネーションです。

JSON 表現 
{
  "name": string,
  "id": string
}
フィールド
name

string

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

string

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

AccessibilityOptions

場所で利用できるユーザー補助オプションに関する情報。

JSON 表現 
{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}
フィールド
wheelchairAccessibleParking

boolean

車椅子対応の駐車場がある。
wheelchairAccessibleEntrance

boolean

車椅子対応の入り口がある。
wheelchairAccessibleRestroom

boolean

車椅子対応のトイレがある。
wheelchairAccessibleSeating

boolean

車椅子対応の座席がある。

FuelOptions

ガソリンスタンドで利用できる燃料に関する最新情報。この情報は定期的に更新されます。

JSON 表現 
{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}
フィールド
fuelPrices[]

object (FuelPrice)

このガソリンスタンドで提供されている各種類の燃料の直近の価格。ガソリンスタンドに設置されている燃料の種類ごとに 1 つのエントリがあります。順序は重要ではありません。

FuelPrice

特定の種類の燃料価格情報。

JSON 表現 
{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}
フィールド
type

enum (FuelType)

燃料の種類。
price

object (Money)

燃料の価格。
updateTime

string (Timestamp format)

ガソリン価格が最後に更新された日時。

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

FuelType

燃料の種類。

列挙型
FUEL_TYPE_UNSPECIFIED 燃料の種類が指定されていません。
DIESEL ディーゼル燃料。
REGULAR_UNLEADED レギュラー無鉛。
MIDGRADE 中間グレード。
PREMIUM Premium
SP91 SP 91。
SP91_E10 SP 91 E10。
SP92 SP 92。
SP95 SP 95。
SP95_E10 SP95 E10。
SP98 SP 98。
SP99 SP 99。
SP100 SP 100。
LPG LPG。
E80 E 80。
E85 E 85.
METHANE メタン。
BIO_DIESEL バイオディーゼル。
TRUCK_DIESEL トラックのディーゼル。

Money

金額をその通貨タイプで表します。

JSON 表現 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
フィールド
currencyCode

string

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

string (int64 format)

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

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 と表されます。

EVChargeOptions

プレイス内にホストされている EV 充電スタンドに関する情報。用語は https://afdc.energy.gov/fuels/electricity_infrastructure.html に準拠しています。1 つのポートで一度に 1 台の車を充電できます。1 つのポートには 1 つ以上のコネクタがあります。1 つの充電スタンドには 1 つ以上のポートがあります。

JSON 表現 
{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}
フィールド
connectorCount

integer

この駅のコネクタの数。ただし、ポートによっては複数のコネクタがあっても、一度に充電できる車が 1 台のみの場合があるため、コネクタの数は、同時に充電できる車の合計数より多い場合があります。
connectorAggregation[]

object (ConnectorAggregation)

同じタイプと同じ充電レートのコネクタを含む EV 充電コネクタの集計リスト。

ConnectorAggregation

[type、maxChargeRateKw] でグループ化された EV 充電情報。同じタイプで最大充電率が同じコネクタの EV 充電の集計値（kW）が表示されます。

JSON 表現 
{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}
フィールド
type

enum (EVConnectorType)

この集計の接続タイプ。
maxChargeRateKw

number

集約内の各コネクタの静的最大充電率（kW）。
count

integer

この集計内のコネクタ数。
availabilityLastUpdateTime

string (Timestamp format)

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

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

integer

この集計で現在使用可能なコネクタの数。
outOfServiceCount

integer

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

EVConnectorType

電気自動車の充電コネクタの種類の詳細については、http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 をご覧ください。

列挙型
EV_CONNECTOR_TYPE_UNSPECIFIED コネクタが指定されていません。
EV_CONNECTOR_TYPE_OTHER その他のコネクタの種類。
EV_CONNECTOR_TYPE_J1772 J1772 タイプ 1 コネクタ。
EV_CONNECTOR_TYPE_TYPE_2 IEC 62196 タイプ 2 コネクタ。MENNEKES とも呼ばれます。
EV_CONNECTOR_TYPE_CHADEMO CHAdeMO タイプのコネクタ。
EV_CONNECTOR_TYPE_CCS_COMBO_1 充電システム（AC と DC）。SAE に基づく。Type-1 J-1772 コネクタ
EV_CONNECTOR_TYPE_CCS_COMBO_2 充電システム（AC と DC）。Type-2 Mennekes コネクタに基づく
EV_CONNECTOR_TYPE_TESLA 汎用 TESLA コネクタ。これは北米では NACS ですが、世界中の他の地域では NACS 以外（CCS Combo 2（CCS2）や GB/T など）である場合があります。この値は、実際のコネクタタイプを表すというよりは、テスラ所有の充電スタンドでテスラ ブランドの車両を充電できるかどうかを表します。
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T GB/T タイプは、中国の GB/T 規格に対応しています。このタイプはすべての GB_T タイプに対応しています。
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET コンセントの種類が不明。

GenerativeSummary

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

場所の AI 生成の概要。

JSON 表現 
{
  "overview": {
    object (LocalizedText)
  },
  "overviewFlagContentUri": string,
  "description": {
    object (LocalizedText)
  },
  "descriptionFlagContentUri": string,
  "references": {
    object (References)
  }
}
フィールド
overview

object (LocalizedText)

場所の概要。
overviewFlagContentUri

string

ユーザーが問題を報告できるリンク（概要の要約が表示されます）。
description

object (LocalizedText)

場所の詳細な説明。
descriptionFlagContentUri

string

ユーザーが問題を報告し、説明の概要を入力できるリンク。
references

object (References)

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

参照

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

生成コンテンツが関連付けられている参照。

JSON 表現 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}
フィールド
reviews[]

object (Review)

参照として使用できるレビュー。
places[]

string

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

AreaSummary

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

場所が存在する地域の AI 生成の概要。

JSON 表現 
{
  "contentBlocks": [
    {
      object (ContentBlock)
    }
  ],
  "flagContentUri": string
}
フィールド
contentBlocks[]

object (ContentBlock)

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

string

ユーザーが概要に関する問題を報告できるリンク。

ContentBlock

個別に配信できるコンテンツのブロック。

JSON 表現 
{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
フィールド
topic

string

コンテンツのトピック（「概要」や「レストラン」など）。
content

object (LocalizedText)

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

object (References)

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

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

ContainingPlace

この場所が存在する場所に関する情報。

JSON 表現 
{
  "name": string,
  "id": string
}
フィールド
name

string

この場所が属する場所のリソース名。
id

string

この場所が属するプレイス ID。

AddressDescriptor

場所の関連する説明。近くのランドマークと正確な包含エリアのランキング セットと、ターゲット ロケーションとの関係が含まれます。

JSON 表現 
{
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "areas": [
    {
      object (Area)
    }
  ]
}
フィールド
landmarks[]

object (Landmark)

近くのランドマークのランキング リスト。最も認識しやすい近くのランドマークが最初にランク付けされます。
areas[]

object (Area)

含まれるエリアまたは隣接するエリアのランキング リスト。最も認識しやすく正確なエリアが最初にランク付けされます。

ランドマーク

ランドマークの基本情報と、ランドマークとターゲット ロケーションの関係。

ランドマークとは、場所を説明するために使用できる目立つ場所です。

JSON 表現 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "spatialRelationship": enum (SpatialRelationship),
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number
}
フィールド
name

string

ランドマークのリソース名。
placeId

string

ランドマークの Place ID。
displayName

object (LocalizedText)

ランドマークの表示名。
types[]

string

このランドマークのタイプタグのセット。使用可能な値の一覧については、https://developers.google.com/maps/documentation/places/web-service/place-types をご覧ください。
spatialRelationship

enum (SpatialRelationship)

ターゲット ロケーションとランドマーク間の空間関係を定義します。
straightLineDistanceMeters

number

ターゲットの中心点とランドマークの中心点間の直線距離（メートル単位）。状況によっては、この値が travelDistanceMeters より長くなることがあります。
travelDistanceMeters

number

ターゲットからランドマークまでの道路網上の移動距離（メートル単位）（既知の場合）。この値は、徒歩、車、自転車などの移動手段は考慮していません。

SpatialRelationship

ターゲット ロケーションとランドマーク間の空間関係を定義します。

列挙型
NEAR 以下に具体的な関係がない場合、これがデフォルトの関係になります。
WITHIN ランドマークに空間ジオメトリがあり、ターゲットがその境界内にある。
BESIDE ターゲットがランドマークに直接隣接している。
ACROSS_THE_ROAD ターゲットが道路の反対側にあるランドマークの真向かいにある場合。
DOWN_THE_ROAD ランドマークと同じ経路上にあるが、隣接していない、または向かい側にない。
AROUND_THE_CORNER ランドマークと同じルート上ではないが、1 回曲がれば到達できる場所。
BEHIND ランドマークの構造物に近いが、道路の入口からは遠い。

地域

エリア情報と、そのエリアとターゲット ロケーションの関係。

エリアには、場所の説明に役立つ正確な地域の下位区分、近隣地域、大規模な複合施設が含まれます。

JSON 表現 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "containment": enum (Containment)
}
フィールド
name

string

エリアのリソース名。
placeId

string

エリアの Place ID。
displayName

object (LocalizedText)

エリアの表示名。
containment

enum (Containment)

対象の場所とエリア間の空間関係を定義します。

封じ込め

対象の場所とエリア間の空間関係を定義します。

列挙型
CONTAINMENT_UNSPECIFIED 制限は指定されていません。
WITHIN ターゲット ロケーションがエリア内の中央付近にある。
OUTSKIRTS ターゲット ロケーションがエリア領域内にあり、端に近い。
NEAR 対象の場所はエリアの外部にあるが、近くにある。

PriceRange

場所に関連付けられた価格帯。endPrice は未設定にすることもできます。この場合、上限のない範囲を指定します（例: 「$100 超」）。

JSON 表現 
{
  "startPrice": {
    object (Money)
  },
  "endPrice": {
    object (Money)
  }
}
フィールド
startPrice

object (Money)

価格帯の下限（両端を含む）。価格はこの金額以上である必要があります。
endPrice

object (Money)

価格帯の上限（この値は含まれません）。価格はこの金額より低くする必要があります。

メソッド

autocomplete

 指定された入力の予測を返します。

get

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

searchNearby

 場所の近くの場所を検索する。

searchText

 テキストクエリに基づく場所の検索。