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 uses AI technology to translate content into your preferred language. AI translations can contain errors.

历史数据概览

自 2024 年 1 月起，系统会提供按月汇总的历史 Places Insights 数据。此数据有助于进行趋势分析，了解某个区域内的地点如何逐月变化。通过跟踪商家和兴趣点随时间的变化情况，用户可以识别新兴的经济集群以及当地市场动态的变化。

设置

历史 Places Insights 数据是 Places Insights 的一部分。如需了解如何订阅和设置 Places Insights，请参阅设置 Places Insights。

架构

历史 Places Insights 数据的架构与最新数据的架构相同（请参阅 Places Insights 参考文档），但有以下例外情况。

排除的字段

历史 Places Insights 数据的架构不包含 rating 或 user_rating_count。

其他字段

除了核心架构之外，历史 Places Insights 数据的架构还包含以下字段。

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 查询）。此外，您可能还需要按 snapshot_date 进行 GROUP BY。以下示例展示了如何按月查询正常营业的餐厅数量。

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 Insights 表格位于相应国家/地区的 Places Insights BigQuery 列表中。

如需浏览和订阅您所在区域的数据交换，请参阅设置 Places Insights 中的设置说明。