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 sono pensati per consentirti di provare Places Insights in modo da poter 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 i dati relativi alla città stessa. Non contiene dati relativi all'area metropolitana circostante.

La scheda di esempio include i dati di una città principale per ciascuno dei paesi supportati:

Amsterdam (NL) Helsinki (FI) Plovdiv (BG)
Ankara (TR) Hong Kong (HK) Riffa (BH)
Arequipa (PE) Giacarta (ID) Roma (IT)
Atene (GR) Gedda (SA) Santiago (CL)
Bad Gastein (AT) Johannesburg (ZA) San Paolo (BR)
Berlino (DE) Kuala Lumpur (MY) Sharjah (AE)
Brno (CZ) Lisbona (PT) Singapore (SG)
Bruxelles (BE) Londra (GB) Stoccolma (SE)
Bucarest (RO) Lusail (QA) Sydney (AU)
Buenos Aires (AR) Madrid (ES) Taipei (TW)
Busan (KR) Manila (PH) Tel Aviv-Yafo (IL)
Cairo (EG) Medellín (CO) Tokyo (JP)
Chiang Mai (TH) Città del Messico (MX) Toronto (CA)
Copenaghen (DK) Mumbai (IN) Varsavia (PL)
Cork (IE) New York (Stati Uniti) Wellington (NZ)
Debrecen (HU) Oslo (NO) Zurigo (CH)
Hanoi (VN) Parigi (FR)

I set di dati completi includono i dati per ogni paese supportato e devono essere acquistati. Se ti interessa registrarti a Places Insights, 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 iscriverti separatamente. Per saperne di più sulla sottoscrizione di una scheda, consulta Configura 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 di base sia allo schema specifico per la Spagna.

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

  • id: l'ID del brand.
  • name: il nome del brand, ad esempio "Hertz" o "Chase".
  • category: la categoria di alto livello del brand, ad esempio "Stazione di servizio", "Cibo e bevande" o "Alloggio".

Esegui query sui dati di Places Insights

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

  • Esegui query direttamente sul set di dati 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 personalizzate 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 Places Count: le funzioni Places Count 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, ad esempio restituendo gli ID luogo per cercare i dettagli di singoli luoghi. Consulta la documentazione.

Query dirette

L'esecuzione di query direttamente sui dati applica una soglia di aggregazione. Viene restituito un risultato 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 area restituirà una risposta solo se il conteggio totale è pari o superiore a 5, altrimenti non verrà restituita alcuna risposta.

Query della funzione Places Count

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

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

Quando eseguire query direttamente sui dati e quando utilizzare le funzioni

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

Esegui una query utilizzando le funzioni se hai bisogno di sapere se i risultati sono pochi o nulli o se devi recuperare informazioni su singoli luoghi, come il nome o l'indirizzo.

Questa tabella fornisce un confronto dettagliato delle differenze tra le query dirette e le funzioni Places Count.

Funzioni Places Count Query dirette sui set di dati
Vantaggi
  • Restituisce gli ID luogo che possono essere utilizzati per eseguire query su altre API.
  • Può restituire qualsiasi numero.
  • Ottimizzato per le prestazioni e un costo di elaborazione ridotto.
  • 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 avanzati e join.
  • Non applica un'area di ricerca minima.
  • Supporta funzioni aggregate aggiuntive oltre a COUNT, come AVG, SUM e GROUP BY.
Interfaccia Quattro funzioni SQL predefinite che generano insight su 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 codice SQL per eseguire funzioni di aggregazione come COUNT, COUNT_IF, SUM e AVG.. Puoi generare ulteriori insight utilizzando JOIN, GROUP BY, WHERE e altri.
Restrizioni Forza un'area di ricerca minima di 40,0 x 40,0 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 dai risultati (ovvero la riga viene esclusa).
Filtri degli attributi di supporto supportati I parametri di filtro della funzione Places Count supportano gli stessi filtri degli attributi di query diretta, ad eccezione di:
  • id luogo
  • Componenti dell'indirizzo
Schema completo supportato.