Inizia a utilizzare l'analisi geospaziale

---

Questo tutorial introduce l'analisi geospaziale. Le analisi geospaziali ti consentono di analizzare e visualizzare i dati geospaziali in BigQuery.

Obiettivi

In questo tutorial:

• Utilizza una funzione di analisi geospaziale per convertire le colonne di latitudine e longitudine in punti geografici
• Esegui una query che trovi tutte le stazioni Citi Bike con più di 30 biciclette disponibili per il noleggio
• Visualizza i risultati in BigQuery Geo Viz

Costi

Questo tutorial utilizza i componenti fatturabili di Google Cloud, tra cui BigQuery.

Ti vengono addebitati costi per:

• Eseguire query sui dati nei set di dati pubblici di BigQuery.
  • Il primo terabyte al mese è gratuito.
  • Se utilizzi i prezzi basati sulla capacità, i costi delle query sono inclusi nel prezzo basato sulla capacità.

Prima di iniziare

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. BigQuery viene attivato automaticamente nei nuovi progetti. Per attivare BigQuery in un progetto esistente, vai a

   Enable the BigQuery API.

   Enable the API

Esplora i dati di esempio

Questo tutorial utilizza un set di dati disponibile tramite il programma per i set di dati pubblici di Google Cloud. Un set di dati pubblico è qualsiasi set di dati archiviato in BigQuery e messo a disposizione del pubblico in generale. I set di dati pubblici sono set di dati ospitati da BigQuery per consentirti di accedervi e integrarli nelle tue applicazioni. Google sostiene le spese per lo spazio in cui sono archiviati questi set di dati e fornisce l'accesso pubblico ai dati utilizzando un progetto. Paghi solo per le query che effettui sui dati (il primo TB al mese è gratuito, in base ai dettagli dei prezzi delle query).

Il set di dati NYC Citi Bike Trips

Citi Bike di New York City

Citi Bike è il più grande programma di bike sharing del paese, con 10.000 biciclette e 600 stazione a Manhattan, Brooklyn, Queens e Jersey City. Questo set di dati include le corse su Citi Bike dal lancio del servizio a settembre 2013 e viene aggiornato quotidianamente. I dati vengono elaborati da Citi Bike per rimuovere i viaggi effettuati dal personale per la manutenzione e l'ispezione del sistema, nonché i viaggi di durata inferiore a 60 secondi, che sono considerati falsi avvii.

Puoi iniziare a esplorare questi dati nella console BigQuery visualizzando i dettagli della tabella citibike_stations:

Vai allo schema citibike_stations

Tre colonne di questa tabella sono pertinenti per questo tutorial:

• bike_stations.longitude: la longitudine di una stazione. I valori sono longitudini WGS 84 valide in formato gradi decimali.
• bike_stations.latitude: la latitudine di una stazione. I valori sono latitudini WGS 84 valide in formato gradi decimali.
• num_bikes_available: il numero di biciclette disponibili per il noleggio.

Esegui una query sulle stazioni di biciclette con più di 30 biciclette disponibili

In questa sezione del tutorial esegui una query GoogleSQL che trova tutte le stazione Citi Bike di New York con più di 30 biciclette disponibili per il noleggio.

Dettagli query

La seguente query GoogleSQL viene utilizzata per trovare le stazioni Citi Bike con più di 30 biciclette.

SELECT
  ST_GeogPoint(longitude, latitude)  AS WKT,
  num_bikes_available
FROM
  `bigquery-public-data.new_york.citibike_stations`
WHERE num_bikes_available > 30

Le clausole di query eseguono le seguenti operazioni:

• SELECT ST_GeogPoint(longitude, latitude) AS WKT, num_bikes_available

  La clausola SELECT seleziona la colonna num_bikes_available e utilizza la funzione ST_GeogPoint per convertire i valori nelle colonne latitude e longitude in tipi GEOGRAPHY (punti).

• FROM `bigquery-public-data.new_york.citibike_stations`

  La clausola FROM specifica la tabella su cui viene eseguita la query: citibike_stations.

• WHERE num_bikes_available > 30

  La clausola WHERE filtra i valori nella colonna num_bikes_available in modo da visualizzare solo le stazioni con più di 30 biciclette.

Esegui la query

Per eseguire la query utilizzando la console Google Cloud:

1. Vai alla pagina BigQuery nella console Google Cloud.

   Vai alla pagina BigQuery

2. Inserisci la seguente query GoogleSQL nell'area di testo Editor query.

   -- Finds Citi Bike stations with > 30 bikes
   SELECT
     ST_GeogPoint(longitude, latitude)  AS WKT,
     num_bikes_available
   FROM
     `bigquery-public-data.new_york.citibike_stations`
   WHERE num_bikes_available > 30

3. Fai clic su Esegui.

   Il completamento della query richiede un istante. Al termine dell'esecuzione della query, i risultati vengono visualizzati nel riquadro Risultati query.

   

Visualizzare i risultati della query in Geo Viz

Successivamente, visualizzi i risultati utilizzando BigQuery Geo Viz: uno strumento web per la visualizzazione dei dati geospaziali in BigQuery utilizzando le API di Google Maps.

Avvia Geo Viz ed esegui l'autenticazione

Prima di utilizzare Geo Viz, devi autenticarti e concedere l'accesso ai dati in BigQuery.

Per configurare Geo Viz:

1. Apri lo strumento web Geo Viz.

   Apri lo strumento web Geo Viz

   Potresti dover attivare i cookie per autorizzare e utilizzare questo strumento.

2. Nel passaggio 1, Query, fai clic su Autorizza.

   

3. Nella finestra di dialogo Scegli un account, fai clic sul tuo Account Google.

   

4. Nella finestra di dialogo di accesso, fai clic su Consenti per concedere a Geo Viz l'accesso ai tuoi dati BigQuery.

   

Esegui una query GoogleSQL sui dati geospaziali

Dopo aver eseguito l'autenticazione e concesso l'accesso, il passaggio successivo consiste nell'eseguire la query in Geo Viz.

Per eseguire la query:

1. Per il primo passaggio, Seleziona dati, inserisci il tuo ID progetto nel campo ID progetto.

2. Nella finestra della query, inserisci la seguente query GoogleSQL.

   -- Finds Citi Bike stations with > 30 bikes
   SELECT
     ST_GeogPoint(longitude, latitude)  AS WKT,
     num_bikes_available
   FROM
     `bigquery-public-data.new_york.citibike_stations`
   WHERE num_bikes_available > 30

3. Fai clic su Esegui.

4. Al termine della query, fai clic su Mostra risultati. Puoi anche fare clic sul secondo passaggio Definisci colonne.

   

5. Verrà visualizzato il passaggio 2. Nel passaggio 2, per Colonna geometria, scegli WKT. Vengono tracciati i punti corrispondenti alle stazioni di biciclette sulla mappa.

   

Formattare la visualizzazione

La sezione Stile fornisce un elenco di stili visivi per la personalizzazione. Alcune proprietà si applicano solo a determinati tipi di dati. Ad esempio, circleRadius incide solo sui punti.

Le proprietà di stile supportate includono:

• fillColor. Il colore di riempimento di un poligono o di un punto. Ad esempio, le funzioni "lineare" o "intervallo" possono essere utilizzate per mappare i valori numerici a un gradiente di colore.
• fillOpacity. L'opacità del riempimento di un poligono o di un punto. I valori devono essere in un intervallo compreso tra 0 e 1, dove 0 = trasparente e 1 = opaco.
• strokeColor. Il colore del tratto o del contorno di un poligono o di una linea.
• strokeOpacity. L'opacità del tratto o del contorno del poligono o della linea. I valori devono essere compresi nell'intervallo da 0 a 1, dove 0 = trasparente e 1 = opaco.
• strokeWeight. La larghezza del tratto o del contorno in pixel di un poligono o di una linea.
• circleRadius. Il raggio del cerchio che rappresenta un punto in pixel. Ad esempio, una funzione "lineare" può essere utilizzata per mappare i valori numerici alle dimensioni dei punti per creare uno stile di grafico a dispersione.

A ogni stile può essere assegnato un valore globale (applicato a ogni risultato) o un valore basato sui dati (applicato in modi diversi a seconda dei dati in ogni riga del risultato). Per i valori basati sui dati, per determinare il risultato vengono utilizzati i seguenti elementi:

• funzione. Una funzione utilizzata per calcolare un valore di stile dai valori di un campo.
• identity. Il valore dei dati di ogni campo viene utilizzato come valore di stile.
• categoria. I valori dei dati di ogni campo elencato nel dominio vengono mappati uno a uno agli stili corrispondenti nell'intervallo.
• interval. I valori dei dati di ogni campo vengono arrotondati per difetto al valore più vicino nel dominio e poi formattati con lo stile corrispondente nell'intervallo.
• linear. I valori dei dati di ogni campo vengono interpolati in modo lineare tra i valori del dominio e poi stilizzati con una combinazione degli stili corrispondenti nell'intervallo.
• campo. Il campo specificato nei dati viene utilizzato come input per la funzione di stile.
• domain. Un elenco ordinato di valori di input di esempio di un campo. Gli input di esempio (dominio) vengono accoppiati con gli output di esempio (intervallo) in base alla funzione specificata e vengono utilizzati per dedurre i valori di stile per tutti gli input (anche quelli non elencati nel dominio). I valori nel dominio devono avere lo stesso tipo (testo, numero e così via) dei valori del campo che stai visualizzando.
• intervallo. Un elenco di valori di output di esempio per la regola di stile. I valori dell'intervallo devono avere lo stesso tipo (colore o numero) della proprietà di stile che controlli. Ad esempio, l'intervallo della proprietà fillColor deve contenere solo colori.

Per formattare la mappa:

1. Fai clic su Aggiungi stili nel secondo passaggio o sul passaggio 3 Stile.

2. Cambia il colore dei punti. Fai clic su fillColor.

3. Nel campo Valore, inserisci #0000FF, il codice colore HTML per il blu.

4. Fai clic su Applica stile.

   

5. Esamina la mappa. Se fai clic su uno dei tuoi punti, viene visualizzato il valore.

   

6. Fai clic su fillOpacity.

7. Nel campo Valore, inserisci 0.5 e fai clic su Applica stile.

   

8. Esamina la mappa. Il colore di riempimento dei punti è ora semitrasparente.

   

9. Modifica le dimensioni dei punti in base al numero di biciclette disponibili. Fai clic su circleRadius.

10. Nel riquadro circleRadius:

    1. Fai clic su In base ai dati.
    2. Per Funzione, scegli lineare.
    3. In Campo, scegli num_bikes_available.
    4. In Dominio, inserisci 30 nella prima casella e 60 nella seconda.

    5. In Intervallo, inserisci 5 nella prima casella e 20 nella seconda.

       

11. Esamina la mappa. Il raggio di ogni cerchio ora corrisponde al numero di biciclette disponibili in quella località.

    

12. Chiudi Geo Viz.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, elimina il progetto che contiene le risorse oppure mantieni il progetto ed elimina le singole risorse.

• Puoi eliminare il progetto che hai creato.
• In alternativa, puoi conservare il progetto per un uso futuro.

Per eliminare il progetto:

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per le attività descritte in questo documento, quando lo elimini elimini anche tutto il lavoro svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più architetture, tutorial o guide rapide, il riuso dei progetti può aiutarti a non superare i limiti di quota.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Passaggi successivi

• Per scoprire di più sulle opzioni di visualizzazione per l'analisi geospaziale, consulta Visualizzare i dati geospaziali.
• Per scoprire di più sull'utilizzo dei dati di analisi geospaziali, consulta Utilizzare i dati geospaziali.
• Per un tutorial sull'utilizzo dell'analisi geospaziale, consulta Utilizzare l'analisi geospaziale per tracciare il percorso di un uragano.
• Per la documentazione sulle funzioni GoogleSQL nell'analisi geospaziale, consulta Funzioni geografiche in GoogleSQL.