过滤器参数

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

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

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

对于 PLACES_COUNTPLACES_COUNT_PER_TYPEPLACES_COUNT_PER_H3

指定要搜索的区域。支持任何类型的 GEOGRAPHY,例如 PointLineStringPolygon

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

系统会强制执行 40.0 米 x 40.0 米(1600 平方米)的最小搜索区域。如果您指定的搜索区域小于此限制,该函数将返回无效的实参错误。

GEOGRAPHY 任何类型的 GEOGRAPHY
geographies

仅适用于 PLACES_COUNT_PER_GEO

指定要搜索的区域列表。 支持任何类型的 GEOGRAPHY,例如 PointLineStringPolygon

您可以将 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_H3PLACES_COUNT_V2PLACES_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 TRUEFALSE
delivery 考虑提供送货服务的地点。 BOOLEAN TRUEFALSE
dine_in 考虑提供堂食服务的地点。 BOOLEAN TRUEFALSE
curbside_pickup 考虑提供路边自提服务的地点。 BOOLEAN TRUEFALSE
reservable 考虑可预订的地点。 BOOLEAN TRUEFALSE
outdoor_seating 考虑提供户外座椅的地点。 BOOLEAN TRUEFALSE
live_music 考虑提供现场音乐表演的地点。 BOOLEAN TRUEFALSE
allows_dogs 考虑允许携带狗的地点。 BOOLEAN TRUEFALSE
restroom 考虑提供卫生间的地点。 BOOLEAN TRUEFALSE
serves_breakfast 考虑提供早餐的地点。 BOOLEAN TRUEFALSE
serves_lunch 考虑提供午餐的地点。 BOOLEAN TRUEFALSE
serves_dinner 考虑提供晚餐的地点。 BOOLEAN TRUEFALSE
serves_beer 考虑提供啤酒的地点。 BOOLEAN TRUEFALSE
serves_wine 考虑提供葡萄酒的地点。 BOOLEAN TRUEFALSE
serves_brunch 考虑提供早午餐的地点。 BOOLEAN TRUEFALSE
serves_vegetarian_food 考虑提供素食的地点。 BOOLEAN TRUEFALSE
serves_cocktails 考虑提供鸡尾酒的地点。 BOOLEAN TRUEFALSE
serves_dessert 考虑提供甜点的地点。 BOOLEAN TRUEFALSE
serves_coffee 考虑提供咖啡的地点。 BOOLEAN TRUEFALSE
menu_for_children 考虑提供儿童菜单的地点。 BOOLEAN TRUEFALSE
good_for_children 考虑适合儿童的地点。 BOOLEAN TRUEFALSE
good_for_groups 考虑适合多人聚会的地点。 BOOLEAN TRUEFALSE
good_for_watching_sports 考虑适合观看体育赛事的地点。 BOOLEAN TRUEFALSE
accepts_credit_cards 考虑接受信用卡付款的地点。 BOOLEAN TRUEFALSE
accepts_debit_cards 考虑接受借记卡付款的地点。 BOOLEAN TRUEFALSE
accepts_cash_only 考虑仅接受现金付款的地点。 BOOLEAN TRUEFALSE
accepts_nfc 考虑接受 NFC 付款的地点。 BOOLEAN TRUEFALSE
free_parking_lot 考虑提供免费停车场的地点。 BOOLEAN TRUEFALSE
paid_parking_lot 考虑提供收费停车场的地点。 BOOLEAN TRUEFALSE
free_street_parking 考虑提供免费路边停车位的地点。 BOOLEAN TRUEFALSE
paid_street_parking 考虑提供收费路边停车位的地点。 BOOLEAN TRUEFALSE
valet_parking 考虑提供代客泊车服务的地点。 BOOLEAN TRUEFALSE
free_garage_parking 考虑提供免费停车库的地点。 BOOLEAN TRUEFALSE
paid_garage_parking 考虑提供收费停车库的地点。 BOOLEAN TRUEFALSE
wheelchair_accessible_parking 考虑提供无障碍停车位的地点。 BOOLEAN TRUEFALSE
wheelchair_accessible_entrance 考虑提供无障碍入口的地点。 BOOLEAN TRUEFALSE
wheelchair_accessible_restroom 考虑提供无障碍卫生间的地点。 BOOLEAN TRUEFALSE
wheelchair_accessible_seating 考虑提供无障碍座席的地点。 BOOLEAN TRUEFALSE