フィルタパラメータ

以下の表に示すパラメータを使用して、プレイス数の関数 にフィルタを適用できます。必要なパラメータは関数によって異なります。

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

フィルタ名 説明 タイプ サポートされる値
geography

PLACES_COUNT、PLACES_COUNT_PER_TYPE、PLACES_COUNT_PER_H3 の場合

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

geography パラメータを geography_radius と組み合わせて使用すると、検索領域にバッファを追加できます。

最小検索領域は 40.0 メートル × 40.0 メートル（1,600 m2）です。この制限を下回る検索領域を指定すると、関数は無効な引数のエラーを返します。

 GEOGRAPHY あらゆるタイプの GEOGRAPHY。
geographies

PLACES_COUNT_PER_GEO のみ

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

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

最小検索領域は 40.0 メートル × 40.0 メートル（1,600 m2）です。この制限を下回る検索領域を指定すると、関数は無効な引数のエラーを返します。

 ARRAY<GEOGRAPHY> あらゆるタイプの GEOGRAPHY。
geography_radius

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

指定する値は、最小検索 領域 40.0 メートル × 40.0 メートル（1,600 平方メートル）を定義する必要があります。たとえば、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 つのみです。これは、その場所を最もよく表すタイプです。

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

 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