Parametri di filtro

Puoi applicare filtri alle funzioni Places Count utilizzando i parametri descritti nella tabella seguente. Tieni presente che i parametri richiesti variano per ogni funzione:

Il nome del filtro e il relativo valore sono sensibili alle maiuscole. 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 eseguire 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 x 40,0 metri (1600 m2). 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 eseguire 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 aree geografiche specificate.

Viene applicata un'area di ricerca minima di 40,0 x 40,0 metri (1600 m2). 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, all'area geografica specificata. Il valore predefinito è 0.

Il valore specificato deve definire un'area di ricerca minima di 40,0 x 40,0 metri (1600 m2). Ad esempio, per un'area geografica Point, il raggio minimo è 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, consulta 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, consulta 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 dei brand, consulta Scrivi una query utilizzando i dati dei brand.

Esempio:

["brand_001", "brand_002"]
min_rating Specifica la valutazione minima del luogo da considerare.

La valutazione di un luogo si basa sulle recensioni degli utenti 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 di un luogo 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 numero minimo di valutazioni degli utenti da considerare.

Il numero di 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 numero massimo di valutazioni degli utenti da considerare.

Il numero di 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 Prende in considerazione 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 Prende in considerazione 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 Prendi in considerazione 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 Prendi in considerazione i luoghi in cui sono ammessi i cani. BOOLEAN TRUE, FALSE
restroom Prende in considerazione i luoghi che offrono servizi igienici. BOOLEAN TRUE, FALSE
serves_breakfast Prende in considerazione i luoghi che servono la colazione. BOOLEAN TRUE, FALSE
serves_lunch Prende in considerazione i luoghi che servono il pranzo. BOOLEAN TRUE, FALSE
serves_dinner Prende in considerazione 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 Prende in considerazione i luoghi che servono cibo vegetariano. BOOLEAN TRUE, FALSE
serves_cocktails Prende in considerazione i luoghi che servono cocktail. BOOLEAN TRUE, FALSE
serves_dessert Prende in considerazione i luoghi che servono dessert. BOOLEAN TRUE, FALSE
serves_coffee Prende in considerazione i luoghi che servono caffè. BOOLEAN TRUE, FALSE
menu_for_children Prende in considerazione i luoghi che offrono menu per bambini. BOOLEAN TRUE, FALSE
good_for_children Prendi in considerazione luoghi adatti ai bambini. BOOLEAN TRUE, FALSE
good_for_groups Prendi in considerazione i luoghi adatti ai gruppi. BOOLEAN TRUE, FALSE
good_for_watching_sports Prendi in considerazione i luoghi adatti per guardare sport. BOOLEAN TRUE, FALSE
accepts_credit_cards Prendi in considerazione i luoghi che accettano carte di credito. BOOLEAN TRUE, FALSE
accepts_debit_cards Prendi in considerazione i luoghi che accettano carte di debito. BOOLEAN TRUE, FALSE
accepts_cash_only Prendi in considerazione i luoghi che accettano solo contanti. BOOLEAN TRUE, FALSE
accepts_nfc Prendi in considerazione 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 Prende in considerazione i luoghi con parcheggio in strada senza costi. BOOLEAN TRUE, FALSE
paid_street_parking Considera i luoghi con parcheggio in strada a pagamento. BOOLEAN TRUE, FALSE
valet_parking Considera i luoghi che offrono il servizio di ritiro e riconsegna dell'auto. BOOLEAN TRUE, FALSE
free_garage_parking Prende in considerazione i luoghi con parcheggio in garage senza costi. BOOLEAN TRUE, FALSE
paid_garage_parking Prende in considerazione i luoghi con garage a pagamento. BOOLEAN TRUE, FALSE
wheelchair_accessible_parking Considera i luoghi con parcheggio accessibile in sedia a rotelle. BOOLEAN TRUE, FALSE
wheelchair_accessible_entrance Prende in considerazione i luoghi con ingresso accessibile in sedia a rotelle. BOOLEAN TRUE, FALSE
wheelchair_accessible_restroom Prende in considerazione i luoghi con toilette accessibile in sedia a rotelle. BOOLEAN TRUE, FALSE
wheelchair_accessible_seating Prende in considerazione i luoghi con tavoli accessibili in sedia a rotelle. BOOLEAN TRUE, FALSE
snapshot_date

Specifica il mese dello snapshot storico su cui eseguire la query.

Se omesso, il valore predefinito è lo snapshot più recente.

 STRING

Formato: YYYY-MM.

Esempio: "2026-07"
month1

Solo per PLACES_COUNT_CHANGE

Specifica il mese dello snapshot di riferimento su cui eseguire la query.

 STRING

Formato: YYYY-MM.

Esempio: "2026-01"
month2

Solo per PLACES_COUNT_CHANGE

Specifica il mese dello snapshot di confronto su cui eseguire la query.

 STRING

Formato: YYYY-MM.

Esempio: "2026-02"
regular_opening_hours

Filtra i luoghi in base al loro orario di apertura regolare.

 JSON

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

Specifica il numero minimo di connettori di ricarica per EV.

 INT64 Il valore minimo è 0.
max_ev_charge_connector_count

Specifica il numero massimo di connettori di ricarica per EV.

 INT64 Il valore minimo è 0.
max_ev_max_charge_rate_kw

Specifica la velocità di ricarica massima in kW per le stazioni di ricarica EV.

 FLOAT64 Il valore minimo è 0,0.
ev_charge_connector_types

Specifica i tipi di connettori EV da considerare.

 ARRAY<STRING>

Esempio: ["EV_CONNECTOR_TYPE_TESLA"]