Parametri di filtro

Puoi applicare i filtri alle funzioni di conteggio dei luoghi utilizzando i parametri descritti nella tabella riportata di seguito. Tieni presente che i parametri obbligatori variano a seconda della funzione:

• PLACES_COUNT: richiede geography
• PLACES_COUNT_PER_TYPE: richiede geography e type
• PLACES_COUNT_PER_GEO: richiede geographies
• PLACES_COUNT_PER_H3: richiede geography e h3_resolution

Il nome del filtro e il suo valore fanno distinzione tra maiuscole e minuscole. Devi specificarli esattamente come appaiono nella tabella. In caso contrario, la query restituirà un errore di argomento non valido.

Nome filtro	Descrizione	Tipo	Valori supportati
geography	Per PLACES_COUNT, PLACES_COUNT_PER_TYPE e PLACES_COUNT_PER_H3 Specifica un'area in cui effettuare la ricerca. È supportato qualsiasi tipo di GEOGRAPHY, ad esempio Point, LineString e Polygon. Puoi utilizzare il parametro geography in combinazione con geography_radius per aggiungere un buffer all'area di ricerca. Viene applicata un'area di ricerca minima di 40,0 metri per 40,0 metri (1600 m^2). Se specifichi un'area di ricerca inferiore a questo limite, la funzione restituisce un errore di argomento non valido.	GEOGRAPHY	Qualsiasi tipo di GEOGRAPHY.
geographies	Solo per PLACES_COUNT_PER_GEO Specifica un elenco di aree in cui effettuare la ricerca. È supportato qualsiasi tipo di GEOGRAPHY, ad esempio Point, LineString e Polygon. Puoi utilizzare il parametro geographies in combinazione con geography_radius per aggiungere un buffer all'area di ricerca. Il buffer viene aggiunto a tutte le località geografiche specificate. Viene applicata un'area di ricerca minima di 40,0 metri per 40,0 metri (1600 m^2). Se specifichi un'area di ricerca inferiore a questo limite, la funzione restituisce un errore di argomento non valido.	ARRAY<GEOGRAPHY>	Qualsiasi tipo di GEOGRAPHY.
geography_radius	Aggiunge un raggio o un buffer, in metri, alla località geografica specificata. Il valore predefinito è 0. Il valore specificato deve definire un'area di ricerca minima di 40,0 metri per 40,0 metri (1600 m^2). Ad esempio, per una località geografica Point, il raggio minimo è quindi di 23 metri.	INT64	Il valore minimo è 0.
h3_resolution	Solo per PLACES_COUNT_PER_H3 La risoluzione H3 utilizzata per aggregare il conteggio dei luoghi nelle celle H3.	INT64	Tra 0 e 11.
types	Specifica i tipi di luoghi da considerare. Ogni luogo contiene un insieme di tipi di luoghi, ad esempio "restaurant" e "cafe". Se non vengono specificati tipi, nel risultato vengono considerati tutti i tipi di luoghi.	ARRAY<STRING>	Per l'elenco completo dei valori possibili, vedi Tipi di luoghi. Esempio: ["restaurant", "cafe", "bar"]
primary_type	Specifica i tipi principali da considerare. Un luogo può avere un solo tipo principale, ovvero il tipo che descrive meglio la località. Se non vengono specificati tipi principali, nel risultato vengono considerati tutti i tipi principali di luoghi.	ARRAY<STRING>	Per l'elenco completo dei valori possibili, vedi Tipi di luoghi. Esempio: ["restaurant", "cafe", "bar"]
brand_ids	Solo per PLACES_COUNT_PER_H3, PLACES_COUNT_V2 e PLACES_COUNT_PER_TYPE_V2 Specifica gli ID brand da considerare. Ogni luogo può essere associato a ID brand. Se non vengono specificati ID brand, nel risultato vengono considerati tutti i brand (e i luoghi non correlati al brand). Nota: i dati sui brand sono supportati solo in alcuni paesi. Attualmente: Stati Uniti (US), Canada (CA), Regno Unito (GB) e Australia (AU).	ARRAY<STRING>	Un array di ID brand. Per saperne di più sui dati sui brand, vedi Scrivere una query utilizzando i dati sui brand. Esempio: ["brand_001", "brand_002"]
min_rating	Specifica la valutazione minima del luogo da considerare. La valutazione dei luoghi si basa sulle recensioni degli utenti del luogo e ha un intervallo compreso tra 1,0 e 5,0. Se specifichi una valutazione al di fuori di questo intervallo, la funzione restituisce un errore di argomento non valido.	FLOAT	Tra 1,0 e 5,0.
max_rating	Specifica la valutazione massima del luogo da considerare. La valutazione dei luoghi si basa sulle recensioni degli utenti del luogo e ha un intervallo compreso tra 1,0 e 5,0. Se specifichi una valutazione al di fuori di questo intervallo, la funzione restituisce un errore di argomento non valido.	FLOAT	Tra 1,0 e 5,0.
min_user_rating_count	Specifica il conteggio minimo delle valutazioni degli utenti da considerare. Il conteggio delle valutazioni degli utenti è il numero totale di recensioni di un luogo. Il valore minimo è 0. Se specifichi un valore inferiore a 0, la funzione restituisce un errore di argomento non valido.	INT64	Il valore minimo è 0.
max_user_rating_count	Specifica il conteggio massimo delle valutazioni degli utenti da considerare. Il conteggio delle valutazioni degli utenti è il numero totale di recensioni di un luogo. Il valore minimo è 0. Se specifichi un valore inferiore a 0, la funzione restituisce un errore di argomento non valido.	INT64	Il valore minimo è 0.
price_level	Specifica i livelli di prezzo da considerare. Puoi specificare più livelli di prezzo.	ARRAY<STRING>	Valori supportati: "PRICE_LEVEL_FREE" "PRICE_LEVEL_INEXPENSIVE" "PRICE_LEVEL_MODERATE" "PRICE_LEVEL_EXPENSIVE" "PRICE_LEVEL_VERY_EXPENSIVE" Esempio: ["PRICE_LEVEL_MODERATE","PRICE_LEVEL_EXPENSIVE"]
business_status	Specifica lo stato dell'attività da considerare. Puoi specificare più stati dell'attività.	ARRAY<STRING>	Valori supportati: "OPERATIONAL" "CLOSED_TEMPORARILY" "CLOSED_PERMANENTLY" "FUTURE_OPENING" Esempio: ["OPERATIONAL","CLOSED_TEMPORARILY"]
takeout	Considera i luoghi che offrono cibo da asporto.	BOOLEAN	TRUE, FALSE
delivery	Considera i luoghi che offrono la consegna a domicilio.	BOOLEAN	TRUE, FALSE
dine_in	Considera i luoghi che offrono la consumazione sul posto.	BOOLEAN	TRUE, FALSE
curbside_pickup	Considera i luoghi che offrono il servizio di ritiro all'esterno.	BOOLEAN	TRUE, FALSE
reservable	Considera i luoghi prenotabili.	BOOLEAN	TRUE, FALSE
outdoor_seating	Considera i luoghi che offrono tavoli all'aperto.	BOOLEAN	TRUE, FALSE
live_music	Considera i luoghi che offrono musica dal vivo.	BOOLEAN	TRUE, FALSE
allows_dogs	Considera i luoghi in cui sono ammessi i cani.	BOOLEAN	TRUE, FALSE
restroom	Considera i luoghi che offrono bagni.	BOOLEAN	TRUE, FALSE
serves_breakfast	Considera i luoghi che servono la colazione.	BOOLEAN	TRUE, FALSE
serves_lunch	Considera i luoghi che servono il pranzo.	BOOLEAN	TRUE, FALSE
serves_dinner	Considera i luoghi che servono la cena.	BOOLEAN	TRUE, FALSE
serves_beer	Considera i luoghi che servono birra.	BOOLEAN	TRUE, FALSE
serves_wine	Considera i luoghi che servono vino.	BOOLEAN	TRUE, FALSE
serves_brunch	Considera i luoghi che servono il brunch.	BOOLEAN	TRUE, FALSE
serves_vegetarian_food	Considera i luoghi che servono cibo vegetariano.	BOOLEAN	TRUE, FALSE
serves_cocktails	Considera i luoghi che servono cocktail.	BOOLEAN	TRUE, FALSE
serves_dessert	Considera i luoghi che servono dessert.	BOOLEAN	TRUE, FALSE
serves_coffee	Considera i luoghi che servono caffè.	BOOLEAN	TRUE, FALSE
menu_for_children	Considera i luoghi che offrono menu per bambini.	BOOLEAN	TRUE, FALSE
good_for_children	Considera i luoghi adatti ai bambini.	BOOLEAN	TRUE, FALSE
good_for_groups	Considera i luoghi adatti ai gruppi.	BOOLEAN	TRUE, FALSE
good_for_watching_sports	Considera i luoghi adatti per guardare lo sport.	BOOLEAN	TRUE, FALSE
accepts_credit_cards	Considera i luoghi che accettano carte di credito.	BOOLEAN	TRUE, FALSE
accepts_debit_cards	Considera i luoghi che accettano carte di debito.	BOOLEAN	TRUE, FALSE
accepts_cash_only	Considera i luoghi che accettano solo contanti.	BOOLEAN	TRUE, FALSE
accepts_nfc	Considera i luoghi che accettano pagamenti NFC.	BOOLEAN	TRUE, FALSE
free_parking_lot	Considera i luoghi che dispongono di parcheggio gratuito.	BOOLEAN	TRUE, FALSE
paid_parking_lot	Considera i luoghi che dispongono di parcheggio a pagamento.	BOOLEAN	TRUE, FALSE
free_street_parking	Considera i luoghi che dispongono di parcheggio in strada senza costi.	BOOLEAN	TRUE, FALSE
paid_street_parking	Considera i luoghi che dispongono di parcheggio in strada a pagamento.	BOOLEAN	TRUE, FALSE
valet_parking	Considera i luoghi che dispongono di parcheggio con ritiro e riconsegna dell'auto.	BOOLEAN	TRUE, FALSE
free_garage_parking	Considera i luoghi che dispongono di parcheggio gratuito in garage.	BOOLEAN	TRUE, FALSE
paid_garage_parking	Considera i luoghi che dispongono di garage a pagamento.	BOOLEAN	TRUE, FALSE
wheelchair_accessible_parking	Considera i luoghi che dispongono di parcheggio accessibile in sedia a rotelle.	BOOLEAN	TRUE, FALSE
wheelchair_accessible_entrance	Considera i luoghi che dispongono di ingresso accessibile in sedia a rotelle.	BOOLEAN	TRUE, FALSE
wheelchair_accessible_restroom	Considera i luoghi che dispongono di bagno accessibile in sedia a rotelle.	BOOLEAN	TRUE, FALSE
wheelchair_accessible_seating	Considera i luoghi che dispongono di tavoli accessibili in sedia a rotelle.	BOOLEAN	TRUE, FALSE