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,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "timeZone": {
    object (TimeZone)
  },
  "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)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "reviewSummary": {
    object (ReviewSummary)
  },
  "evChargeAmenitySummary": {
    object (EvChargeAmenitySummary)
  },
  "neighborhoodSummary": {
    object (NeighborhoodSummary)
  },
  "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

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

object (PostalAddress)

郵便住所形式の住所。
addressComponents[]

object (AddressComponent)

地域レベルごとに繰り返されるコンポーネント。addressComponents[] 配列については、次の点に注意してください。- 住所コンポーネントの配列には、フォーマット済み住所よりも多くのコンポーネントが含まれている場合があります。- この配列には、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 フィールドは設定されません。クライアントは、day（値 0）、hour（値 0）、minute（値 0）を含む open 期間が年中無休（24 時間）を表すことを前提としています。
timeZone

object (TimeZone)

IANA タイムゾーン データベースのタイムゾーン。例: 「America/New_York」。
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 日間のエントリの配列が含まれます。副業は、ビジネスのメインの営業時間とは異なります。たとえば、レストランはドライブスルーの時間帯やデリバリーの時間帯を副業時間として指定できます。このフィールドに、営業時間の種類のサブフィールドが入力されます。このサブフィールドは、場所の種類に基づいて、事前定義された営業時間の種類のリスト（DRIVE_THROUGH、PICKUP、TAKEOUT など）から取得されます。このフィールドには、特別な営業時間がある日付に設定された、すべての営業時間の specialDays サブフィールドが含まれます。
regularSecondaryOpeningHours[]

object (OpeningHours)

ビジネスの通常の第 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)

場所の AI 生成の概要。
containingPlaces[]

object (ContainingPlace)

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

object (AddressDescriptor)

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

object (PriceRange)

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

object (ReviewSummary)

ユーザー レビューを使用して AI が生成した場所の概要。
evChargeAmenitySummary

object (EvChargeAmenitySummary)

EV 充電スタンド付近の設備の概要。
neighborhoodSummary

object (NeighborhoodSummary)

場所の近くにあるスポットの概要。
utcOffsetMinutes

integer

この場所のタイムゾーンが現在 UTC からずれている分数。分単位で表記され、X 時間 15 分など、1 時間未満のオフセットがあるタイムゾーンをサポートします。
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 をご覧ください。

PostalAddress

配送先住所やお支払い先住所などの住所を表します。この住所が指定されていれば、建物や私書箱などへの郵送が可能になります。これは地理的な場所（道路、町、山）を指し示すものではありません。

一般的な使用法では、住所を作成するにはユーザー入力や既存データのインポートなどの方法がプロセスに応じて使用されます。

住所の入力または編集に関するアドバイス: - 国際化対応の住所ウィジェット（https://github.com/google/libaddressinput など）を使用してください。- 特定の国で使用されるフィールドの入力または編集用の UI 要素は、その国以外のユーザーには表示しないでください。

このスキーマの使用方法の詳細については、https://support.google.com/business/answer/6397478 をご覧ください。

JSON 表現 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
フィールド
revision

integer

PostalAddress のスキーマ リビジョン。最新のリビジョンである 0 に設定する必要があります。

新しいリビジョンはすべて、古いリビジョンと下位互換性があることが必要です。
regionCode

string

必須。住所の国 / 地域に対応する CLDR 地域コード。この値は推測されることはなく、正確な値が確保されるかどうかはユーザー次第です。詳細については、https://cldr.unicode.org/ と https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html をご覧ください。例: スイスの場合は「CH」。
languageCode

string

省略可。この住所の表記に使われている BCP-47 言語コード（わかっている場合）。多くの場合、これは入力フォームの UI 言語です。あるいは、住所の国や地域で使用されているいずれかの言語、またはそれらの言語を音訳したものと一致する場合もあります。これは特定の国で住所のフォーマットに影響する可能性がありますが、データの正確性にとっては重要でなく、検証やその他のフォーマット関連以外の操作には影響しません。

この値が不明な場合は省略してください（間違っている可能性があるデフォルトは指定しないでください）。

例: 「zh-Hant」、「ja」、「ja-Latn」、「en」。
postalCode

string

省略可。住所の郵便番号。すべての国で郵便番号の使用や存在を必要としているわけではありませんが、使用されている場合は、住所の他の部分で追加の確認が行われることがあります（例: 米国での州 / 郵便番号の確認）。
sortingCode

string

省略可。追加の国固有の並べ替えコード。ほとんどの地域では、これは使用されていません。使用される場合、値は「CEDEX」などの文字列で、必要に応じて数字が続く場合もあります（「CEDEX 7」など）。または、単なる数字で、「セクター コード」（ジャマイカ）、「配達エリア インジケーター」（マラウイ）、「郵便局インジケーター」（コートジボアール）を表します。
administrativeArea

string

省略可。その国 / 地域の住所に使用される最上位の行政区域。たとえば、州、省、都道府県などがこれに該当します。スペインの場合であれば自治州ではなく県になります（例:「カタルーニャ」ではなく「バルセロナ」）。州や県などの行政区画が住所表記に使用されない国もあります。たとえば、スイスではこの項目を空のままにします。
locality

string

省略可。通常は住所の市区町村の部分を指します。たとえば、米国の市、イタリアのコムーネ、英国の郵便町名などがこれに該当します。地域区分が明確に定義されていない地域や、この体系が当てはまらない地域では、locality を空にして addressLines を使用します。
sublocality

string

省略可。住所の市町村部分の下位の区画。たとえば、字、特別区、地区などがこれに該当します。
addressLines[]

string

住所の下位部分を記述する非構造化の住所行。

addressLines の値は型情報を持たず、1 つのフィールドに複数の値が含まれることがあるため（「Austin, TX」など）、行の順序を明確にすることが重要です。所在地の行の順序は、その住所の国や地域での「あて名書きの順序」にしてください。あて名書きの順序が一定でない地域（日本など）では、address_language を使用して、順序を明示します（例: 順序が大区分から小区分の場合は "ja"、小区分から大区分の場合は "ja-Latn" や "en"）。こうすることで、住所の最も細かな部分を表す行を言語に基づいて選択できます。

住所として認められる最小限の体系化表現は、regionCode と addressLines（regionCode 以外の全情報を含む）で構成されます。そのような住所を、ジオコーディングなしできわめて正確に近く書式設定することも可能ですが、住所の構成要素についての意味的な推論は、少なくとも部分的に解決されるまでは不可能です。

まったく構造化されていない住所を扱うときは、regionCode と addressLines だけで構成される住所を作成してからジオコーディングすることが、おすすめの方法です（住所のどの部分が最上位の行政区画で、どれがその下の地域区画かを推測するのではなく）。
recipients[]

string

省略可。その住所で受け取る人。このフィールドには、場合によっては複数の情報を含めることができます。たとえば、「様方」情報が含まれる場合があります。
organization

string

省略可。その住所にある組織の名前。

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)

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

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
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 日後）。このフィールドには、リクエストの処理時に営業時間の期間が有効でない場合のみ値が入力されます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
nextCloseTime

string (Timestamp format)

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

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
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)

この特別な日の日付。

TimeZone

IANA タイムゾーン データベースのタイムゾーンを表します。

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

string

IANA タイムゾーン データベースのタイムゾーン。例: 「America/New_York」。
version

string

省略可。IANA タイムゾーン データベースのバージョン番号。例: 「2019a」。

写真

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

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 と場所リソース名は、その後の Place Details（新規）リクエストで使用して、サブデスティネーションの表示名や位置情報など、より詳細な情報を取得できます。

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)

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

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

FuelType

燃料の種類。

列挙型
FUEL_TYPE_UNSPECIFIED 燃料の種類が指定されていません。
DIESEL ディーゼル燃料。
DIESEL_PLUS ディーゼルと燃料。
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 液化石油ガス。
E80 E 80。
E85 E 85.
E100 E 100.
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)

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

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
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 コンセントの種類が不明。
EV_CONNECTOR_TYPE_NACS North American Charging System（NACS）: SAE J3400 として標準化されています。

GenerativeSummary

場所の AI 生成の概要。

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

object (LocalizedText)

場所の概要。
overviewFlagContentUri

string

概要の概要で問題を報告できるリンク。
disclosureText

object (LocalizedText)

AI 開示メッセージ「Gemini による要約」（およびローカライズされたバリエーション）。リクエストで指定された言語（利用可能な場合）で返されます。

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)

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

ReviewSummary

ユーザー レビューを使用して AI が生成した場所の概要。

JSON 表現 
{
  "text": {
    object (LocalizedText)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
フィールド
text

object (LocalizedText)

ユーザー レビューの概要。
flagContentUri

string

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

object (LocalizedText)

AI 開示メッセージ「Gemini による要約」（およびローカライズされたバリエーション）。リクエストで指定された言語（利用可能な場合）で返されます。

EvChargeAmenitySummary

EV 充電スタンド付近の設備の概要。これは、タイプが electric_vehicle_charging_station のプレイスのみ適用されます。overview フィールドは必ず指定されますが、他のフィールドは省略可能です。

JSON 表現 
{
  "overview": {
    object (ContentBlock)
  },
  "coffee": {
    object (ContentBlock)
  },
  "restaurant": {
    object (ContentBlock)
  },
  "store": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
フィールド
overview

object (ContentBlock)

利用可能なアメニティの概要。これは保証されます。
coffee

object (ContentBlock)

近くのコーヒー オプションの概要。
restaurant

object (ContentBlock)

近くのレストランの概要。
store

object (ContentBlock)

近くのガソリンスタンドの概要。
flagContentUri

string

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

object (LocalizedText)

AI 開示メッセージ「Gemini による要約」（およびローカライズされたバリエーション）。リクエストで指定された言語（利用可能な場合）で返されます。

ContentBlock

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

JSON 表現 
{
  "content": {
    object (LocalizedText)
  },
  "referencedPlaces": [
    string
  ]
}
フィールド
content

object (LocalizedText)

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

string

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

NeighborhoodSummary

場所の近くにあるスポットの概要。

JSON 表現 
{
  "overview": {
    object (ContentBlock)
  },
  "description": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
フィールド
overview

object (ContentBlock)

近隣の概要。
description

object (ContentBlock)

周辺環境の詳細な説明。
flagContentUri

string

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

object (LocalizedText)

AI 開示メッセージ「Gemini による要約」（およびローカライズされたバリエーション）。リクエストで指定された言語（利用可能な場合）で返されます。

メソッド

autocomplete

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

get

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

searchNearby

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

searchText

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