Monthly historical Places Insights data is available starting from January 2024. This data is useful for performing trends analysis to understand how the places in an area have changed from month to month. By tracking how businesses and points of interest change over time, users can identify emerging economic clusters and shifts in local market dynamics.
Setup
Historical Places Insights data is available as part of Places Insights. See Set up Places Insights for instructions on how to subscribe to and set up Places Insights.
Schema
The schema for historical Places Insights data is the same as for the latest data (see Places Insights reference), with the following exceptions.
Excluded fields
The schema for historical Places Insights data does not include rating or
user_rating_count.
Additional fields
The schema for historical Places Insights data includes the following field in addition to the core schema.
| Field Name | Type | Mode | Description | Example |
|---|---|---|---|---|
snapshot_date |
DATE |
NULLABLE |
The snapshot date for the place. | 2024-01-01 |
Example queries
As with the latest data, the SELECT statement when querying historical data
must include WITH AGGREGATION_THRESHOLD. (See Write a Places Insights
query). Additionally, you will
likely want to GROUP BY snapshot_date. The following example shows how to
query for the number of operational restaurants by month.
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;
Available listings
The historical Places Insights table is available in the respective Places Insights BigQuery listing by country.
To browse and subscribe to the data exchanges for your region, see the setup instructions in Set up Places Insights.