PLACES_COUNT_V2 函数会返回一个 BigQuery 表,其中包含根据指定过滤条件得出的多个输入地理位置的地点数量和示例地点 ID。此函数旨在通过接受地理位置的输入表参数来实现高效的批量处理,让您能够通过输入表提供地理位置,从而在单个查询中分析多个感兴趣的区域。
语法
SELECT * FROM `PROJECT_NAME.LINKED_DATASET_NAME.PLACES_COUNT_V2`( TABLE input_geographies, filters )
参数
PROJECT_NAME:您的 Google Cloud 项目的名称。LINKED_DATASET_NAME:包含地点数据分析函数的 BigQuery 数据集的名称(例如places_insights___us)。input_geographies:包含要分析的地理位置的 BigQuery 表。此表必须包含以下列:filters(JSON):一个 JSON 对象,其中包含用于过滤地点的键值对。请参阅过滤条件参数。
输出表架构
PLACES_COUNT_V2 函数会返回一个包含以下列的表:
| 列名称 | 数据类型 | 说明 |
|---|---|---|
geo_id |
STRING | 输入地理位置的唯一标识符,来自 input_geographies 表。 |
input_geography |
GEOGRAPHY | input_geographies 表中的原始 GEOGRAPHY 对象。 |
place_count |
INTEGER | 与过滤条件匹配的地点总数。 |
sample_place_ids |
ARRAY<STRING> | 一个包含最多 250 个符合条件的地点 ID 的数组。 |
运作方式
该函数会处理 input_geographies 表中的每一行。对于每个 geo 对象,它会统计位于该地理区域内(或者如果 geo 是一个点,且在 filters 中指定了半径,则位于 geography_radius 内)的地点数量。该计数仅包含与 filters JSON 对象中定义的所有条件匹配的地点。
示例:计算纽约市三个县的餐厅数量
此示例生成一个表格,其中包含纽约市三个县的营业餐厅数量。
此示例使用美国人口普查局数据 BigQuery 公共数据集来获取纽约市三个县(“Queens”、“Kings”和“New York”)的边界。每个县的边界都包含在 county_geom 列中。
我们首先创建一个临时表 new_york_counties,用于保存每个县的 geo_id 和简化的 GEOGRAPHY。
SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_V2`( ( SELECT county_name AS geo_id, ST_SIMPLIFY(county_geom, 100) AS geo FROM `bigquery-public-data.geo_us_boundaries.counties` WHERE state_fips_code = "36" -- New York State AND county_name IN ("Queens", "Kings", "New York") ), JSON_OBJECT( 'types', ["restaurant"], 'business_status', ['OPERATIONAL'] ) );
响应表将有三行,每个县一行,显示营业餐厅的 geo_id、input_geography、place_count 和 sample_place_ids。

使用 PLACES_COUNT_V2 的好处
与 PLACES_COUNT 和 PLACES_COUNT_PER_GEO 相比,PLACES_COUNT_V2 具有显著优势:
- 批量处理:通过在表格中提供多个地理位置输入,在单个查询中高效分析数千个自定义地理位置。
- 性能:利用 BigQuery 优化的地理空间联接,为大型数据集提供显著的速度优势。
- 可伸缩性:旨在处理大量输入地理位置,不受单个 JSON 参数大小的限制。
- 包含零计数:
PLACES_COUNT_V2会为输入表中提供的每个geo_id返回一行。如果没有任何地点符合给定地理位置的条件,则place_count将为 0。这样可以确保每个输入区域都有结果,以便您了解哪些地方没有结果。 - 历史快照:使用可选的
snapshot_date过滤条件查询特定月份的地点数量数据。
示例:查询上个月的地图注点数量
此示例演示了如何使用 snapshot_date 参数查询特定地点的历史 POI 数量。它会过滤结果,仅显示具有 max_ev_max_charge_rate_kw 指定的电动汽车充电设施以及特定 regular_opening_hours 的地点。
SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_V2`( ( SELECT county_name AS geo_id, ST_SIMPLIFY(county_geom, 100) AS geo FROM `bigquery-public-data.geo_us_boundaries.counties` WHERE state_fips_code = "36" -- New York State AND county_name IN ("Queens", "Kings", "New York") ), JSON_OBJECT( 'geography_radius', 5000, 'snapshot_date', '2026-01', -- Target snapshot month (YYYY-MM) 'max_ev_max_charge_rate_kw', 30.0, -- Filter by EV charge rate in kW 'regular_opening_hours', JSON_OBJECT( 'monday', [JSON_OBJECT('start_time', '09:00', 'end_time', '12:00')] ) ) );