过滤器参数

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

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

过滤条件名称 说明 类型 支持的值
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_types

指定要考虑的主要类型。

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

如果未指定任何主要类型，结果中将考虑所有地点主要类型。

 ARRAY<STRING>

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

示例：

["restaurant", "cafe", "bar"]
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