篩選器參數

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

篩選器名稱和值須區分大小寫。您必須按照表格中的格式指定這些屬性。否則，查詢會傳回無效引數錯誤。

篩選器名稱 說明 類型 支援的值
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_type

指定要考量的主要類型。

一個地點只能有一個主要類型，也就是最能描述該地點的類型。

如未指定主要類型，結果會考量所有地點主要類型。

 ARRAY<STRING>

如需可能值的完整清單，請參閱「地點類型」。

範例：

["restaurant", "cafe", "bar"]
brand_ids

僅適用於 PLACES_COUNT_PER_H3、PLACES_COUNT_V2和 PLACES_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 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
snapshot_date

指定要查詢的歷來快照月份。

如省略，則預設為最新快照。

 STRING

格式：YYYY-MM。

範例："2026-07"
month1

僅限PLACES_COUNT_CHANGE

指定要查詢的基準快照月份。

 STRING

格式：YYYY-MM。

範例："2026-01"
month2

僅限PLACES_COUNT_CHANGE

指定要查詢的比較快照月份。

 STRING

格式：YYYY-MM。

範例："2026-02"
regular_opening_hours

依一般營業時間篩選地點。

 JSON

範例：JSON_OBJECT('monday', [JSON_OBJECT('start_time', '09:00', 'end_time', '12:00')])
min_ev_charge_connector_count

指定電動車充電插頭的數量下限。

 INT64 最小值為 0。
max_ev_charge_connector_count

指定電動車充電連接器的數量上限。

 INT64 最小值為 0。
max_ev_max_charge_rate_kw

指定電動車充電站的最高充電速率 (單位為 kW)。

 FLOAT64 最小值為 0.0。
ev_charge_connector_types

指定要考量的電動車充電插頭類型。

 ARRAY<STRING>

範例：["EV_CONNECTOR_TYPE_TESLA"]