Parametri di filtro

Puoi applicare filtri alle funzioni di conteggio dei luoghi utilizzando i parametri descritti nella tabella riportata di seguito. Tieni presente che i parametri richiesti variano per ogni funzione:

La funzione restituisce un errore di argomento non valido se il nome e il valore del filtro non sono specificati in base ai requisiti riportati di seguito.

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 metri per 40 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 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 metri per 40 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 metri per 40 metri (1600 m2). Ad esempio, per una geografia 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 8.
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, consulta la tabella A e la tabella B in Tipi di luoghi.

Esempio:

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

primary_types

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 luogo.

ARRAY<STRING>

Per l'elenco completo dei valori possibili, consulta la tabella A e la tabella B in Tipi di luoghi.

Esempio:

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

min_rating Specifica la valutazione minima del luogo da considerare.

La valutazione di un luogo si basa sulle recensioni degli utenti e varia 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 e 5.
max_rating

Specifica la valutazione massima del luogo da considerare.

La valutazione di un luogo si basa sulle recensioni degli utenti e varia 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 e 5.
min_user_rating_count

Specifica il conteggio minimo delle valutazioni utente 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 numero massimo di 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 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 considerare. Puoi specificare più stati dell'attività. ARRAY<STRING>

Valori supportati:

"OPERATIONAL"

"CLOSED_TEMPORARILY"

"CLOSED_PERMANENTLY"

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. 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 Prendi in considerazione i luoghi prenotabili. BOOLEAN TRUE, FALSE
outdoor_seating Prende in considerazione i luoghi che offrono posti a sedere all'aperto. BOOLEAN TRUE, FALSE
live_music Prende in considerazione i luoghi che offrono musica dal vivo. BOOLEAN TRUE, FALSE
allows_dogs Prendi in considerazione i luoghi che ammettono 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 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 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 Considera i luoghi che accettano pagamenti NFC. BOOLEAN TRUE, FALSE
free_parking_lot Prende in considerazione i luoghi con parcheggio gratuito. BOOLEAN TRUE, FALSE
paid_parking_lot Prende in considerazione i luoghi che dispongono di un 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 Prende in considerazione i luoghi che dispongono di parcheggio in strada a pagamento. BOOLEAN TRUE, FALSE
valet_parking Prende in considerazione i luoghi che offrono il servizio di parcheggio. 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 parcheggio in garage a pagamento. BOOLEAN TRUE, FALSE
wheelchair_accessible_parking Prende in considerazione 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