フィルタパラメータ

次の表に示すパラメータを使用して、場所のカウント関数にフィルタを適用できます。必須パラメータは関数ごとに異なります。

フィルタ名と値が以下の要件に従って指定されていない場合、この関数は無効な引数エラーを返します。

フィルタ名 説明 タイプ サポートされる値
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 m2）に設定されます。この上限を下回る検索領域を指定すると、関数は無効な引数のエラーを返します。

 GEOGRAPHY 任意の型の GEOGRAPHY。
geographies

PLACES_COUNT_PER_GEO のみ

検索する領域のリストを指定します。Point、LineString、Polygon など、あらゆるタイプの GEOGRAPHY がサポートされています。

geographies パラメータを geography_radius と組み合わせて使用すると、検索エリアにバッファを追加できます。バッファは、指定されたすべての地域に追加されます。

最小検索エリアは 40.0 m × 40.0 m（1,600 m2）に設定されます。この上限を下回る検索領域を指定すると、関数は無効な引数のエラーを返します。

 ARRAY<GEOGRAPHY> 任意の型の GEOGRAPHY。
geography_radius

指定された geography に半径またはバッファ（メートル単位）を追加します。デフォルト値は 0 です。

指定された値は、40.0 メートル × 40.0 メートル（1,600 m2）の最小検索領域を定義する必要があります。たとえば、Point 地理情報の場合、最小半径は 23 メートルになります。

 INT64 最小値は 0 です。
h3_resolution

PLACES_COUNT_PER_H3 のみ

場所の数を H3 セルに集計するために使用される H3 解像度。

 INT64 0 ～ 8 の範囲。
types

考慮するスポットタイプを指定します。

各場所には、"restaurant" や "cafe" などの場所のタイプが設定されています。タイプが指定されていない場合は、すべての場所タイプが結果に反映されます。

 ARRAY<STRING>

有効な値の一覧については、プレイスタイプをご覧ください。

例:

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

考慮する主なタイプを指定します。

場所には、その場所を最もよく表す 1 つのプライマリ タイプのみを設定できます。

プライマリ タイプが指定されていない場合は、すべての場所のプライマリ タイプが結果に反映されます。

 ARRAY<STRING>

有効な値の一覧については、プレイスタイプをご覧ください。

例:

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