- リソース: Place
- LocalizedText
- PostalAddress
- AddressComponent
- PlusCode
- LatLng
- ビューポート
- レビュー
- AuthorAttribution
- 日付
- OpeningHours
- 期間
- Point
- SecondaryHoursType
- SpecialDay
- TimeZone
- 写真
- BusinessStatus
- PriceLevel
- Attribution
- PaymentOptions
- ParkingOptions
- SubDestination
- AccessibilityOptions
- FuelOptions
- FuelPrice
- FuelType
- Money
- EVChargeOptions
- ConnectorAggregation
- EVConnectorType
- GenerativeSummary
- ContainingPlace
- AddressDescriptor
- Landmark
- SpatialRelationship
- 分野
- 封じ込め
- GoogleMapsLinks
- PriceRange
- ReviewSummary
- EvChargeAmenitySummary
- ContentBlock
- NeighborhoodSummary
- ConsumerAlert
- 詳細
- リンク
- メソッド
リソース: Place
プレイスを表すすべての情報。
| JSON 表現 |
|---|
{ "name": string, "id": string, "displayName": { object ( |
| フィールド | |
|---|---|
name |
このプレイスのリソース名( |
id |
場所の一意の識別子。 |
displayName |
場所のローカライズされた名前。人が読める短い説明として適しています。例: 「Google Sydney」、「Starbucks」、「Pyrmont」など。 |
types[] |
この結果の型タグのセット。たとえば、「political」や「locality」などです。使用可能な値の完全なリストについては、https://developers.google.com/maps/documentation/places/web-service/place-types の表 A と表 B をご覧ください。 |
primaryType |
指定された結果のプライマリ タイプ。このタイプは、Places API でサポートされているタイプのいずれかである必要があります。たとえば、「レストラン」、「カフェ」、「空港」などです。1 つのプレイスに指定できるプライマリ タイプは 1 つのみです。使用可能な値の完全なリストについては、https://developers.google.com/maps/documentation/places/web-service/place-types の表 A と表 B をご覧ください。場所のメインタイプがサポートされているタイプでない場合、メインタイプが欠落していることがあります。プライマリ タイプが存在する場合、それは常に |
primaryTypeDisplayName |
メインのタイプの表示名。該当する場合は、リクエスト言語にローカライズされます。使用可能な値の完全なリストについては、https://developers.google.com/maps/documentation/places/web-service/place-types の表 A と表 B をご覧ください。場所のメインタイプがサポートされているタイプでない場合、メインタイプが欠落していることがあります。 |
nationalPhoneNumber |
場所の人が読める形式の電話番号(国内形式)。 |
internationalPhoneNumber |
場所の電話番号(人が読める形式、国際電話形式)。 |
formattedAddress |
この場所の人が読める形式の完全な住所。 |
shortFormattedAddress |
この場所の人が読める形式の短い住所。 |
postalAddress |
郵便住所形式の住所。 |
addressComponents[] |
地域レベルごとに繰り返されるコンポーネント。addressComponents[] 配列については、次の点に注意してください。- 住所コンポーネントの配列には、formattedAddress よりも多くのコンポーネントが含まれている場合があります。- この配列には、formattedAddress に含まれているもの以外の住所を持つ行政区画が、すべて含まれているとは限りません。特定の住所を含むすべての行政区画を取得するには、リバース ジオコーディングを使用して住所の緯度と経度をパラメータとしてリクエストに渡します。- レスポンスの形式は、リクエスト間で同じになるとは限りません。特に、addressComponents の数はリクエストされた住所によって異なり、同じ住所でも将来的に変わる可能性があります。コンポーネントは、配列内の位置が変わる場合があります。コンポーネントのタイプは変わる場合があります。特定のコンポーネントが以降のレスポンスに含まれない場合があります。 |
plusCode |
場所の緯度/経度の Plus Code。 |
location |
この場所の位置。 |
viewport |
平均的なサイズの地図に場所を表示するのに適したビューポート。このビューポートは、ビジネスの物理的な境界やサービス提供地域として使用しないでください。 |
rating |
この場所のユーザー レビューに基づく 1.0 ~ 5.0 の評価。 |
googleMapsUri |
この場所に関する詳細情報を提供する URL。 |
websiteUri |
当該の場所の公式ウェブサイト(会社のホームページなど)。チェーン店(IKEA など)の場合、通常はチェーン全体のウェブサイトではなく、個々の店舗のウェブサイトになります。 |
reviews[] |
この場所に関するクチコミのリスト。関連性の高い順に並べ替えられます。返されるレビューは最大 5 件です。 |
regularOpeningHours |
通常の営業時間。場所が年中無休(24 時間営業)の場合、 |
timeZone |
IANA タイムゾーン データベースのタイムゾーン。たとえば、「America/New_York」。 |
photos[] |
この場所の写真に関する情報(参照を含む)。最大 10 枚の写真が返されます。 |
adrFormatAddress |
adr マイクロフォーマットでの場所の住所: http://microformats.org/wiki/adr。 |
businessStatus |
場所のビジネス ステータス。 |
priceLevel |
場所の価格帯。 |
attributions[] |
この結果とともに表示する必要があるデータ プロバイダのセット。 |
iconMaskBaseUri |
アイコン マスクの短縮 URL。ユーザーは、末尾にタイプ サフィックス(「.svg」や「.png」など)を追加することで、さまざまなアイコン タイプにアクセスできます。 |
iconBackgroundColor |
icon_mask の背景色(16 進数形式、例: #909CE1)。 |
currentOpeningHours |
次の 7 日間(今日を含む)の営業時間。期間は、リクエスト日の午前 0 時から 6 日後の午後 11 時 59 分までです。このフィールドには、例外的な時間が設定されている日付のすべての時間の specialDays サブフィールドが含まれます。 |
currentSecondaryOpeningHours[] |
ビジネスの営業時間に関する情報など、次の 7 日間のエントリの配列が含まれます。二次的な営業時間は、ビジネスの主な営業時間とは異なります。たとえば、レストランでは、ドライブスルーの営業時間や配達時間を二次営業時間として指定できます。このフィールドには、場所のタイプに基づいて、営業時間タイプの事前定義されたリスト(ドライブスルー、受け取り、テイクアウトなど)から取得されたタイプ サブフィールドが入力されます。このフィールドには、例外的な時間が設定されている日付のすべての時間の specialDays サブフィールドが含まれます。 |
regularSecondaryOpeningHours[] |
ビジネスの通常の二次的な時間帯に関する情報のエントリの配列が含まれます。二次的な営業時間は、ビジネスの主な営業時間とは異なります。たとえば、レストランでは、ドライブスルーの営業時間や配達時間を二次営業時間として指定できます。このフィールドには、場所のタイプに基づいて、営業時間タイプの事前定義されたリスト(ドライブスルー、受け取り、テイクアウトなど)から取得されたタイプ サブフィールドが入力されます。 |
editorialSummary |
場所の概要が含まれています。概要はテキストによる概要で構成され、該当する場合は言語コードも含まれます。要約テキストは現状のまま提示する必要があり、変更や改変はできません。 |
paymentOptions |
その場所で利用できるお支払い方法。お支払い方法のデータが利用できない場合、お支払い方法のフィールドは設定されません。 |
parkingOptions |
スポットが提供する駐車場のオプション。 |
subDestinations[] |
場所に関連するサブデスティネーションのリスト。 |
fuelOptions |
ガソリンスタンドの燃料オプションに関する最新情報。この情報は定期的に更新されます。 |
evChargeOptions |
電気自動車の充電オプションに関する情報。 |
generativeSummary |
AI 生成による場所の概要。 |
containingPlaces[] |
現在地が位置する場所のリスト。 |
addressDescriptor |
場所の住所記述子。住所記述子には、ランドマークやエリアを使用して場所を説明するのに役立つ追加情報が含まれます。住所記述子の地域別の対応状況については、https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage をご覧ください。 |
googleMapsLinks |
さまざまな Google マップのアクションをトリガーするリンク。 |
priceRange |
プレイスに関連付けられた価格帯。 |
reviewSummary |
ユーザー レビューを使用した場所の AI 生成の概要。 |
evChargeAmenitySummary |
EV 充電スタンドの近くにある施設の概要。 |
neighborhoodSummary |
場所の近くにあるスポットの概要。 |
consumerAlert |
ビジネスにおいて不審なクチコミのアクティビティが検出された場合、またはビジネスが Google のポリシーに違反している場合に、その場所に対して表示される消費者向け警告メッセージ。 |
movedPlace |
このスポットが永久に閉鎖され、新しいスポットに移動した場合、このフィールドには新しいスポットのリソース名が |
movedPlaceId |
このビジネスが完全に閉鎖され、新しいビジネスに移転した場合、このフィールドには新しいビジネスの場所 ID が含まれます。このプレイスが複数回移動した場合は、最初に移動したプレイスがこのフィールドに表示されます。この場所が移動していない場合、このフィールドは入力されません。 |
utcOffsetMinutes |
この場所のタイムゾーンが現在 UTC からオフセットされている分数。これは、X 時間 15 分など、1 時間の端数でオフセットされるタイムゾーンをサポートするために、分単位で表されます。 |
userRatingCount |
この場所のクチコミ(テキストあり / なし)の合計数。 |
takeout |
ビジネスがテイクアウトに対応しているかどうかを指定します。 |
delivery |
ビジネスが宅配サービスをサポートしているかどうかを指定します。 |
dineIn |
ビジネスが屋内席または屋外席のオプションをサポートしているかどうかを指定します。 |
curbsidePickup |
ビジネスがカーブサイド ピックアップをサポートしているかどうかを指定します。 |
reservable |
その場所で予約が可能かどうかを指定します。 |
servesBreakfast |
朝食を提供しているかどうかを指定します。 |
servesLunch |
ランチを提供しているかどうかを指定します。 |
servesDinner |
ディナーを提供しているかどうかを指定します。 |
servesBeer |
ビールを提供しているかどうかを指定します。 |
servesWine |
ワインを提供しているかどうかを指定します。 |
servesBrunch |
ブランチ メニューがあるかどうかを指定します。 |
servesVegetarianFood |
ベジタリアン料理を提供しているかどうかを指定します。 |
outdoorSeating |
テラス席がある。 |
liveMusic |
ライブ演奏を楽しめる。 |
menuForChildren |
キッズメニューがある。 |
servesCocktails |
カクテルを提供するお店。 |
servesDessert |
デザートあり。 |
servesCoffee |
コーヒーを提供している。 |
goodForChildren |
子供連れに適した場所です。 |
allowsDogs |
犬の同伴可。 |
restroom |
トイレあり。 |
goodForGroups |
場所はグループに対応しています。 |
goodForWatchingSports |
スポーツ観戦に適した場所です。 |
accessibilityOptions |
場所が提供するユーザー補助オプションに関する情報。 |
pureServiceAreaBusiness |
その場所が非店舗型ビジネスのみかどうかを示します。非店舗型ビジネスは、客先に出向いてサービスを提供し、ビジネス拠点の住所では接客しないビジネスです。清掃サービスや配管工事などのビジネスが該当します。これらのビジネスは、Google マップに住所や所在地が掲載されていない場合があります。 |
LocalizedText
特定の言語のテキストのローカライズされたバリエーション。
| JSON 表現 |
|---|
{ "text": string, "languageCode": string } |
| フィールド | |
|---|---|
text |
以下の |
languageCode |
テキストの 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 |
新しいリビジョンはすべて、古いリビジョンと下位互換性があることが必要です。 |
regionCode |
必須。住所の国 / 地域に対応する CLDR 地域コード。この値は推測されることはなく、正確な値が確保されるかどうかはユーザー次第です。詳細については、https://cldr.unicode.org/ と https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html をご覧ください。例: スイスの場合は「CH」。 |
languageCode |
省略可。この住所の表記に使われている BCP-47 言語コード(わかっている場合)。多くの場合、これは入力フォームの UI 言語です。あるいは、住所の国や地域で使用されているいずれかの言語、またはそれらの言語を音訳したものと一致する場合もあります。これは特定の国で住所のフォーマットに影響する可能性がありますが、データの正確性にとっては重要でなく、検証やその他のフォーマット関連以外の操作には影響しません。 この値が不明な場合は省略してください(間違っている可能性があるデフォルトは指定しないでください)。 例: 「zh-Hant」、「ja」、「ja-Latn」、「en」。 |
postalCode |
省略可。住所の郵便番号。すべての国で郵便番号の使用や存在を必要としているわけではありませんが、使用されている場合は、住所の他の部分で追加の確認が行われることがあります(例: 米国での州 / 郵便番号の確認)。 |
sortingCode |
省略可。追加の国固有の並べ替えコード。ほとんどの地域では、これは使用されていません。使用される場合、値は「CEDEX」のような文字列で、必要に応じて数字が後に続きます(「CEDEX 7」など)。または、単独の数字で、「セクター コード」(ジャマイカ)、「配達エリア インジケーター」(マラウイ)、「郵便局インジケーター」(コートジボワール)を表します。 |
administrativeArea |
省略可。その国 / 地域の住所に使用される最上位の行政区域。たとえば、州、省、都道府県などがこれに該当します。スペインの場合であれば自治州ではなく県になります(例:「カタルーニャ」ではなく「バルセロナ」)。州や県などの行政区画が住所表記に使用されない国もあります。たとえば、スイスではこの項目を空のままにします。 |
locality |
省略可。一般的に住所の市町村部分を指します。たとえば、米国の市、イタリアのコムーネ、英国の郵便町名などがこれに該当します。地域区分が明確に定義されていない地域や、この体系が当てはまらない地域では、 |
sublocality |
省略可。住所の市町村部分の下位の区画。たとえば、字、特別区、地区などが該当します。 |
addressLines[] |
住所の下位部分を記述する非構造化の住所行。
住所として認められる最小限の体系化表現は、 まったく構造化されていない住所を扱うときは、 |
recipients[] |
省略可。その住所で受け取る人。このフィールドには、場合によっては複数の情報を含めることができます。たとえば、「様方」情報が含まれる場合があります。 |
organization |
省略可。その住所にある組織の名前。 |
AddressComponent
書式設定された住所を構成する構造化コンポーネント(この情報が利用可能な場合)。
| JSON 表現 |
|---|
{ "longText": string, "shortText": string, "types": [ string ], "languageCode": string } |
| フィールド | |
|---|---|
longText |
住所コンポーネントの説明または名前。たとえば、オーストラリアの住所コンポーネントの場合、long_name は「Australia」になります。 |
shortText |
住所コンポーネントの略称(略称がある場合)。たとえば、オーストラリアの住所コンポーネントの short_name は「AU」になります。 |
types[] |
住所コンポーネントのタイプを示す配列。 |
languageCode |
このコンポーネントのフォーマットに使用される言語(CLDR 表記)。 |
PlusCode
Plus Code(http://plus.codes)は、14 メートル x 14 メートル(8000 分の 1 度)以下の長方形を定義するグローバル コードと、プレフィックスを参照位置に置き換える複合コードの 2 つの形式を持つ位置参照です。
| JSON 表現 |
|---|
{ "globalCode": string, "compoundCode": string } |
| フィールド | |
|---|---|
globalCode |
場所のグローバル(完全な)コード(「9FWM33GV+HQ」など)。8000 分の 1 度 x 8000 分の 1 度(約 14 メートル x 14 メートル)の領域を表します。 |
compoundCode |
場所の複合コード(「33GV+HQ, Ramberg, Norway」など)。グローバル コードの接尾辞が含まれ、接頭辞が参照エンティティの書式設定された名前に置き換えられています。 |
LatLng
緯度と経度のペアを表すオブジェクト。これは緯度を表す倍精度値と経度を表す倍精度値のペアで表現されます。特に明記されていない場合、このオブジェクトは WGS84 規格に準拠する必要があります。値は正規化範囲内で指定する必要があります。
| JSON 表現 |
|---|
{ "latitude": number, "longitude": number } |
| フィールド | |
|---|---|
latitude |
緯度(度単位)。範囲 [-90.0, +90.0] 内になければなりません。 |
longitude |
経度(度単位)。範囲 [-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 ( |
| フィールド | |
|---|---|
low |
必須。ビューポートの最下点。 |
high |
必須。ビューポートの最高点。 |
確認
場所のレビューに関する情報。
| JSON 表現 |
|---|
{ "name": string, "relativePublishTimeDescription": string, "text": { object ( |
| フィールド | |
|---|---|
name |
この場所のクチコミを表す参照。この場所のクチコミを再度検索するために使用できます(API の「リソース」名とも呼ばれます: |
relativePublishTimeDescription |
言語と国 / 地域に適した形式で、現在の時刻に対するレビュー時刻を相対的に表す、最近の時刻のフォーマットされた文字列。 |
text |
ローカライズされたレビューのテキスト。 |
originalText |
元の言語のレビュー テキスト。 |
rating |
1.0 ~ 5.0 の数値(星の数とも呼ばれます)。 |
authorAttribution |
このレビューの投稿者。 |
publishTime |
レビューのタイムスタンプ。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
flagContentUri |
ユーザーがクチコミに関する問題を報告できるリンク。 |
googleMapsUri |
Google マップでクチコミを表示するためのリンク。 |
visitDate |
クチコミ投稿者がその場所を訪れた日付。これは、訪問の年と月に切り捨てられます。 |
AuthorAttribution
| JSON 表現 |
|---|
{ "displayName": string, "uri": string, "photoUri": string } |
| フィールド | |
|---|---|
displayName |
|
uri |
|
photoUri |
|
日付
誕生日などのように、カレンダーの日付全体またはその一部を表します。時間帯とタイムゾーンは、他の場所で指定されているか、重要ではありません。日付は西暦を基準にしており、これは次のいずれかを表します。
- 年の値がゼロ以外である月と日の値を含む完全な日付
- 年の値がゼロである月と日(記念日など)。
- 月と日の値がゼロである単独の年。
- 日の値がゼロである年と月(クレジット カードの有効期限など)
関連するタイプ:
google.type.TimeOfDaygoogle.type.DateTimegoogle.protobuf.Timestamp
| JSON 表現 |
|---|
{ "year": integer, "month": integer, "day": integer } |
| フィールド | |
|---|---|
year |
その日付の年。1~9999、または年のない日付を指定する場合は 0 にする必要があります。 |
month |
1 年の中の月。1~12、または月と日のない年を指定する場合は 0 にする必要があります。 |
day |
1 月の中の日付。1~31 で、その年と月で有効な値にする必要があります。または、日が重要でない場合は年のみか年と月を指定するには 0 にする必要があります。 |
OpeningHours
場所の営業時間に関する情報。
| JSON 表現 |
|---|
{ "periods": [ { object ( |
| フィールド | |
|---|---|
periods[] |
1 週間のうち、この場所が営業している期間。期間は、場所のローカル タイムゾーンで時系列順に表示されます。空の値(欠損値ではない)は、一時的に休業しているなど、営業していない場所を示します。
注: |
weekdayDescriptions[] |
この場所の営業時間を説明するローカライズされた文字列。1 週間ごとに 1 つの文字列。 注: 曜日の順序と週の始まりは、ロケール(言語と地域)によって決まります。 時間が不明な場合や、ローカライズされたテキストに変換できなかった場合は空になります。例: 「日: 18:00 ~ 06:00」 |
secondaryHoursType |
補助時間のタイプを識別するために使用される型文字列。 |
specialDays[] |
返された営業時間の対象期間内の特別な日の構造化情報。特別な日は、場所の営業時間に影響を与える可能性のある日です(クリスマスなど)。例外的な営業時間がある場合は、currentOpeningHours と currentSecondaryOpeningHours を設定します。 |
nextOpenTime |
現在の営業時間帯の次の開始時間(最大 7 日後)。このフィールドは、リクエストの処理時に営業時間帯が有効でない場合にのみ入力されます。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
nextCloseTime |
現在の営業時間の期間が終了するまでの残り日数(最大 7 日)。このフィールドは、リクエストの配信時に営業時間帯が有効な場合にのみ入力されます。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
openNow |
営業時間帯が現在有効かどうか。通常の営業時間と現在の営業時間の場合、このフィールドはスポットが営業しているかどうかを示します。サブ営業時間と現在のサブ営業時間の場合、このフィールドは、この場所のサブ営業時間が有効かどうかを示します。 |
期間
場所が OpenNow ステータスのままになる期間。
| JSON 表現 |
|---|
{ "open": { object ( |
| フィールド | |
|---|---|
open |
その場所の営業開始時間。 |
close |
店舗が閉店し始める時間。 |
ポイント
ステータス変更ポイント。
| JSON 表現 |
|---|
{
"date": {
object ( |
| フィールド | |
|---|---|
date |
場所の現地タイムゾーンの日付。 |
truncated |
このエンドポイントが切り捨てられたかどうか。切り捨ては、実際の時間が、時間を返す範囲外にある場合に発生します。この場合、時間を範囲内に切り捨てます。これにより、リクエストの日の午前 0 時から最大 24 * 7 時間が返されます。 |
day |
曜日(0 ~ 6 の整数)。0 は日曜日、1 は月曜日などです。 |
hour |
24 時間形式の時間。範囲は 0 ~ 23 です。 |
minute |
分。範囲は 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 |
この特別な日の日付。 |
タイムゾーン
IANA タイムゾーン データベースのタイムゾーンを表します。
| JSON 表現 |
|---|
{ "id": string, "version": string } |
| フィールド | |
|---|---|
id |
IANA タイムゾーン データベースのタイムゾーン。たとえば、「America/New_York」。 |
version |
省略可。IANA タイムゾーン データベースのバージョン番号。たとえば、「2019a」。 |
写真
場所の写真に関する情報。
| JSON 表現 |
|---|
{
"name": string,
"widthPx": integer,
"heightPx": integer,
"authorAttributions": [
{
object ( |
| フィールド | |
|---|---|
name |
ID。この場所の写真を再度検索するために使用できる、この場所の写真を指す参照(API の「リソース」名 |
widthPx |
利用可能な最大幅(ピクセル単位)。 |
heightPx |
利用可能な高さの最大値(ピクセル単位)。 |
authorAttributions[] |
この写真の作成者。 |
flagContentUri |
ユーザーが写真に関する問題を報告できるリンク。 |
googleMapsUri |
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 |
プレイスのデータ プロバイダの名前。 |
providerUri |
プレイスのデータ プロバイダの URI。 |
PaymentOptions
その場所で利用できるお支払い方法。
| JSON 表現 |
|---|
{ "acceptsCreditCards": boolean, "acceptsDebitCards": boolean, "acceptsCashOnly": boolean, "acceptsNfc": boolean } |
| フィールド | |
|---|---|
acceptsCreditCards |
クレジット カードによる支払いが可能です。 |
acceptsDebitCards |
デビットカードによる支払いが可能です。 |
acceptsCashOnly |
支払いは現金のみです。この属性が設定されている場所でも、他のお支払い方法が利用できる場合があります。 |
acceptsNfc |
NFC モバイル決済が可能です。 |
ParkingOptions
場所の駐車オプションに関する情報。駐車場は複数のオプションを同時にサポートできます。
| JSON 表現 |
|---|
{ "freeParkingLot": boolean, "paidParkingLot": boolean, "freeStreetParking": boolean, "paidStreetParking": boolean, "valetParking": boolean, "freeGarageParking": boolean, "paidGarageParking": boolean } |
| フィールド | |
|---|---|
freeParkingLot |
無料駐車場あり。 |
paidParkingLot |
有料駐車場がある場所。 |
freeStreetParking |
無料の路上駐車が可能です。 |
paidStreetParking |
有料の路上駐車場あり。 |
valetParking |
係員による駐車サービスあり。 |
freeGarageParking |
屋内駐車場を無料で利用可能。 |
paidGarageParking |
有料の屋内駐車場あり。 |
SubDestination
サブスポットは、メインのスポットに関連付けられた特定の場所です。空港、国立公園、大学、スタジアムなど、広大で複雑な場所を検索しているユーザーに、より具体的な目的地を提供します。たとえば、空港のサブ目的地には、関連するターミナルや駐車場が含まれることがあります。サブデスティネーションは、プレイス ID とプレイス リソース名を返します。これらは、後続の Place Details(新版)リクエストで使用して、サブデスティネーションの表示名や位置情報などの詳細情報を取得できます。
| JSON 表現 |
|---|
{ "name": string, "id": string } |
| フィールド | |
|---|---|
name |
サブ宛先のリソース名。 |
id |
サブ目的地のプレイス ID。 |
AccessibilityOptions
場所が提供するユーザー補助オプションに関する情報。
| JSON 表現 |
|---|
{ "wheelchairAccessibleParking": boolean, "wheelchairAccessibleEntrance": boolean, "wheelchairAccessibleRestroom": boolean, "wheelchairAccessibleSeating": boolean } |
| フィールド | |
|---|---|
wheelchairAccessibleParking |
車椅子対応の駐車場がある。 |
wheelchairAccessibleEntrance |
車椅子対応の入り口がある場所。 |
wheelchairAccessibleRestroom |
車椅子対応のトイレがある。 |
wheelchairAccessibleSeating |
車椅子対応の座席がある。 |
FuelOptions
ガソリンスタンドの燃料オプションに関する最新情報。この情報は定期的に更新されます。
| JSON 表現 |
|---|
{
"fuelPrices": [
{
object ( |
| フィールド | |
|---|---|
fuelPrices[] |
このガソリンスタンドで取り扱っている燃料の種類ごとの最新の燃料価格。このステーションが取り扱っている燃料の種類ごとに 1 つのエントリがあります。順序は重要ではありません。 |
FuelPrice
特定の種類の燃料の価格情報。
| JSON 表現 |
|---|
{ "type": enum ( |
| フィールド | |
|---|---|
type |
燃料の種類。 |
price |
燃料の価格。 |
updateTime |
燃料価格が最後に更新された日時。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
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 |
ISO 4217 で定義されている 3 文字の通貨コード。 |
units |
金額の整数部分。たとえば、 |
nanos |
金額の小数部分をナノ(10^-9)単位で表した数。値は -999,999,999 以上 +999,999,999 以下でなければなりません。 |
EVChargeOptions
Place でホストされている EV 充電スタンドに関する情報。用語は https://afdc.energy.gov/fuels/electricity_infrastructure.html に準拠しています。1 つのポートで一度に 1 台の車を充電できます。1 つのポートには 1 つ以上のコネクタがあります。1 つのステーションに 1 つ以上のポートがあります。
| JSON 表現 |
|---|
{
"connectorCount": integer,
"connectorAggregation": [
{
object ( |
| フィールド | |
|---|---|
connectorCount |
このステーションのコネクタ数。ただし、一部のポートには複数のコネクタがあり、一度に 1 台の車しか充電できないため、コネクタの数が同時に充電できる車の総数よりも多くなることがあります。 |
connectorAggregation[] |
同じタイプで同じ充電レートのコネクタを含む EV 充電コネクタの集計のリスト。 |
ConnectorAggregation
[type, maxChargeRateKw] でグループ化された EV 充電情報。同じタイプで最大充電レート(kW)のコネクタの EV 充電の集計を表示します。
| JSON 表現 |
|---|
{
"type": enum ( |
| フィールド | |
|---|---|
type |
この集計のコネクタタイプ。 |
maxChargeRateKw |
集計内の各コネクタの静的な最大充電レート(kW)。 |
count |
この集計内のコネクタの数。 |
availabilityLastUpdateTime |
この集計のコネクタの可用性情報が最後に更新されたときのタイムスタンプ。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
availableCount |
この集計で現在使用可能なコネクタの数。 |
outOfServiceCount |
この集計で現在サービス停止中のコネクタの数。 |
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 ( |
| フィールド | |
|---|---|
overview |
場所の概要。 |
overviewFlagContentUri |
概要の要約に関する問題を報告できるリンク。 |
disclosureText |
AI 開示メッセージ「Gemini で要約しました」(およびそのローカライズされたバリエーション)。利用可能な場合は、リクエストで指定された言語で表示されます。 |
ContainingPlace
この場所がある場所に関する情報。
| JSON 表現 |
|---|
{ "name": string, "id": string } |
| フィールド | |
|---|---|
name |
この場所が位置する場所のリソース名。 |
id |
この場所がある場所のプレイス ID。 |
AddressDescriptor
場所の相対的な説明。付近のランドマークのランキング セットと、ターゲットの場所との関係を示す正確な包含エリアが含まれます。
| JSON 表現 |
|---|
{ "landmarks": [ { object ( |
| フィールド | |
|---|---|
landmarks[] |
近くのランドマークのランキング リスト。最も認識しやすく、近くにあるランドマークが最初にランク付けされます。 |
areas[] |
包含または隣接するエリアのランキング リスト。最も認識しやすく正確なエリアが最初にランク付けされます。 |
ランドマーク
ランドマークの基本的な情報と、ランドマークと目的地の関係。
ランドマークは、場所の説明に使用できる有名な場所です。
| JSON 表現 |
|---|
{ "name": string, "placeId": string, "displayName": { object ( |
| フィールド | |
|---|---|
name |
ランドマークのリソース名。 |
placeId |
ランドマークの Place ID。 |
displayName |
ランドマークの表示名。 |
types[] |
このランドマークのタイプタグのセット。使用可能な値の完全なリストについては、https://developers.google.com/maps/documentation/places/web-service/place-types をご覧ください。 |
spatialRelationship |
ターゲットの場所とランドマークの空間関係を定義します。 |
straightLineDistanceMeters |
ターゲットの中心点とランドマークの中心点間の直線距離(メートル単位)。状況によっては、この値が |
travelDistanceMeters |
ターゲットからランドマークまでの道路網に沿った移動距離(メートル単位)。不明な場合は null。この値は、徒歩、車、自転車などの移動手段を考慮していません。 |
SpatialRelationship
ターゲットの場所とランドマークの空間関係を定義します。
| 列挙型 | |
|---|---|
NEAR |
これは、以下のより具体的な関係のいずれにも該当しない場合のデフォルトの関係です。 |
WITHIN |
ランドマークに空間ジオメトリがあり、ターゲットがその境界内にある。 |
BESIDE |
ターゲットがランドマークに直接隣接している。 |
ACROSS_THE_ROAD |
ターゲットが道路を挟んだランドマークの真向かいにある。 |
DOWN_THE_ROAD |
ランドマークと同じ経路上にあるが、隣または向かい側ではない。 |
AROUND_THE_CORNER |
ランドマークと同じルート上にはないが、1 回曲がれば到達できる。 |
BEHIND |
ランドマークの建物には近いが、道路の入口からは遠い。 |
地域
エリア情報と、エリアとターゲットの場所との関係。
エリアには、場所の説明に役立つ正確な地域の下位区分、近隣地域、大規模な複合施設が含まれます。
| JSON 表現 |
|---|
{ "name": string, "placeId": string, "displayName": { object ( |
| フィールド | |
|---|---|
name |
エリアのリソース名。 |
placeId |
エリアの Place ID。 |
displayName |
エリアの表示名。 |
containment |
ターゲットの場所とエリアの空間的な関係を定義します。 |
封じ込め
ターゲットの場所とエリアの空間的な関係を定義します。
| 列挙型 | |
|---|---|
CONTAINMENT_UNSPECIFIED |
コンテインメントは指定されていません。 |
WITHIN |
ターゲットの場所は、エリア リージョンの中央付近にあります。 |
OUTSKIRTS |
ターゲット ロケーションがエリア リージョン内にあり、端に近い。 |
NEAR |
ターゲットの場所はエリア リージョン外ですが、近くにあります。 |
GoogleMapsLinks
さまざまな Google マップのアクションをトリガーするリンク。
| JSON 表現 |
|---|
{ "directionsUri": string, "placeUri": string, "writeAReviewUri": string, "reviewsUri": string, "photosUri": string } |
| フィールド | |
|---|---|
directionsUri |
目的地までの経路を表示するリンク。このリンクでは、目的地のみが入力され、デフォルトの交通手段 |
placeUri |
この場所を表示するリンク。 |
writeAReviewUri |
Google マップでこの場所のクチコミを投稿するためのリンク。 |
reviewsUri |
この場所のクチコミを Google マップに表示するリンク。 |
photosUri |
この場所の写真を Google マップに表示するリンク。 |
PriceRange
プレイスに関連付けられた価格帯。endPrice は設定されていない場合もあります。これは上限のない範囲(「$100 以上」など)を示します。
| JSON 表現 |
|---|
{ "startPrice": { object ( |
| フィールド | |
|---|---|
startPrice |
価格帯の下限(この値を含む)。価格はこの金額以上である必要があります。 |
endPrice |
価格帯の上限(この値を含まない)。価格はこの金額より低くする必要があります。 |
ReviewSummary
ユーザー レビューを使用した場所の AI 生成の概要。
| JSON 表現 |
|---|
{ "text": { object ( |
| フィールド | |
|---|---|
text |
ユーザー レビューの概要。 |
flagContentUri |
ユーザーが要約に関する問題を報告できるリンク。 |
disclosureText |
AI 開示メッセージ「Gemini で要約しました」(およびそのローカライズされたバリエーション)。利用可能な場合は、リクエストで指定された言語で表示されます。 |
reviewsUri |
この場所のクチコミを Google マップに表示するリンク。 |
EvChargeAmenitySummary
EV 充電スタンドの近くにあるアメニティの概要。これは、タイプが electric_vehicle_charging_station の場所にのみ適用されます。overview フィールドは必ず提供されますが、他のフィールドは省略可能です。
| JSON 表現 |
|---|
{ "overview": { object ( |
| フィールド | |
|---|---|
overview |
利用可能なアメニティの概要。これは必ず提供されます。 |
coffee |
近くのコーヒー ショップの概要。 |
restaurant |
近くのレストランの概要。 |
store |
近くの店舗の概要。 |
flagContentUri |
ユーザーが要約に関する問題を報告できるリンク。 |
disclosureText |
AI 開示メッセージ「Gemini で要約しました」(およびそのローカライズされたバリエーション)。利用可能な場合は、リクエストで指定された言語で表示されます。 |
ContentBlock
個別に配信できるコンテンツのブロック。
| JSON 表現 |
|---|
{
"content": {
object ( |
| フィールド | |
|---|---|
content |
トピックに関連するコンテンツ。 |
referencedPlaces[] |
参照されるプレイスのリソース名のリスト。この名前は、Place リソース名を受け入れる他の API で使用できます。 |
NeighborhoodSummary
場所の近くにあるスポットの概要。
| JSON 表現 |
|---|
{ "overview": { object ( |
| フィールド | |
|---|---|
overview |
近隣地域の概要。 |
description |
近隣地域の詳細な説明。 |
flagContentUri |
ユーザーが要約に関する問題を報告できるリンク。 |
disclosureText |
AI 開示メッセージ「Gemini で要約しました」(およびそのローカライズされたバリエーション)。利用可能な場合は、リクエストで指定された言語で表示されます。 |
ConsumerAlert
ビジネスにおいて不審なクチコミのアクティビティが検出された場合、またはビジネスが Google のポリシーに違反している場合に、その場所に対して表示される消費者向け警告メッセージ。
| JSON 表現 |
|---|
{
"overview": string,
"details": {
object ( |
| フィールド | |
|---|---|
overview |
消費者アラート メッセージの概要。 |
details |
消費者アラート メッセージの詳細。 |
languageCode |
消費者向け警告メッセージの言語コード。これは BCP 47 言語コードです。 |
詳細
消費者アラート メッセージの詳細。
| JSON 表現 |
|---|
{
"title": string,
"description": string,
"aboutLink": {
object ( |
| フィールド | |
|---|---|
title |
説明とともに表示するタイトル。 |
description |
消費者向けアラート メッセージの説明。 |
aboutLink |
詳細情報を提供するために説明とともに表示するリンク。 |
リンク
詳細情報を提供するために説明とともに表示するリンク。
| JSON 表現 |
|---|
{ "title": string, "uri": string } |
| フィールド | |
|---|---|
title |
リンクに表示するタイトル。 |
uri |
リンクの URI。 |
メソッド |
|
|---|---|
|
指定された入力の予測を返します。 |
|
places/{place_id} 形式の文字列であるリソース名に基づいて、プレイスの詳細を取得します。 |
|
場所の近くにある場所を検索します。 |
|
テキスト クエリに基づく場所検索。 |