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 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 della città stessa. Non contiene dati per l'area metropolitana circostante.
L'elenco di esempio include i dati di una delle principali città per ognuno dei paesi supportati:
| Amsterdam (Paesi Bassi) | Helsinki (Finlandia) | Plovdiv (Bulgaria) |
| Ankara (Turchia) | Hong Kong (Hong Kong) | Riffa (Bahrain) |
| Arequipa (Perù) | Giacarta (Indonesia) | Roma (Italia) |
| Atene (Grecia) | Gedda (Arabia Saudita) | Santiago (Cile) |
| Bad Gastein (Austria) | Johannesburg (Sudafrica) | San Paolo (Brasile) |
| Berlino (Germania) | Kuala Lumpur (Malesia) | Sharjah (Emirati Arabi Uniti) |
| Brno (Repubblica Ceca) | Lisbona (Portogallo) | Singapore (Singapore) |
| Bruxelles (Belgio) | Londra (Regno Unito) | Stoccolma (Svezia) |
| Bucarest (Romania) | Lusail (Qatar) | Sydney (Australia) |
| Buenos Aires (Argentina) | Madrid (Spagna) | Taipei (Taiwan) |
| Busan (Corea del Sud) | Manila (Filippine) | Tel Aviv-Yafo (Israele) |
| Il Cairo (Egitto) | Medellín (Colombia) | Tokyo (Giappone) |
| Chiang Mai (Thailandia) | Città del Messico (Messico) | Toronto (Canada) |
| Copenaghen (Danimarca) | Mumbai (India) | Varsavia (Polonia) |
| Cork (Irlanda) | New York (Stati Uniti) | Wellington (Nuova Zelanda) |
| Debrecen (Ungheria) | Oslo (Norvegia) | Zurigo (Svizzera) |
| Hanoi (Vietnam) | Parigi (Francia) |
I set di dati completi includono i dati di 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 abbonarti separatamente. Per ulteriori informazioni su come abbonarti a una scheda, consulta Configurare Places Insights.
Schemi dei set di dati
Lo schema del set di dati dei luoghi per ogni paese è composto da due parti:
- Lo schema principale comune ai set di dati di tutti i paesi.
- Uno schema specifico per paese che definisce i componenti dello schema specifici per quel paese.
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 del 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 "Alloggi".
Eseguire query sui dati di Places Insights
Places Insights offre due modi per eseguire query sui set di dati:
- Eseguire query sul set di dati direttamente utilizzando SQL: esegui query SQL standard di BigQuery
sulle tabelle del set di dati. In questo modo hai la massima flessibilità per filtri complessi, unioni con i tuoi dati, analisi personalizzate e supporto per funzioni di aggregazione aggiuntive oltre a
COUNT, comeAVG,SUMeGROUP BY. Consulta la documentazione. - Eseguire 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, ad esempio restituendo gli ID luogo per cercare i dettagli dei singoli luoghi. Consulta la documentazione.
Query dirette
L'esecuzione di query dirette sui dati applica una soglia di aggregazione. Un risultato viene restituito solo se la query aggrega almeno 5 luoghi. Ad esempio, se i criteri di ricerca restituiscono un conteggio pari a 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 delle funzioni di conteggio dei luoghi
Le funzioni di conteggio dei luoghi possono restituire un elenco di ID luogo, che possono essere utilizzati per cercare le informazioni sui singoli luoghi utilizzando altri prodotti GMP come l'API Places e Places UI Kit.
Le funzioni di conteggio dei luoghi non applicano una soglia di aggregazione, ma invece applicano un'area di ricerca minima di 40,0 metri per 40,0 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 dirette sui dati e quando utilizzare le funzioni
Esegui query dirette sui dati se non hai bisogno di conteggi dei risultati bassi, se vuoi ottenere approfondimenti oltre ai conteggi, come AVG, SUM o COUNTIF, o se devi eseguire query più complesse come l'unione di set di dati.
Esegui query utilizzando le funzioni se devi sapere se sono presenti un numero ridotto o zero risultati oppure se devi recuperare informazioni sui singoli luoghi, come 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 |
|
|
| 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 approfondimenti aggiuntivi utilizzando JOIN, GROUP BY, WHERE e altri. |
| Restrizioni | Applica un'area di ricerca minima di 40,0 metri per 40,0 metri (1600 m2). Una funzione restituisce un risultato anche se il conteggio di 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 supportati | I parametri di filtro della funzione di conteggio dei luoghi supportano gli stessi filtri degli attributi delle query dirette, ad eccezione di:
|
Schema completo supportato. |