Scopri di più sui filtri per tipo

Nell'API Places Aggregate, il filtro del 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 vuoi e tipi che non vuoi, 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 supportati dall'API Places Aggregate, consulta la Tabella A in Tipi di luoghi per l'API Places (New).

Come funzionano i tipi di luoghi

Un luogo può avere più tipi di luoghi:

• Un luogo può avere un singolo 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ò anche specificare 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 principale e secondario, utilizza includedTypes e excludedTypes nella richiesta. Il filtro si applica a entrambi i tipi. Ad esempio, un includedTypes di bar restituisce i luoghi che hanno bar come tipo principale o secondario.

Nota: l'API utilizza un sistema di tipi gerarchico. Se specifichi un tipo nel filtro, vengono inclusi automaticamente tutti i relativi discendenti (sottotipi). Ad esempio, se richiedi gym in includedPrimaryTypes, i risultati includono anche i luoghi con il tipo principale yoga_studio, poiché è un sottotipo di una palestra.

Importante: quando utilizzi più filtri, è importante comprendere l'interazione tra i filtri. In particolare, i luoghi vengono valutati utilizzando la logica OR all'interno dello stesso filtro e la logica AND tra 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 inclusi solo i luoghi 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. Il filtro excludedTypes rimuoverà quindi da questa selezione tutti i luoghi classificati anche come hotel. Di conseguenza, la query restituirà i luoghi che sono restaurant o bar, ma solo se non sono classificati anche come hotel in nessuno dei loro tipi (principale o secondario).