Paramètres de filtre

Vous pouvez appliquer des filtres aux fonctions de comptage de lieux à l'aide des paramètres décrits dans le tableau ci-dessous. Notez que les paramètres requis diffèrent pour chaque fonction :

Le nom du filtre et sa valeur sont sensibles à la casse. Vous devez les spécifier exactement comme ils apparaissent dans le tableau. Sinon, la requête renverra une erreur d'argument non valide.

Nom du filtre Description Type Valeurs acceptées
geography

Pour PLACES_COUNT, PLACES_COUNT_PER_TYPE et PLACES_COUNT_PER_H3

Spécifie une zone de recherche. Tous les types de GEOGRAPHY sont acceptés, tels que Point, LineString et Polygon.

Vous pouvez utiliser le paramètre geography en combinaison avec geography_radius pour ajouter une zone tampon à votre zone de recherche.

Une zone de recherche minimale de 40 mètres sur 40 mètres (1 600 m2) est appliquée. Si vous spécifiez une zone de recherche inférieure à cette limite, la fonction renvoie une erreur d'argument non valide.

 GEOGRAPHY Tout type de GEOGRAPHY.
geographies

Pour PLACES_COUNT_PER_GEO uniquement

Spécifie une liste de zones à rechercher. Tous les types de GEOGRAPHY sont acceptés, tels que Point, LineString et Polygon.

Vous pouvez utiliser le paramètre geographies en combinaison avec geography_radius pour ajouter une zone tampon à votre zone de recherche. La zone tampon est ajoutée à toutes les zones géographiques spécifiées.

Une zone de recherche minimale de 40 mètres sur 40 mètres (1 600 m2) est appliquée. Si vous spécifiez une zone de recherche inférieure à cette limite, la fonction renvoie une erreur d'argument non valide.

 ARRAY<GEOGRAPHY> Tout type de GEOGRAPHY.
geography_radius

Ajoute un rayon ou une zone tampon, en mètres, à la zone géographique spécifiée. La valeur par défaut est 0.

La valeur spécifiée doit définir une zone de recherche minimale de 40 mètres sur 40 mètres (1 600 m2). Par exemple, pour une zone géographique Point, le rayon minimal est de 23 mètres.

 INT64 La valeur minimale est 0.
h3_resolution

Pour PLACES_COUNT_PER_H3 uniquement

Résolution H3 utilisée pour agréger le nombre de lieux dans les cellules H3.

 INT64 Entre 0 et 11.
types

Spécifie les types de lieux à prendre en compte.

Chaque lieu contient un ensemble de types de lieux, par exemple "restaurant" et "cafe". Si aucun type n'est spécifié, tous les types de lieux sont pris en compte dans le résultat.

 ARRAY<STRING>

Pour obtenir la liste complète des valeurs possibles, consultez Types de lieux.

Exemple :

["restaurant", "cafe", "bar"]
primary_type

Spécifie les types principaux à prendre en compte.

Un lieu ne peut avoir qu'un seul type principal, qui est celui qui le décrit le mieux.

Si aucun type principal n'est spécifié, tous les types principaux de lieux sont pris en compte dans le résultat.

 ARRAY<STRING>

Pour obtenir la liste complète des valeurs possibles, consultez Types de lieux.

Exemple :

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

Pour PLACES_COUNT_PER_H3, PLACES_COUNT_V2 et PLACES_COUNT_PER_TYPE_V2 uniquement

Spécifie les ID de marque à prendre en compte.

Chaque lieu peut être associé à des ID de marque. Si aucun ID de marque n'est spécifié, toutes les marques (et les lieux non associés à une marque) sont pris en compte dans le résultat.

Remarque : Les données sur les marques ne sont disponibles que dans certains pays. Actuellement : Australie (AU), Canada (CA), États-Unis (US) et Royaume-Uni (GB).

 ARRAY<STRING>

Tableau d'ID de marque. Pour en savoir plus sur les données de marques, consultez Écrire une requête à l'aide de données de marques.

Exemple :

["brand_001", "brand_002"]
min_rating Spécifie la note minimale à prendre en compte pour un lieu.

La note d'un lieu est basée sur les avis des utilisateurs et est comprise entre 1,0 et 5,0.

Si vous spécifiez une note en dehors de cette plage, la fonction renvoie une erreur d'argument non valide.

 FLOAT Entre 1,0 et 5,0.
max_rating

Spécifie la note maximale à prendre en compte pour un lieu.

La note d'un lieu est basée sur les avis des utilisateurs et est comprise entre 1,0 et 5,0.

Si vous spécifiez une note en dehors de cette plage, la fonction renvoie une erreur d'argument non valide.

 FLOAT Entre 1,0 et 5,0.
min_user_rating_count

Spécifie le nombre minimal de notes d'utilisateurs à prendre en compte.

Le nombre de notes des utilisateurs correspond au nombre total d'avis sur un lieu.

La valeur minimale est 0. Si vous spécifiez une valeur inférieure à 0, la fonction renvoie une erreur d'argument non valide.

 INT64 La valeur minimale est 0.
max_user_rating_count

Spécifie le nombre maximal de notes d'utilisateurs à prendre en compte.

Le nombre de notes des utilisateurs correspond au nombre total d'avis sur un lieu.

La valeur minimale est 0. Si vous spécifiez une valeur inférieure à 0, la fonction renvoie une erreur d'argument non valide.

 INT64 La valeur minimale est 0.
price_level

Spécifie les niveaux de prix à prendre en compte.

Vous pouvez spécifier plusieurs niveaux de prix.

 ARRAY<STRING>

Valeurs acceptées :

"PRICE_LEVEL_FREE"

"PRICE_LEVEL_INEXPENSIVE"

"PRICE_LEVEL_MODERATE"

"PRICE_LEVEL_EXPENSIVE"

"PRICE_LEVEL_VERY_EXPENSIVE"

Exemple :

["PRICE_LEVEL_MODERATE","PRICE_LEVEL_EXPENSIVE"]
business_status Spécifie l'état de l'établissement à prendre en compte. Vous pouvez spécifier plusieurs états d'établissement. ARRAY<STRING>

Valeurs acceptées :

"OPERATIONAL"

"CLOSED_TEMPORARILY"

"CLOSED_PERMANENTLY"

"FUTURE_OPENING"

Exemple :

["OPERATIONAL","CLOSED_TEMPORARILY"]
takeout Prend en compte les établissements qui proposent des plats à emporter. BOOLEAN TRUE, FALSE
delivery Prend en compte les établissements qui proposent la livraison. BOOLEAN TRUE, FALSE
dine_in Prend en compte les établissements qui proposent des repas sur place. BOOLEAN TRUE, FALSE
curbside_pickup Prend en compte les établissements qui proposent le retrait au drive. BOOLEAN TRUE, FALSE
reservable Envisagez des lieux où il est possible de réserver. BOOLEAN TRUE, FALSE
outdoor_seating Prend en compte les établissements qui proposent des places en terrasse. BOOLEAN TRUE, FALSE
live_music Prend en compte les lieux qui proposent des concerts. BOOLEAN TRUE, FALSE
allows_dogs Envisagez des lieux où les chiens sont acceptés. BOOLEAN TRUE, FALSE
restroom Prend en compte les lieux qui proposent des toilettes. BOOLEAN TRUE, FALSE
serves_breakfast Prend en compte les établissements qui servent le petit-déjeuner. BOOLEAN TRUE, FALSE
serves_lunch Prend en compte les lieux qui servent le déjeuner. BOOLEAN TRUE, FALSE
serves_dinner Prend en compte les établissements qui servent le dîner. BOOLEAN TRUE, FALSE
serves_beer Prend en compte les établissements qui servent de la bière. BOOLEAN TRUE, FALSE
serves_wine Prend en compte les établissements qui servent du vin. BOOLEAN TRUE, FALSE
serves_brunch Prend en compte les établissements qui servent des brunchs. BOOLEAN TRUE, FALSE
serves_vegetarian_food Prend en compte les établissements qui servent des plats végétariens. BOOLEAN TRUE, FALSE
serves_cocktails Prend en compte les établissements qui servent des cocktails. BOOLEAN TRUE, FALSE
serves_dessert Prend en compte les établissements qui servent des desserts. BOOLEAN TRUE, FALSE
serves_coffee Prend en compte les établissements qui servent du café. BOOLEAN TRUE, FALSE
menu_for_children Prend en compte les établissements qui proposent des menus pour enfants. BOOLEAN TRUE, FALSE
good_for_children Pensez aux lieux adaptés aux enfants. BOOLEAN TRUE, FALSE
good_for_groups Envisagez des lieux adaptés aux groupes. BOOLEAN TRUE, FALSE
good_for_watching_sports Prenez en compte les lieux adaptés pour regarder du sport. BOOLEAN TRUE, FALSE
accepts_credit_cards Envisagez les établissements qui acceptent les cartes de crédit. BOOLEAN TRUE, FALSE
accepts_debit_cards Pensez aux établissements qui acceptent les cartes de débit. BOOLEAN TRUE, FALSE
accepts_cash_only Pensez aux établissements qui n'acceptent que les espèces. BOOLEAN TRUE, FALSE
accepts_nfc Pensez aux établissements qui acceptent les paiements NFC. BOOLEAN TRUE, FALSE
free_parking_lot Prend en compte les lieux disposant d'un parking gratuit. BOOLEAN TRUE, FALSE
paid_parking_lot Prend en compte les lieux disposant d'un parking payant. BOOLEAN TRUE, FALSE
free_street_parking Prend en compte les lieux qui disposent d'un parking gratuit dans la rue. BOOLEAN TRUE, FALSE
paid_street_parking Prend en compte les lieux disposant d'un parking payant dans la rue. BOOLEAN TRUE, FALSE
valet_parking Prend en compte les lieux qui proposent un service de voiturier. BOOLEAN TRUE, FALSE
free_garage_parking Prend en compte les lieux disposant d'un parking couvert sans frais. BOOLEAN TRUE, FALSE
paid_garage_parking Prend en compte les établissements disposant d'un parking couvert payant. BOOLEAN TRUE, FALSE
wheelchair_accessible_parking Prend en compte les lieux disposant d'un parking accessible en fauteuil roulant. BOOLEAN TRUE, FALSE
wheelchair_accessible_entrance Prend en compte les lieux disposant d'une entrée accessible en fauteuil roulant. BOOLEAN TRUE, FALSE
wheelchair_accessible_restroom Prend en compte les lieux disposant de toilettes accessibles en fauteuil roulant. BOOLEAN TRUE, FALSE
wheelchair_accessible_seating Prend en compte les lieux qui proposent des places assises accessibles en fauteuil roulant. BOOLEAN TRUE, FALSE
snapshot_date

Spécifie le mois de l'instantané historique à interroger.

Si aucune valeur n'est spécifiée, la valeur par défaut est l'instantané le plus récent.

 STRING

Format : YYYY-MM.

Exemple : "2026-07"
month1

Pour PLACES_COUNT_CHANGE uniquement

Spécifie le mois de l'instantané de référence à interroger.

 STRING

Format : YYYY-MM.

Exemple : "2026-01"
month2

Pour PLACES_COUNT_CHANGE uniquement

Spécifie le mois de l'instantané de comparaison à interroger.

 STRING

Format : YYYY-MM.

Exemple : "2026-02"
regular_opening_hours

Filtre les lieux en fonction de leurs horaires d'ouverture habituels.

 JSON

Exemple : JSON_OBJECT('monday', [JSON_OBJECT('start_time', '09:00', 'end_time', '12:00')])
min_ev_charge_connector_count

Spécifie le nombre minimal de connecteurs de recharge de VE.

 INT64 La valeur minimale est 0.
max_ev_charge_connector_count

Spécifie le nombre maximal de connecteurs de recharge de VE.

 INT64 La valeur minimale est 0.
max_ev_max_charge_rate_kw

Spécifie le taux de recharge maximal en kW pour les bornes de recharge VE.

 FLOAT64 La valeur minimale est 0.0.
ev_charge_connector_types

Spécifie les types de connecteurs de VE à prendre en compte.

 ARRAY<STRING>

Exemple : ["EV_CONNECTOR_TYPE_TESLA"]