Paramètres de filtre

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

La fonction renvoie une erreur d'argument non valide si le nom et la valeur du filtre ne sont pas spécifiés conformément aux exigences ci-dessous.

Nom du filtre Description Type Valeurs autorisé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 marge 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 donc 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 8.
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 les tableaux A et B de la section Types de lieux.

Exemple :

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

primary_types

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 les tableaux A et B de la section Types de lieux.

Exemple :

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

min_rating Spécifie la note minimale du lieu à prendre en compte.

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 du lieu à prendre en compte.

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 attribuées par les 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 de 0.
max_user_rating_count

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

Le nombre de notes attribuées par les 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 de 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"

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 lieux qui proposent des repas sur place. BOOLEAN TRUE, FALSE
curbside_pickup Prend en compte les établissements qui proposent un service de retrait au drive. BOOLEAN TRUE, FALSE
reservable Pensez aux lieux qui peuvent être réservés. BOOLEAN TRUE, FALSE
outdoor_seating Prend en compte les lieux qui proposent des tables en terrasse. BOOLEAN TRUE, FALSE
live_music Prend en compte les lieux qui proposent des concerts. BOOLEAN TRUE, FALSE
allows_dogs Pensez aux 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 lieux 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 lieux 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 lieux qui servent du café. BOOLEAN TRUE, FALSE
menu_for_children Prend en compte les lieux qui proposent des menus pour enfants. BOOLEAN TRUE, FALSE
good_for_children Pensez à des lieux adaptés aux enfants. BOOLEAN TRUE, FALSE
good_for_groups Pensez aux lieux qui conviennent aux groupes. BOOLEAN TRUE, FALSE
good_for_watching_sports Pensez aux lieux où vous pouvez regarder du sport. BOOLEAN TRUE, FALSE
accepts_credit_cards Pensez aux lieux 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 lieux 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 disposant d'un service de voiturier. BOOLEAN TRUE, FALSE
free_garage_parking Prend en compte les établissements qui disposent d'un parking couvert sans frais. BOOLEAN TRUE, FALSE
paid_garage_parking Prend en compte les lieux 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