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:

Il nome del filtro e il relativo 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 di 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 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 di 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 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, 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 m2). 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"]

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 ritiro a bordo strada. BOOLEAN TRUE, FALSE
reservable Considera i luoghi prenotabili. BOOLEAN TRUE, FALSE
outdoor_seating Considera i luoghi che offrono posti a sedere all'aperto. BOOLEAN TRUE, FALSE
live_music Considera i luoghi che offrono musica dal vivo. BOOLEAN TRUE, FALSE
allows_dogs Considera i luoghi che ammettono 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 eventi sportivi. 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 gratuito in strada. BOOLEAN TRUE, FALSE
paid_street_parking Considera i luoghi che dispongono di parcheggio a pagamento in strada. BOOLEAN TRUE, FALSE
valet_parking Considera i luoghi che dispongono di parcheggio con servizio di parcheggio e riconsegna 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 parcheggio a pagamento in garage. 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 posti a sedere accessibili in sedia a rotelle. BOOLEAN TRUE, FALSE