Scopri di più sui filtri per tipo

Nell'API Places Aggregate, il filtro tipo ti aiuta a concentrare la ricerca consentendoti di scegliere i tipi di luoghi da includere o escludere dalla risposta. Puoi creare elenchi di tipi che ti interessano e di tipi che non ti interessano, sia per la categoria principale di un luogo sia per gli altri dettagli. In questo modo, puoi creare ricerche specifiche per trovare esattamente i luoghi che stai cercando.

Sono disponibili oltre 200 tipi di luoghi. Per un elenco completo dei tipi di luoghi supportati dall'API Places Aggregate, consulta la tabella A nella sezione Tipi di luoghi per l'API Places (New).

Come funzionano i tipi di luogo

Un luogo può avere più tipi di luogo:

• Un luogo può avere un unico tipo principale che riflette la sua funzione principale. Tuttavia, in alcuni casi, il tipo principale potrebbe non essere specificato per un luogo.

• Un luogo può avere uno o più tipi secondari. I tipi secondari sono categorie aggiuntive che si applicano a un luogo per fornire informazioni supplementari sulle caratteristiche e sui servizi del luogo.

Ad esempio, un luogo potrebbe specificare il tipo principale come restaurant, ma poiché funge anche da bar e fornisce servizi di ristorazione, può specificare anche i tipi di luoghi secondari come bar, food e establishment.

Filtra per tipo

Per filtrare i luoghi in base al tipo principale, utilizza includedPrimaryTypes e excludedPrimaryTypes nella richiesta. Il filtro si applica solo al tipo principale di un luogo. Ad esempio, un filtro includedPrimaryTypes per restaurant restituisce solo i luoghi che funzionano principalmente come ristoranti.

Per filtrare i luoghi in base ai tipi primario e secondario, utilizza includedTypes e excludedTypes nella richiesta. Il filtro si applica a entrambi i tipi. Ad esempio, un includedTypes di bar restituisce luoghi che hanno bar come tipo principale o secondario.

Importante:quando utilizzi più filtri, è importante comprendere l'interazione tra loro. In particolare, i luoghi vengono valutati utilizzando la logica OR all'interno dello stesso filtro e la logica AND in filtri diversi.

• All'interno di un filtro (logica OR): ad esempio, includedTypes: restaurant, bar significa che il luogo può essere un restaurant o un bar.
• Tra i filtri (logica AND): tutti i criteri di filtro specificati devono essere soddisfatti contemporaneamente. Ciò significa che ogni filtro aggiunge un livello di restrizione alla query e nei risultati verranno incluse solo le località che soddisfano tutte le condizioni.

Ad esempio, se imposti includedTypes: restaurant, bar e excludedTypes: hotel, il filtro includedTypes selezionerà tutti i luoghi classificati come restaurant o bar. In secondo luogo, il filtro excludedTypes rimuoverà da questa selezione tutti i luoghi classificati anche come hotel. Di conseguenza, la query restituirà luoghi che sono restaurant o bar, ma solo se non sono classificati anche come hotel in nessuno dei loro tipi (principale o secondario).