フィルタパラメータ

次の表に示すパラメータを使用して、Places Count 関数にフィルタを適用できます。必要なパラメータは関数ごとに異なります。

• PLACES_COUNT: geography が必要
• PLACES_COUNT_PER_TYPE_V2: geography と type が必要です。
• PLACES_COUNT_V2: geographies が必要
• PLACES_COUNT_PER_H3: geography と h3_resolution が必要です。
• PLACES_COUNT_CHANGE: month1 と month2 が必要です。

フィルタ名とその値では、大文字と小文字が区別されます。表に表示されているとおりに指定する必要があります。それ以外の場合、クエリは無効な引数エラーを返します。

フィルタ名	説明	タイプ	サポートされている値
geography	PLACES_COUNT、PLACES_COUNT_PER_TYPE、PLACES_COUNT_PER_H3 用 検索する領域を指定します。Point、LineString、Polygon など、任意のタイプの GEOGRAPHY がサポートされています。 geography パラメータを geography_radius と組み合わせて使用すると、検索エリアにバッファを追加できます。 最小検索エリアは 40.0 m × 40.0 m（1,600 m^2）です。この上限を下回る検索エリアを指定すると、関数は無効な引数エラーを返します。	GEOGRAPHY	任意のタイプの GEOGRAPHY。
geographies	PLACES_COUNT_PER_GEO のみ 検索するエリアのリストを指定します。Point、LineString、Polygon など、あらゆるタイプの GEOGRAPHY がサポートされています。 geographies パラメータを geography_radius と組み合わせて使用すると、検索エリアにバッファを追加できます。バッファは、指定されたすべての地域に追加されます。 最小検索エリアは 40.0 m × 40.0 m（1,600 m^2）です。この上限を下回る検索エリアを指定すると、関数は無効な引数エラーを返します。	ARRAY<GEOGRAPHY>	任意のタイプの GEOGRAPHY。
geography_radius	指定された地域に半径またはバッファ（メートル単位）を追加します。 デフォルト値は 0 です。 指定する値は、40.0 m × 40.0 m（1,600 m^2）の最小検索エリアを定義する必要があります。たとえば、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	考慮する主なタイプを指定します。 1 つの場所に設定できるメインタイプは 1 つのみです。メインタイプは、その場所を最もよく表すタイプです。 プライマリ タイプが指定されていない場合は、すべての場所のプライマリ タイプが結果で考慮されます。	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	考慮する場所の最低評価を指定します。 Places の評価は、場所に関するユーザー レビューに基づいており、1.0 ～ 5.0 の範囲で表されます。 この範囲外の評価を指定すると、関数は無効な引数エラーを返します。	FLOAT	1.0 ～ 5.0。
max_rating	考慮する場所の最大評価を指定します。 Places の評価は、場所に関するユーザー レビューに基づいており、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	EV 充電コネクタの最小数を指定します。	INT64	最小値は 0 です。
max_ev_charge_connector_count	EV 充電コネクタの最大数を指定します。	INT64	最小値は 0 です。
max_ev_max_charge_rate_kw	EV 充電スタンドの最大充電率（kW）を指定します。	FLOAT64	最小値は 0.0 です。
ev_charge_connector_types	考慮する EV コネクタの種類を指定します。	ARRAY<STRING>	例: ["EV_CONNECTOR_TYPE_TESLA"]