您可以使用下表所述的參數，對地點計數函式套用篩選條件。請注意，每項函式所需的參數不同：
PLACES_COUNT：需要geographyPLACES_COUNT_PER_TYPE：需要geography和typePLACES_COUNT_PER_GEO：需要geographiesPLACES_COUNT_PER_H3：需要geography和h3_resolution
篩選器名稱和值會區分大小寫，因此您必須完全按照表格中的顯示方式指定，否則查詢會傳回無效引數錯誤。
| 篩選器名稱 | 說明 | 類型 | 支援的值 |
|---|---|---|---|
geography |
適用於 指定要搜尋的區域。系統支援任何類型的 您可以搭配使用 系統會強制執行至少 40.0 公尺 x 40.0 公尺 (1600 公尺2) 的搜尋範圍。如果指定的搜尋範圍小於此限制，函式會傳回無效引數錯誤。 |
GEOGRAPHY |
任何類型的 GEOGRAPHY。 |
geographies |
僅適用於 指定要搜尋的區域清單。支援任何類型的 您可以搭配使用 系統會強制執行至少 40.0 公尺 x 40.0 公尺 (1600 公尺2) 的搜尋範圍。如果指定的搜尋範圍小於此限制，函式會傳回無效引數錯誤。 |
ARRAY<GEOGRAPHY> |
任何類型的 GEOGRAPHY。 |
geography_radius |
為指定地理位置新增半徑或緩衝區 (以公尺為單位)。 預設值為 0。 指定的值必須定義至少 40.0 公尺 x 40.0 公尺 (1600 m2) 的搜尋區域。舉例來說，如果是 |
INT64 |
最小值為 0。 |
h3_resolution |
僅適用於 用於將地點數量匯總至 H3 儲存格的 H3 解析度。 |
INT64 |
介於 0 到 11 之間。 |
types |
指定要考慮的地點類型。 每個地點都包含一組地點類型，例如 |
ARRAY<STRING> |
如需可能值的完整清單，請參閱「地點類型」。 範例：
|
primary_type |
指定要考慮的主要類型。 一個地點只能有一個主要類型，也就是最能描述該地點的類型。 如未指定主要類型，結果會納入所有地點主要類型。 |
ARRAY<STRING> |
如需可能值的完整清單，請參閱地點類型。 範例：
|
brand_ids |
僅適用於 指定要考量的品牌 ID。 每個地點都可以與品牌 ID 建立關聯。如未指定品牌 ID，系統會將所有品牌 (和非品牌地點) 納入結果。 注意：品牌資料僅適用於特定國家/地區。目前：美國 (US)、加拿大 (CA)、英國 (GB) 和澳洲 (AU)。 |
ARRAY<STRING> |
品牌 ID 陣列。如要進一步瞭解品牌資料，請參閱「使用品牌資料編寫查詢」。 範例：
|
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> |
支援的值：
範例：
|
business_status |
指定要考量的營業狀態。您可以指定多個營業狀態。 | ARRAY<STRING> |
支援的值：
範例：
|
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 |