过滤器参数

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

如果未按照以下要求指定过滤条件名称和值，该函数会返回无效实参错误。

过滤器名称 说明 类型 支持的值
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 到 8 之间。
types

指定要考虑的地点类型。

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

 ARRAY<STRING>

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

示例：

["restaurant", "cafe", "bar"]
primary_types

指定要考虑的主要类型。

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

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

 ARRAY<STRING>

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

示例：

["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"

示例：

["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