篩選器參數

您可以使用下表所述的參數，對地點計數函式套用篩選器。請注意，每個函式所需的參數不同：

如果未按照下列規定指定篩選器名稱和值，函式會傳回無效引數錯誤。

篩選器名稱 說明 類型 支援的值
geography

適用於 PLACES_COUNT、PLACES_COUNT_PER_TYPE 和 PLACES_COUNT_PER_H3

指定要搜尋的區域。支援任何類型的 GEOGRAPHY，例如 Point、LineString 和 Polygon。

您可以搭配使用 geography 參數和 geography_radius，在搜尋區域中加入緩衝區。

系統會強制執行至少 40.0 公尺 x 40.0 公尺 (1600 公尺2) 的搜尋範圍。如果指定的搜尋範圍小於此限制，函式會傳回無效引數錯誤。

 GEOGRAPHY 任何類型的 GEOGRAPHY。
geographies

僅適用於 PLACES_COUNT_PER_GEO

指定要搜尋的區域清單。支援任何類型的 GEOGRAPHY，例如 Point、LineString 和 Polygon。

您可以搭配使用 geographies 參數和 geography_radius，在搜尋區域中加入緩衝區。緩衝區會新增至所有指定的地理區域。

系統會強制執行至少 40.0 公尺 x 40.0 公尺 (1600 公尺2) 的搜尋範圍。如果指定的搜尋範圍小於此限制，函式會傳回無效引數錯誤。

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

為指定地理位置新增半徑或緩衝區 (以公尺為單位)。 預設值為 0。

指定的值必須定義至少 40.0 公尺 x 40.0 公尺 (1600 m2) 的搜尋區域。舉例來說，如果地理位置為 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