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 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 cercare. È 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 in cui cercare. È 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 prendere in considerazione.

Ogni luogo contiene un insieme di tipi di luoghi, ad esempio "restaurant" e "cafe". Se non vengono specificati tipi, nel risultato vengono presi in considerazione 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 prendere in considerazione.

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 presi in considerazione 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 prendere in considerazione.

Ogni luogo può essere associato a ID brand. Se non vengono specificati ID brand, nel risultato vengono presi in considerazione 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 prendere in considerazione.

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 prendere in considerazione.

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 prendere in considerazione.

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 prendere in considerazione.

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 prendere in considerazione.

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 prendere in considerazione. 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 Prende in considerazione 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 Prende in considerazione i luoghi che offrono il servizio di ritiro all'esterno. BOOLEAN TRUE, FALSE
reservable Prende in considerazione i luoghi prenotabili. BOOLEAN TRUE, FALSE
outdoor_seating Prende in considerazione i luoghi che offrono tavoli all'aperto. BOOLEAN TRUE, FALSE
live_music Prende in considerazione i luoghi che offrono musica dal vivo. BOOLEAN TRUE, FALSE
allows_dogs Prende in considerazione i luoghi in cui sono ammessi i cani. BOOLEAN TRUE, FALSE
restroom Prende in considerazione i luoghi che offrono bagni. 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 Prende in considerazione i luoghi che servono birra. BOOLEAN TRUE, FALSE
serves_wine Prende in considerazione i luoghi che servono vino. BOOLEAN TRUE, FALSE
serves_brunch Prende in considerazione 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 Prende in considerazione i luoghi adatti ai bambini. BOOLEAN TRUE, FALSE
good_for_groups Prende in considerazione i luoghi adatti ai gruppi. BOOLEAN TRUE, FALSE
good_for_watching_sports Prende in considerazione i luoghi adatti per guardare lo sport. BOOLEAN TRUE, FALSE
accepts_credit_cards Prende in considerazione i luoghi che accettano carte di credito. BOOLEAN TRUE, FALSE
accepts_debit_cards Prende in considerazione i luoghi che accettano carte di debito. BOOLEAN TRUE, FALSE
accepts_cash_only Prende in considerazione i luoghi che accettano solo contanti. BOOLEAN TRUE, FALSE
accepts_nfc Prende in considerazione i luoghi che accettano pagamenti NFC. BOOLEAN TRUE, FALSE
free_parking_lot Prende in considerazione i luoghi che dispongono di parcheggio gratuito. BOOLEAN TRUE, FALSE
paid_parking_lot Prende in considerazione i luoghi che dispongono di parcheggio a pagamento. BOOLEAN TRUE, FALSE
free_street_parking Prende in considerazione i luoghi che dispongono di parcheggio in strada senza costi. BOOLEAN TRUE, FALSE
paid_street_parking Prende in considerazione i luoghi che dispongono di parcheggio in strada a pagamento. BOOLEAN TRUE, FALSE
valet_parking Prende in considerazione i luoghi che dispongono di servizio di ritiro e riconsegna dell'auto. BOOLEAN TRUE, FALSE
free_garage_parking Prende in considerazione i luoghi che dispongono di parcheggio gratuito in garage. BOOLEAN TRUE, FALSE
paid_garage_parking Prende in considerazione i luoghi che dispongono di garage a pagamento. BOOLEAN TRUE, FALSE
wheelchair_accessible_parking Prende in considerazione i luoghi che dispongono di parcheggio accessibile in sedia a rotelle. BOOLEAN TRUE, FALSE
wheelchair_accessible_entrance Prende in considerazione i luoghi che dispongono di ingresso accessibile in sedia a rotelle. BOOLEAN TRUE, FALSE
wheelchair_accessible_restroom Prende in considerazione i luoghi che dispongono di bagno accessibile in sedia a rotelle. BOOLEAN TRUE, FALSE
wheelchair_accessible_seating Prende in considerazione i luoghi che dispongono di tavoli accessibili in sedia a rotelle. BOOLEAN TRUE, FALSE