2025 年 9 月 4 日发布的 Places Insights 包含以下自初始版本以来的更改：
- 支持在您选择的 BigQuery 位置订阅 Places Insights。
将 Places Insights 数据集从数据净室移至 BigQuery 数据交易所商品。
数据集架构中的地址字段将
id和name字段分隔为离散的字符串或字符串数组字段。
迁移到列表
Places Insights 的初始预览版在 BigQuery 数据净室中部署了数据。在 2025 年 9 月 4 日发布的版本中，我们将数据集移至 BigQuery listing，以便您订阅特定 BigQuery 区域中的数据集。此变更不会影响地点信息洞察的产品功能和实用性。
如需订阅特定区域的 Places Insights，您需要在 BigQuery Sharing 中订阅新的商品详情。订阅新商品详情后，您无需修改 SQL 查询。它们仍会以相同的方式运行。
新用户：如果您是 Places Insights 的新用户，请按照设置 Places Insights 中的步骤操作，配置开发环境以访问商家信息。
现有用户：请按照以下步骤迁移到使用商品详情
迁移步骤
如需迁移到商品详情，您需要：
订阅您选择的城市和国家/地区的房源。如需查看相关说明，请参阅设置地点信息洞见。
将查询或函数中的数据集名称更新为您在上面选择的数据集名称。
如果您之前使用过函数，请移除与数据净室搭配使用的项目名称 (
maps-platform-analytics-hub)。修改现有查询或函数，以包含项目名称（可选）和新的地址字段。
引用商品详情时添加项目名称（可选）
使用列表时，您可以在查询中添加项目名称。如果您未指定项目名称，则查询将默认针对活动项目。
如果您在不同项目中关联了名称相同的数据集，或者要查询活跃项目之外的表，则可能需要添加项目名称。
包含项目和数据集名称的更新后查询示例
此查询包含项目名称，并使用数据集名称 my_dataset_name：
SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.my_dataset_name.places`
迁移到新的地址字段
在 Places Insights 的初始版本中，数据集架构将地址字段表示为包含 id 和 name 子字段的 STRUCT 或 RECORD。此版本将架构扁平化，以便为 id 和 name 定义单独的顶级字段。新字段可以是字符串字段，也可以是字符串数组字段。
例如，初始版本的地区地址组件的架构如下所示：
locality |
STRUCT |
|
locality.id |
STRING |
|
locality.name |
STRING |
|
在此版本中，数据集现在包含两个顶级字符串数组字段。例如，更新后的地区数据架构如下所示：
locality_ids |
ARRAY<string> |
locality_names |
ARRAY<string> |
请参阅完整的方案参考。
非数组字段
在此版本中，id 和 name 字段现在是针对非数组地址字段的顶级 STRING 字段：
administrative_area_level_1_id |
STRING |
administrative_area_level_1_name |
STRING |
这种新格式适用于表单 administrative_area_level_N 中的所有字段，其中 N 为 1 到 7。
使用新字段的示例
在 Places Insights 的初始版本中，您可以使用 WHERE 子句中的 administrative_area_level_1.name 字段来过滤结果：
SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.places_insights___us.places`
WHERE administrative_area_level_1.name = "New York";
使用新字段时，您可以使用 administrative_area_level_1_name 字段编写查询：
SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.places_insights___us.places`
WHERE administrative_area_level_1_name = "New York";