REST Resource: places

リソース: Place

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

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)
  },
  "consumerAlert": {
    object (ConsumerAlert)
  },
  "movedPlace": string,
  "movedPlaceId": string,
  "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} 形式)。Place の検索に使用できます。

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 をご覧ください。場所のメインタイプがサポートされているタイプでない場合、メインタイプが欠落していることがあります。プライマリ タイプが存在する場合、それは常に types フィールドのタイプのいずれかになります。

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 よりも多くのコンポーネントが含まれている場合があります。- この配列には、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 期間に値が 0day、値が 0hour、値が 0minute が含まれていれば、年中無休(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 日間のエントリの配列が含まれます。二次的な営業時間は、ビジネスの主な営業時間とは異なります。たとえば、レストランでは、ドライブスルーの営業時間や配達時間を二次営業時間として指定できます。このフィールドには、場所のタイプに基づいて、営業時間タイプの事前定義されたリスト(ドライブスルー、受け取り、テイクアウトなど)から取得されたタイプ サブフィールドが入力されます。このフィールドには、例外的な時間が設定されている日付のすべての時間の specialDays サブフィールドが含まれます。

regularSecondaryOpeningHours[]

object (OpeningHours)

ビジネスの通常の二次的な時間帯に関する情報のエントリの配列が含まれます。二次的な営業時間は、ビジネスの主な営業時間とは異なります。たとえば、レストランでは、ドライブスルーの営業時間や配達時間を二次営業時間として指定できます。このフィールドには、場所のタイプに基づいて、営業時間タイプの事前定義されたリスト(ドライブスルー、受け取り、テイクアウトなど)から取得されたタイプ サブフィールドが入力されます。

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)

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

consumerAlert

object (ConsumerAlert)

ビジネスにおいて不審なクチコミのアクティビティが検出された場合、またはビジネスが Google のポリシーに違反している場合に、その場所に対して表示される消費者向け警告メッセージ。

movedPlace

string

このスポットが永久に閉鎖され、新しいスポットに移動した場合、このフィールドには新しいスポットのリソース名が places/{placeId} 形式で含まれます。この場所が複数回移動した場合、このフィールドは最初に移動した場所を表します。この場所が移動していない場合、このフィールドは入力されません。

movedPlaceId

string

このビジネスが完全に閉鎖され、新しいビジネスに移転した場合、このフィールドには新しいビジネスの場所 ID が含まれます。このプレイスが複数回移動した場合は、最初に移動したプレイスがこのフィールドに表示されます。この場所が移動していない場合、このフィールドは入力されません。

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")。こうすることで、住所の最も細かな部分を表す行を言語に基づいて選択できます。

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

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

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)は、14 メートル x 14 メートル(8000 分の 1 度)以下の長方形を定義するグローバル コードと、プレフィックスを参照位置に置き換える複合コードの 2 つの形式を持つ位置参照です。

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 の場合、緯度範囲は空になります。

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

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

{ "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,
  "visitDate": {
    object (Date)
  }
}
フィールド
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 マップでクチコミを表示するためのリンク。

visitDate

object (Date)

クチコミ投稿者がその場所を訪れた日付。これは、訪問の年と月に切り捨てられます。

AuthorAttribution

UGC データの作成者に関する情報。PhotoReview で使用されます。

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

string

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

uri

string

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

photoUri

string

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

日付

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

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

関連するタイプ:

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

integer

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

month

integer

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

day

integer

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

OpeningHours

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

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

object (Period)

1 週間のうち、この場所が営業している期間。期間は、場所のローカル タイムゾーンで時系列順に表示されます。空の値(欠損値ではない)は、一時的に休業しているなど、営業していない場所を示します。

periods の開始日は固定されておらず、日曜日であると想定しないでください。API は、さまざまな要因に基づいて開始日を決定します。たとえば、24 時間営業のビジネスの場合、最初の期間はリクエストの当日に開始されることがあります。他のビジネスでは、営業を開始する曜日がそれにあたるかもしれません。

注: periods 配列の順序は weekdayDescriptions 配列の順序とは無関係です。同じ日に開始されるとは限りません。

weekdayDescriptions[]

string

この場所の営業時間を説明するローカライズされた文字列。1 週間ごとに 1 つの文字列。

注: 曜日の順序と週の始まりは、ロケール(言語と地域)によって決まります。periods 配列の順序は、weekdayDescriptions 配列の順序とは無関係です。同じ日に開始されるとは限りません。

時間が不明な場合や、ローカライズされたテキストに変換できなかった場合は空になります。例: 「日: 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 * 7 時間が返されます。

day

integer

曜日(0 ~ 6 の整数)。0 は日曜日、1 は月曜日などです。

hour

integer

24 時間形式の時間。範囲は 0 ~ 23 です。

minute

integer

分。範囲は 0 ~ 59 です。

SecondaryHoursType

二次時間のタイプを識別するために使用される型。

列挙型
SECONDARY_HOURS_TYPE_UNSPECIFIED セカンダリ時間タイプが指定されていない場合のデフォルト値。
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)

この特別な日の日付。

タイムゾーン

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 トラックのディーゼル。

金額

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

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

Place でホストされている 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 充電情報。同じタイプで最大充電レート(kW)のコネクタの EV 充電の集計を表示します。

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

EV 充電コネクタの種類の詳細情報 / コンテキストについては、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 Combined Charging System(AC および DC)。SAE に基づきます。Type-1 J-1772 コネクタ
EV_CONNECTOR_TYPE_CCS_COMBO_2 Combined Charging System(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 北米充電規格(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

ターゲットからランドマークまでの道路網に沿った移動距離(メートル単位)。不明な場合は null。この値は、徒歩、車、自転車などの移動手段を考慮していません。

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)
  },
  "reviewsUri": string
}
フィールド
text

object (LocalizedText)

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

flagContentUri

string

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

disclosureText

object (LocalizedText)

AI 開示メッセージ「Gemini で要約しました」(およびそのローカライズされたバリエーション)。利用可能な場合は、リクエストで指定された言語で表示されます。

reviewsUri

string

この場所のクチコミを Google マップに表示するリンク。

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 で要約しました」(およびそのローカライズされたバリエーション)。利用可能な場合は、リクエストで指定された言語で表示されます。

ConsumerAlert

ビジネスにおいて不審なクチコミのアクティビティが検出された場合、またはビジネスが Google のポリシーに違反している場合に、その場所に対して表示される消費者向け警告メッセージ。

JSON 表現
{
  "overview": string,
  "details": {
    object (Details)
  },
  "languageCode": string
}
フィールド
overview

string

消費者アラート メッセージの概要。

details

object (Details)

消費者アラート メッセージの詳細。

languageCode

string

消費者向け警告メッセージの言語コード。これは BCP 47 言語コードです。

詳細

消費者アラート メッセージの詳細。

JSON 表現
{
  "title": string,
  "description": string,
  "aboutLink": {
    object (Link)
  }
}
フィールド
title

string

説明とともに表示するタイトル。

description

string

消費者向けアラート メッセージの説明。

メソッド

autocomplete

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

get

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

searchNearby

場所の近くにある場所を検索します。

searchText

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