This product or feature is in Experimental (pre-GA). Pre-GA products and features might have limited support, and changes to pre-GA products and features might not be compatible with other pre-GA versions. Pre-GA Offerings are covered by the Google Maps Platform Service Specific Terms. For more information, see the launch stage descriptions. Before you can query Places Insights data, you must first sign up to get access to the Places Insights product.

Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

歷來資料總覽

系統會從 2024 年 1 月開始提供每月歷來地點洞察資料。這項資料有助於進行趨勢分析，瞭解特定區域的場所每月變化。追蹤商家和興趣點隨時間的變化，使用者就能找出新興經濟群聚，以及當地市場動態的變化。

設定

您可以在 Places 洞察中查看歷來資料。如要瞭解如何訂閱及設定 Places Insights，請參閱「設定 Places Insights」。

結構定義

歷來地點洞察資料的結構定義與最新資料相同 (請參閱地點洞察參考資料)，但有以下例外狀況。

排除欄位

歷來地點洞察資料的結構定義不包含 rating 或 user_rating_count。

額外欄位

除了核心結構定義外，歷史地點洞察資料的結構定義還包含下列欄位。

Field Name	Type	Mode	Description	Example
`snapshot_date`	`DATE`	`NULLABLE`	The snapshot date for the place.	`2024-01-01`

查詢範例

與最新資料相同，查詢歷來資料時，SELECT陳述式必須包含 WITH AGGREGATION_THRESHOLD。(請參閱「撰寫 Places Insights 查詢」)。此外，您可能還想GROUP BY snapshot_date。以下範例說明如何查詢每月營業餐廳的數量。

SELECT WITH AGGREGATION_THRESHOLD
  snapshot_date,
  COUNT(*) AS count
FROM
  `PROJECT_NAME.places_insights___us.places_historical`
WHERE
  'restaurant' IN UNNEST(types)
AND
  business_status = "OPERATIONAL"
GROUP BY snapshot_date
ORDER BY snapshot_date ASC;

可用的產品資訊

各國家/地區的歷來 Places 洞察資料表，會顯示在對應的 Places 洞察 BigQuery 項目中。

如要瀏覽及訂閱您所在地區的資料交換，請參閱「設定 Places Insights」一文中的設定操作說明。