过滤器参数

您可以使用下表中所述的参数对地点计数函数应用过滤条件。请注意，每个函数所需的参数各不相同：

过滤条件名称及其值区分大小写。您必须完全按照表中显示的方式指定它们。否则，查询将返回无效参数错误。

过滤器名称 说明 类型 支持的值
geography

适用于 PLACES_COUNT、PLACES_COUNT_PER_TYPE和 PLACES_COUNT_PER_H3

指定要搜索的区域。支持任何类型的 GEOGRAPHY，例如 Point、LineString 和 Polygon。

您可以将 geography 参数与 geography_radius 结合使用，为搜索区域添加缓冲区。

强制执行 40.0 米 x 40.0 米（1600 平方米）的最小搜索区域。如果您指定的搜索区域低于此限制，该函数会返回无效参数错误。

 GEOGRAPHY 任何类型的 GEOGRAPHY。
geographies

仅限 PLACES_COUNT_PER_GEO

指定要搜索的区域列表。支持任何类型的 GEOGRAPHY，例如 Point、LineString 和 Polygon。

您可以将 geographies 参数与 geography_radius 结合使用，为搜索区域添加缓冲区。缓冲区会添加到所有指定的地理位置。

强制执行 40.0 米 x 40.0 米（1600 平方米）的最小搜索区域。如果您指定的搜索区域低于此限制，该函数会返回无效参数错误。

 ARRAY<GEOGRAPHY> 任何类型的 GEOGRAPHY。
geography_radius

为指定地理位置添加半径或缓冲区（以米为单位）。 默认值为 0。

指定的值必须定义一个最小搜索区域，其大小为 40.0 米 x 40.0 米（1600 平方米）。例如，对于 Point 地理位置，最小半径为 23 米。

 INT64 最小值为 0。
h3_resolution

仅限 PLACES_COUNT_PER_H3

用于将地点数量汇总到 H3 单元格中的 H3 分辨率。

 INT64 介于 0 到 11 之间。
types

指定要考虑的地点类型。

每个地点都包含一组地点类型，例如 "restaurant" 和 "cafe"。如果未指定任何类型，系统会在结果中考虑所有地点类型。

 ARRAY<STRING>

如需查看可能值的完整列表，请参阅地点类型。

示例：

["restaurant", "cafe", "bar"]
primary_type

指定要考虑的主要类型。

一个地点只能有一个主要类型，即最能描述该地点的类型。

如果未指定主要类型，则结果中会考虑所有地点主要类型。

 ARRAY<STRING>

如需查看可能值的完整列表，请参阅地点类型。

示例：

["restaurant", "cafe", "bar"]
brand_ids

仅适用于 PLACES_COUNT_PER_H3、PLACES_COUNT_V2和 PLACES_COUNT_PER_TYPE_V2

指定要考虑的品牌 ID。

每个地点都可以与品牌 ID 相关联。如果未指定品牌 ID，则结果中会考虑所有品牌（和不含品牌词的地点）。

注意：品牌数据仅在部分国家/地区受支持。目前：美国 (US)、加拿大 (CA)、英国 (GB) 和澳大利亚 (AU)。

 ARRAY<STRING>

品牌 ID 数组。如需详细了解品牌数据，请参阅使用品牌数据编写查询。

示例：

["brand_001", "brand_002"]
min_rating 指定要考虑的最低地点评分。

地点评分基于用户对地点的评价，范围在 1.0 到 5.0 之间

如果您指定的评分超出此范围，该函数会返回无效参数错误。

 FLOAT 1.0 到 5.0 之间。
max_rating

指定要考虑的地点评分上限。

地点评分基于用户对地点的评价，范围在 1.0 到 5.0 之间

如果您指定的评分超出此范围，该函数会返回无效参数错误。

 FLOAT 1.0 到 5.0 之间。
min_user_rating_count

指定要考虑的最低房客评分数量。

房客评分数量是指某个地点收到的评价总数。

最小值为 0。如果您指定的值小于 0，该函数会返回无效参数错误。

 INT64 最小值为 0。
max_user_rating_count

指定要考虑的房客评分数量上限。

房客评分数量是指某个地点收到的评价总数。

最小值为 0。如果您指定的值小于 0，该函数会返回无效参数错误。

 INT64 最小值为 0。
price_level

指定要考虑的价格水平。

您可以指定多个价格级别。

 ARRAY<STRING>

支持的值：

"PRICE_LEVEL_FREE"

"PRICE_LEVEL_INEXPENSIVE"

"PRICE_LEVEL_MODERATE"

"PRICE_LEVEL_EXPENSIVE"

"PRICE_LEVEL_VERY_EXPENSIVE"

示例：

["PRICE_LEVEL_MODERATE","PRICE_LEVEL_EXPENSIVE"]
business_status 指定要考虑的营业状态。您可以指定多个营业状态。 ARRAY<STRING>

支持的值：

"OPERATIONAL"

"CLOSED_TEMPORARILY"

"CLOSED_PERMANENTLY"

"FUTURE_OPENING"

示例：

["OPERATIONAL","CLOSED_TEMPORARILY"]
takeout 考虑提供外卖服务的地点。 BOOLEAN TRUE、FALSE
delivery 考虑提供送货服务的地点。 BOOLEAN TRUE、FALSE
dine_in 考虑提供堂食服务的地点。 BOOLEAN TRUE、FALSE
curbside_pickup 考虑提供路边自提服务的地点。 BOOLEAN TRUE、FALSE
reservable 考虑可预订的地点。 BOOLEAN TRUE、FALSE
outdoor_seating 考虑提供户外座位的场所。 BOOLEAN TRUE、FALSE
live_music 考虑提供现场音乐表演的场所。 BOOLEAN TRUE、FALSE
allows_dogs 考虑允许带狗进入的场所。 BOOLEAN TRUE、FALSE
restroom 考虑提供洗手间的地点。 BOOLEAN TRUE、FALSE
serves_breakfast 考虑供应早餐的地点。 BOOLEAN TRUE、FALSE
serves_lunch 考虑提供午餐的地点。 BOOLEAN TRUE、FALSE
serves_dinner 考虑提供晚餐的地点。 BOOLEAN TRUE、FALSE
serves_beer 考虑供应啤酒的场所。 BOOLEAN TRUE、FALSE
serves_wine 考虑提供葡萄酒的地点。 BOOLEAN TRUE、FALSE
serves_brunch 考虑提供早午餐的地点。 BOOLEAN TRUE、FALSE
serves_vegetarian_food 考虑供应素食的地点。 BOOLEAN TRUE、FALSE
serves_cocktails 考虑供应鸡尾酒的场所。 BOOLEAN TRUE、FALSE
serves_dessert 考虑提供甜点的地点。 BOOLEAN TRUE、FALSE
serves_coffee 考虑供应咖啡的地点。 BOOLEAN TRUE、FALSE
menu_for_children 考虑提供儿童菜单的地点。 BOOLEAN TRUE、FALSE
good_for_children 考虑适合儿童的场所。 BOOLEAN TRUE、FALSE
good_for_groups 考虑适合多人聚会的场所。 BOOLEAN TRUE、FALSE
good_for_watching_sports 考虑适合观看体育赛事的场所。 BOOLEAN TRUE、FALSE
accepts_credit_cards 考虑接受信用卡支付的地点。 BOOLEAN TRUE、FALSE
accepts_debit_cards 考虑接受借记卡的地点。 BOOLEAN TRUE、FALSE
accepts_cash_only 考虑仅接受现金的场所。 BOOLEAN TRUE、FALSE
accepts_nfc 考虑接受 NFC 支付的地点。 BOOLEAN TRUE、FALSE
free_parking_lot 考虑有免费停车场的地点。 BOOLEAN TRUE、FALSE
paid_parking_lot 考虑有收费停车场的地点。 BOOLEAN TRUE、FALSE
free_street_parking 考虑提供免费路边停车位的地点。 BOOLEAN TRUE、FALSE
paid_street_parking 考虑有收费路边停车位的地点。 BOOLEAN TRUE、FALSE
valet_parking 考虑提供代客泊车服务的地点。 BOOLEAN TRUE、FALSE
free_garage_parking 考虑有免费停车库的地点。 BOOLEAN TRUE、FALSE
paid_garage_parking 考虑提供收费停车库的地点。 BOOLEAN TRUE、FALSE
wheelchair_accessible_parking 考虑设有无障碍停车位的地点。 BOOLEAN TRUE、FALSE
wheelchair_accessible_entrance 考虑设有轮椅无障碍入口的地点。 BOOLEAN TRUE、FALSE
wheelchair_accessible_restroom 考虑设有无障碍卫生间的地点。 BOOLEAN TRUE、FALSE
wheelchair_accessible_seating 考虑设有无障碍座席的地点。 BOOLEAN TRUE、FALSE
snapshot_date

指定要查询的历史快照月份。

如果省略，则默认为最新快照。

 STRING

格式：YYYY-MM。

示例："2026-07"
month1

仅限 PLACES_COUNT_CHANGE

指定要查询的基准快照月份。

 STRING

格式：YYYY-MM。

示例："2026-01"
month2

仅限 PLACES_COUNT_CHANGE

指定要查询的对比快照月份。

 STRING

格式：YYYY-MM。

示例："2026-02"
regular_opening_hours

按常规营业时间过滤地点。

 JSON

示例：JSON_OBJECT('monday', [JSON_OBJECT('start_time', '09:00', 'end_time', '12:00')])
min_ev_charge_connector_count

指定电动汽车充电连接器的数量下限。

 INT64 最小值为 0。
max_ev_charge_connector_count

指定电动汽车充电连接器的数量上限。

 INT64 最小值为 0。
max_ev_max_charge_rate_kw

指定电动车辆充电站的最大充电速率（以 kW 为单位）。

 FLOAT64 最小值为 0.0。
ev_charge_connector_types

指定要考虑的电动汽车连接器类型。

 ARRAY<STRING>

示例：["EV_CONNECTOR_TYPE_TESLA"]