核心結構定義參考資料

所有國家/地區都支援核心結構定義，每個國家/地區則有其他結構定義項目。

欄位名稱 類型 眾數 說明 範例
point GEOGRAPHY NULLABLE 地點位置，以 Point 地理類型物件表示。 POINT(-122.08532 37.42205)
id STRING NULLABLE 專屬地點 ID。請參閱「地點 ID」。 ChIJj61dQgK6j4AR4GeTYWZsKWw
types STRING REPEATED 地點的一組類型標記。例如「餐廳」和「咖啡廳」。如需可能值的完整清單，請參閱「地點類型」。 restaurant,point_of_interest,establishment
primary_type STRING NULLABLE 地點的主要類型。例如「餐廳」、「咖啡廳」、「機場」等。一個地點只能有一個主要類型。如需可能值的完整清單，請參閱「地點類型」。 restaurant
country_code STRING NULLABLE 採用 Unicode CLDR 格式的國家/地區代碼。 US
location RECORD NULLABLE 地點的位置。
location.latitude FLOAT NULLABLE 緯度度數，範圍為 -90.0 至 90.0。 37.42205
location.longitude FLOAT NULLABLE 經度度數，範圍為 -180.0 到 180.0。 -122.08532
rating FLOAT NULLABLE 根據使用者對該地點的評論，評分介於 1.0 到 5.0。 4.5
user_rating_count INTEGER NULLABLE 地點的評論總數。 100
price_level STRING NULLABLE 地點的價格等級。可能的值為「PRICE_LEVEL_FREE」、「PRICE_LEVEL_INEXPENSIVE」、「PRICE_LEVEL_MODERATE」、「PRICE_LEVEL_EXPENSIVE」和「PRICE_LEVEL_VERY_EXPENSIVE」。 PRICE_LEVEL_MODERATE
business_status STRING NULLABLE 地點的商家狀態。可能的值為「OPERATIONAL」、「CLOSED_TEMPORARILY」和「CLOSED_PERMANENTLY」。 OPERATIONAL
takeout BOOLEAN NULLABLE 地點支援外帶。 true
delivery BOOLEAN NULLABLE 商家支援外送。 true
dine_in BOOLEAN NULLABLE 商家提供室內或室外座位。 true
curbside_pickup BOOLEAN NULLABLE 商家提供店外取貨服務。 true
reservable BOOLEAN NULLABLE 地點支援預訂。 true
serves_breakfast BOOLEAN NULLABLE 提供早餐。 true
serves_lunch BOOLEAN NULLABLE 提供午餐。 true
serves_dinner BOOLEAN NULLABLE 供應晚餐。 true
serves_beer BOOLEAN NULLABLE 供應啤酒。 true
serves_wine BOOLEAN NULLABLE 店家供應葡萄酒。 true
serves_brunch BOOLEAN NULLABLE 供應早午餐。 true
serves_vegetarian_food BOOLEAN NULLABLE 供應素食餐點。 true
outdoor_seating BOOLEAN NULLABLE 提供戶外座位。 true
live_music BOOLEAN NULLABLE 提供現場音樂表演。 true
menu_for_children BOOLEAN NULLABLE 提供兒童菜單。 true
serves_cocktails BOOLEAN NULLABLE 供應雞尾酒。 true
serves_dessert BOOLEAN NULLABLE 提供甜點。 true
serves_coffee BOOLEAN NULLABLE 供應咖啡。 true
good_for_children BOOLEAN NULLABLE 適合兒童。 true
allows_dogs BOOLEAN NULLABLE 可帶狗入內。 true
restroom BOOLEAN NULLABLE Place has a restroom. true
good_for_groups BOOLEAN NULLABLE 地點可容納團體。 true
good_for_watching_sports BOOLEAN NULLABLE 適合觀看運動賽事。 true
accepts_credit_cards BOOLEAN NULLABLE 商家接受信用卡付款。 true
accepts_debit_cards BOOLEAN NULLABLE 商家接受簽帳金融卡付款。 true
accepts_cash_only BOOLEAN NULLABLE 商家只接受現金付款。即使有這項屬性，商家仍可能接受其他付款方式。 true
accepts_nfc BOOLEAN NULLABLE 商家接受 NFC 付款。 true
free_parking_lot BOOLEAN NULLABLE 地點提供免費停車位。 true
paid_parking_lot BOOLEAN NULLABLE 提供付費停車位。 true
free_street_parking BOOLEAN NULLABLE 提供免費路邊停車位。 true
paid_street_parking BOOLEAN NULLABLE 提供付費路邊停車位。 true
valet_parking BOOLEAN NULLABLE 提供代客泊車服務。 true
free_garage_parking BOOLEAN NULLABLE 提供免費室內停車位。 true
paid_garage_parking BOOLEAN NULLABLE 提供付費室內停車場。 true
wheelchair_accessible_parking BOOLEAN NULLABLE 地點提供無障礙停車位。 true
wheelchair_accessible_entrance BOOLEAN NULLABLE 地點設有無障礙入口。 true
wheelchair_accessible_restroom BOOLEAN NULLABLE 地點提供無障礙洗手間。 true
wheelchair_accessible_seating BOOLEAN NULLABLE 場地提供無障礙座位。 true
regular_opening_hours RECORD NULLABLE 正常營業時間。請參閱營業時間參考資料。
regular_opening_hours_happy_hour RECORD NULLABLE 次要營業時間類型「HAPPY_HOUR」的一般營業時間。請參閱營業時間參考資料。
regular_opening_hours_drive_through RECORD NULLABLE 次要營業時間類型「DRIVE_THROUGH」的一般營業時間。請參閱營業時間參考資料。
regular_opening_hours_delivery RECORD NULLABLE 次要時段類型「DELIVERY」的一般營業時間。請參閱營業時間參考資料。
regular_opening_hours_takeout RECORD NULLABLE 次要營業時間類型「外帶」的正常營業時間。請參閱營業時間參考資料。
regular_opening_hours_kitchen RECORD NULLABLE 次要營業時間類型「廚房」的正常營業時間。請參閱營業時間參考資料。
regular_opening_hours_breakfast RECORD NULLABLE 次要營業時間類型「早餐」的一般營業時間。請參閱營業時間參考資料。
regular_opening_hours_lunch RECORD NULLABLE 次要營業時間類型「午餐」的一般營業時間。請參閱營業時間參考資料。
regular_opening_hours_dinner RECORD NULLABLE 次要時段類型「晚餐」的一般營業時間。請參閱營業時間參考資料。
regular_opening_hours_brunch RECORD NULLABLE 次要營業時間類型「早午餐」的正常營業時間。請參閱營業時間參考資料。
regular_opening_hours_pickup RECORD NULLABLE 次要營業時間類型「自取」的一般營業時間。請參閱營業時間參考資料。
regular_opening_hours_access RECORD NULLABLE 次要時段類型「ACCESS」的正常營業時間。請參閱營業時間參考資料。
regular_opening_hours_senior_hours RECORD NULLABLE 次要營業時間類型「SENIOR_HOURS」的一般營業時間。請參閱營業時間參考資料。
regular_opening_hours_online_service_hours RECORD NULLABLE 次要營業時間類型「ONLINE_SERVICE_HOURS」的一般營業時間。請參閱營業時間參考資料。
ev_charge_options RECORD NULLABLE 該地點提供的電動車充電站資訊。術語採用 https://afdc.energy.gov/fuels/electricity_infrastructure.html 的定義。一個充電埠一次只能為一輛車充電。一個連接埠有一或多個接頭。一個充電站有一或多個充電座。
ev_charge_options.connector_count INTEGER NULLABLE 這個充電站的連接器數量。不過，由於部分充電埠可能有多個接頭，但一次只能為一輛車充電 (例如)，因此接頭數量可能會大於可同時充電的車輛總數。 3
ev_charge_options.connector_aggregation RECORD REPEATED 電動車充電接頭匯總清單，包含相同類型和相同充電速率的接頭。
ev_charge_options.connector_aggregation.type STRING NULLABLE 這個匯總的連接器類型。如需可能的連接器類型清單，請參閱 EVConnectorType。 EV_CONNECTOR_TYPE_J1772
ev_charge_options.connector_aggregation.max_charge_rate_kw FLOAT NULLABLE 匯總中每個接頭的靜態最大充電速率 (以千瓦為單位)。 16.0
ev_charge_options.connector_aggregation.count INTEGER NULLABLE 這個匯總中的連接器數量。 3
brand_ids STRING REPEATED 品牌的專屬 ID。 13992718219781496405

營業時間參考

特定營業時間類型的正常營業時間。營業時間會依星期幾分開顯示。如果時段跨越午夜，結束時間會截斷為 23:59:59.999999，而隔天會包含從 00:00:00.000000 開始的間隔。舉例來說，如果某個地點週五的營業時間為上午 8 點到中午 12 點，以及晚上 8 點到凌晨 2 點，則 friday 的時間範圍為：[{start_time: "08:00:00", end_time: "12:00:00"}, {start_time: "20:00:00", end_time: "23:59:59.999999"}]。

如要查詢星期五下午 5 點營業的地點，可以執行下列查詢：

SELECT WITH AGGREGATION_THRESHOLD
  COUNT(*) AS count
FROM
  `PROJECT_NAME.places_insights___us___sample.places_sample`
WHERE
  EXISTS(SELECT * FROM UNNEST(regular_opening_hours.friday) WHERE '17:00:00' BETWEEN start_time AND end_time)

營業時間欄位的完整結構定義如下：

Field Name Type Mode Description Example
monday RECORD REPEATED The list of periods on Monday during which the place is open.
monday.start_time TIME NULLABLE Start of the period. 08:00:00
monday.end_time TIME NULLABLE End of the period. 18:00:00
tuesday RECORD REPEATED The list of periods on Tuesday during which the place is open.
tuesday.start_time TIME NULLABLE Start of the period. 08:00:00
tuesday.end_time TIME NULLABLE End of the period. 18:00:00
wednesday RECORD REPEATED The list of periods on Wednesday during which the place is open.
wednesday.start_time TIME NULLABLE Start of the period. 08:00:00
wednesday.end_time TIME NULLABLE End of the period. 18:00:00
thursday RECORD REPEATED The list of periods on Thursday during which the place is open.
thursday.start_time TIME NULLABLE Start of the period. 08:00:00
thursday.end_time TIME NULLABLE End of the period. 18:00:00
friday RECORD REPEATED The list of periods on Friday during which the place is open.
friday.start_time TIME NULLABLE Start of the period. 08:00:00
friday.end_time TIME NULLABLE End of the period. 18:00:00
saturday RECORD REPEATED The list of periods on Saturday during which the place is open.
saturday.start_time TIME NULLABLE Start of the period. 08:00:00
saturday.end_time TIME NULLABLE End of the period. 18:00:00
sunday RECORD REPEATED The list of periods on Sunday during which the place is open.
sunday.start_time TIME NULLABLE Start of the period. 08:00:00
sunday.end_time TIME NULLABLE End of the period. 18:00:00