Informazioni su dati e query di Places Insights

Dati di Places Insights

Places Insights fornisce set di dati completi e di esempio in BigQuery.

I set di dati di esempio ti consentono di provare Places Insights per valutare l'usabilità e il valore del prodotto prima di decidere di acquistare il set di dati completo. Il set di dati di esempio contiene solo dati relativi alla città stessa. Non contiene dati per l'area metropolitana circostante.

L'elenco di esempio include i dati di una città principale per ciascuno dei paesi supportati: Sydney (AU), San Paolo (BR), Toronto (CA), Zurigo (CH), Berlino (DE), Madrid (ES), Parigi (FR), Londra (UK), Giacarta (ID), Mumbai (IN), Roma (IT), Tokyo (JP), Città del Messico (MX), New York City (US).

I set di dati completi includono i dati per ogni paese supportato e devono essere acquistati. Se ti interessa acquistare il set di dati completo, compila il modulo di richiesta. Solo l'abbonato ai dati deve richiedere l'accesso al set di dati di Places Insights. Una volta attivato l'abbonamento in un progetto BigQuery, qualsiasi utente con accesso a quel progetto può eseguire query sui dati di Places Insights.

Ogni set di dati per paese ha una propria scheda a cui devi abbonarti separatamente. Per ulteriori informazioni su come abbonarsi a una scheda, vedi Configurare Places Insights.

Schemi dei set di dati

Lo schema del set di dati dei luoghi per ogni paese è composto da due parti:

Ad esempio, se lavori con il set di dati per la Spagna (ES), fai riferimento sia allo schema principale sia allo schema specifico per ES.

Lo schema per il set di dati sui brand definisce tre campi:

  • id: l'ID brand.
  • name: il nome del brand, ad esempio "Hertz" o "Chase".
  • category: La categoria di primo livello del brand, ad esempio "Stazione di servizio", "Cibi e bevande" o "Alloggi".

Eseguire query sui dati di Places Insights

Places Insights offre due modi per eseguire query sui set di dati:

  • Esegui query sul set di dati direttamente utilizzando SQL: esegui query SQL BigQuery standard sulle tabelle del set di dati. In questo modo, hai la massima flessibilità per filtri complessi, unione con i tuoi dati, analisi personalizzata e supporto per funzioni di aggregazione aggiuntive oltre a COUNT, come AVG, SUM e GROUP BY. Consulta la documentazione.
  • Esegui query sul set di dati utilizzando le funzioni di conteggio dei luoghi: le funzioni di conteggio dei luoghi sono query SQL predefinite e ottimizzate che vengono eseguite direttamente in BigQuery e semplificano le attività comuni di recupero dei dati. Forniscono approfondimenti più granulari, come la restituzione degli ID luogo per cercare i dettagli sulle singole località. Consulta la documentazione.

Query dirette

L'esecuzione di query sui dati applica direttamente una soglia di aggregazione. Un risultato viene restituito solo se la query aggrega almeno 5 luoghi. Ad esempio, se il risultato dei criteri di ricerca è un conteggio di 0, 1, 2, 3 o 4, il risultato viene omesso dalla risposta. Ad esempio, una query per il conteggio totale dei ristoranti in una determinata zona restituirà una risposta solo se il conteggio totale è pari a 5 o superiore, altrimenti non verrà restituita alcuna risposta.

Esegui query della funzione di conteggio dei luoghi

Le funzioni di conteggio dei luoghi possono restituire un elenco di ID luogo, che possono essere utilizzati per cercare informazioni sui singoli luoghi utilizzando altri prodotti GMP come l'API Places e il Places UI Kit.

Le funzioni di conteggio dei luoghi non applicano una soglia di aggregazione, ma un'area di ricerca minima di 40 metri per 40 metri (1600 m2). Ciò significa che, finché la query di ricerca è più grande dell'area di ricerca minima, otterrai sempre un risultato, anche se non ci sono luoghi che corrispondono alla query.

Quando eseguire query sui dati direttamente e quando utilizzare le funzioni

Esegui query sui dati direttamente se non hai bisogno di conteggi dei risultati bassi, se vuoi ottenere approfondimenti oltre ai conteggi, ad esempio AVG, SUM o COUNTIF, o se devi eseguire query più complesse, ad esempio unire set di dati.

Esegui query utilizzando le funzioni se devi sapere se il numero di risultati è basso o pari a zero oppure se devi recuperare informazioni sui singoli luoghi, ad esempio il nome o l'indirizzo.

Questa tabella fornisce un confronto dettagliato delle differenze tra le query dirette e le funzioni di conteggio dei luoghi.

Funzioni di conteggio dei luoghi Query dirette sui set di dati
Vantaggi
  • Restituisce gli ID luogo che possono essere utilizzati per eseguire query su altre API.
  • Può restituire qualsiasi conteggio.
  • Ottimizzato per prestazioni e costi di elaborazione ridotti.
  • Semplice da usare. Non è necessario scrivere query complesse.
  • Convalida i parametri di input e restituisce un errore, semplificando l'utilizzo e il debug.
  • Consente query complesse come filtri e unioni avanzati.
  • Non impone un'area di ricerca minima.
  • Supporta funzioni di aggregazione aggiuntive oltre a COUNT, come AVG, SUM e GROUP BY.
Interfaccia Quattro funzioni SQL predefinite che generano approfondimenti COUNT: conteggio singolo, conteggio per tipo, conteggio per area geografica, conteggio per cella H3. Un JSON_OBJECT passa gli argomenti alla funzione. Scrivi il tuo SQL per eseguire funzioni di aggregazione come COUNT, COUNT_IF, SUM e AVG.. È possibile generare ulteriori approfondimenti utilizzando JOIN, GROUP BY, WHERE e altri.
Restrizioni Impone un'area di ricerca minima di 40 metri per 40 metri (1600 m2). Una funzione restituisce un risultato anche se il conteggio dell'aggregazione è inferiore a 5, purché venga soddisfatta l'area di ricerca minima. I risultati con conteggi inferiori a 5 vengono omessi (ovvero la riga viene esclusa).
Filtri degli attributi supportati I parametri del filtro della funzione di conteggio dei luoghi supportano gli stessi filtri degli attributi della query diretta, ad eccezione di:
  • Luogo id
  • Componenti dell'indirizzo
  • Orari di apertura
  • Opzioni di ricarica EV
  • Brand
 Schema completo supportato.