Creare e gestire un set di dati

Seleziona la piattaforma: Android iOS JavaScript

I set di dati ti consentono di caricare dati geospaziali da un file locale o da Google Cloud Storage su Google Maps Platform. Puoi quindi associare un set di dati a uno o più stili di mappa nella console Cloud. Dopo aver associato il set di dati a uno stile di mappa, utilizza l'API di stili basati sui dati per applicare dinamicamente lo stile alla tua applicazione Maps.

Puoi anche utilizzare un'API REST per caricare i dati geospaziali in un set di dati. Per saperne di più, consulta l'API Maps Datasets.

Configurare i ruoli

Per creare e gestire set di dati in un progetto Google Cloud, devi disporre del ruolo IAM Proprietario o Editor per il progetto.

Nota: se hai creato il progetto, disponi del ruolo Proprietario per il progetto. La pagina IAM della console Google Cloud mostra i proprietari e gli editor del progetto.

In alternativa, puoi assegnare i seguenti ruoli IAM a un account utente o service account che utilizzi per gestire i set di dati:

• Il ruolo Maps Platform Datasets Admin concede all'utente o all'account di servizio l'accesso in lettura/scrittura ai set di dati nel progetto. Questo ruolo consente all'utente di eseguire tutte le operazioni su un set di dati.
• Il ruolo Maps Platform Datasets Viewer concede l'accesso in sola lettura ai set di dati nel progetto. Questo ruolo consente di eseguire un'operazione di elenco, recupero o download su un set di dati.

Per saperne di più, consulta Concedere un ruolo IAM utilizzando la console Google Cloud.

Origine dati per un set di dati

Dopo aver creato un set di dati, carica i dati nel set di dati da Google Cloud Storage o da un file locale.

• Quando carichi i dati da Cloud Storage, specifica il percorso del file della risorsa contenente i dati in Cloud Storage. Questo percorso ha il formato gs://GCS_BUCKET/FILE.

  L'utente che effettua la richiesta richiede il ruolo Visualizzatore oggetti Storage o qualsiasi altro ruolo che includa l'autorizzazione storage.objects.get. Per maggiori informazioni sulla gestione dell'accesso a Cloud Storage, consulta Panoramica del controllo dell'accesso.

• Quando carichi i dati da un file locale, specifica il percorso del file GeoJSON, KML o CSV contenente i dati da caricare.

Prerequisiti

Quando crei un set di dati:

• I nomi visualizzati devono essere univoci all'interno del progetto Google Cloud.
• I nomi visualizzati devono contenere meno di 64 byte (poiché questi caratteri sono rappresentati in UTF-8, in alcune lingue ogni carattere può essere rappresentato da più byte).
• Le descrizioni devono contenere meno di 1000 byte.

Quando carichi i dati:

• I tipi di file supportati sono CSV, GeoJSON e KML.
• La dimensione massima supportata per i file è 500 MB.
• I nomi delle colonne degli attributi non possono iniziare con la stringa "?_".
• Le geometrie tridimensionali non sono supportate. Ciò include il suffisso "Z" nel formato WKT e la coordinata di altitudine nel formato GeoJSON.

Nota: a seconda delle dimensioni del file di dati, il caricamento può richiedere minuti o persino ore. Se si verifica un errore durante il caricamento, riceverai un messaggio di errore. Non tentare di eliminare il set di dati finché non viene restituita una risposta dall'operazione di caricamento.

Nota: le tessere della mappa create con i dati caricati utilizzando l'API Maps Datasets potrebbero eliminare o semplificare i dati densi o complessi a livelli di zoom bassi. Ad esempio, quando un utente esegue lo zoom indietro fino a visualizzare uno stato o un paese (ad esempio, livello di zoom 5-12), i dati in formato tile potrebbero avere un aspetto diverso rispetto a quando esegue lo zoom avanti fino a visualizzare una città o un quartiere (ad esempio, livello di zoom 13-18). Ciò avviene per mantenere i riquadri snelli e performanti utilizzando quelli con un renderer della mappa.

Suggerimento: se il file di dati è di grandi dimensioni e contiene molti attributi che non ti servono per lo stile e vuoi ottimizzare le prestazioni di rendering, modifica il file per rimuovere gli attributi non necessari. La riduzione del numero di attributi riduce le dimensioni dei riquadri della mappa, migliorando così le prestazioni di rendering.

Best practice per la preparazione dei dati

Se i dati di origine sono complessi o di grandi dimensioni, ad esempio punti densi, linestring o poligoni lunghi (spesso i file di origine di dimensioni superiori a 50 MB rientrano in questa categoria), valuta la possibilità di semplificare i dati prima di caricarli per ottenere il miglior rendimento in una mappa visiva.

Di seguito sono riportate alcune best practice per preparare i dati:

1. Ridurre al minimo le proprietà delle funzionalità. Conserva solo le proprietà delle funzionalità necessarie per lo stile della mappa, ad esempio "id" e "category". Puoi unire proprietà aggiuntive a una funzionalità in un'applicazione client utilizzando stili basati sui dati su una chiave identificatore univoca. Ad esempio, consulta Visualizzare i dati in tempo reale con gli stili basati sui dati.
2. Utilizza tipi di dati semplici per gli oggetti delle proprietà, ad esempio numeri interi, per ridurre al minimo le dimensioni dei riquadri e migliorare il rendimento della mappa.
3. Semplifica le geometrie complesse prima di caricare un file. Puoi farlo in uno strumento geospaziale a tua scelta, ad esempio l'utilità open source Mapshaper.org o in BigQuery utilizzando ST_Simplify su geometrie poligonali complesse.
4. Raggruppa i punti molto densi prima di caricare un file. Puoi farlo in uno strumento geospaziale a tua scelta, ad esempio le funzioni di clustering turf.js open source, oppure in BigQuery utilizzando ST_CLUSTERDBSCAN su geometrie di punti densi.

Consulta ulteriori indicazioni sulle best practice per i set di dati in Visualizzare i dati con i set di dati e BigQuery.

Requisiti GeoJSON

Maps SDK for iOS supporta l'attuale specifica GeoJSON. L'SDK Maps per iOS supporta anche i file GeoJSON che contengono uno dei seguenti tipi di oggetti:

• Oggetti geometrici. Un oggetto geometria è una forma spaziale, descritta come un'unione di punti, linee e poligoni con fori facoltativi.
• Oggetti delle funzionalità. Un oggetto funzionalità contiene una geometria più coppie nome/valore aggiuntive, il cui significato è specifico dell'applicazione.
• Raccolte di funzionalità. Una raccolta di caratteristiche è un insieme di oggetti caratteristica.

L'SDK Maps per iOS non supporta i file GeoJSON con dati in un sistema di riferimento delle coordinate (CRS) diverso da WGS84.

Per ulteriori informazioni su GeoJSON, consulta la pagina Conforme a RFC 7946.

Requisiti KML

Maps SDK for iOS presenta i seguenti requisiti:

• Tutti gli URL devono essere locali (o relativi) al file stesso.
• Sono supportate le geometrie di punti, linee e poligoni.
• Tutti gli attributi dei dati vengono considerati stringhe.

Le seguenti funzionalità KML non sono supportate:

• Icone o <styleUrl> definiti al di fuori del file.
• Link di rete, ad esempio <NetworkLink>
• Overlay del suolo, ad esempio <GroundOverlay>
• Geometrie 3D o tag correlati all'altitudine, ad esempio <altitudeMode>
• Specifiche della videocamera, ad esempio <LookAt>
• Stili definiti all'interno del file KML.

Requisiti CSV

Per i file CSV, i nomi delle colonne supportati sono elencati di seguito in ordine di priorità:

• latitude, longitude
• lat, long
• x, y
• wkt (Well-Known Text)
• address, city, state, zip
• address
• Una singola colonna contenente tutte le informazioni sull'indirizzo, ad esempio 1600 Amphitheatre Parkway Mountain View, CA 94043

Ad esempio, il file contiene colonne denominate x, y e wkt. Poiché x e y hanno una priorità più alta, come determinato dall'ordine dei nomi delle colonne supportati nell'elenco precedente, vengono utilizzati i valori nelle colonne x e y e la colonna wkt viene ignorata.

Inoltre:

• Ogni nome di colonna deve appartenere a una sola colonna. ovvero non puoi avere una colonna denominata xy che contenga sia dati delle coordinate x che y. Le coordinate x e y devono trovarsi in colonne separate.
• I nomi delle colonne non fanno distinzione tra maiuscole e minuscole.
• L'ordine dei nomi delle colonne non è importante. Ad esempio, se il file CSV contiene le colonne lat e long, queste possono essere visualizzate in qualsiasi ordine.

Gestire gli errori di caricamento dei dati

Quando carichi dati in un set di dati, potresti riscontrare uno degli errori comuni descritti in questa sezione.

Errori GeoJSON

Gli errori comuni di GeoJSON includono:

• Campo type mancante o type non è una stringa. Il file di dati GeoJSON caricato deve contenere un campo stringa denominato type come parte di ogni definizione di oggetto Feature e oggetto Geometry.

Errori KML

Gli errori KML comuni includono:

• Il file di dati non deve contenere nessuna delle funzionalità KML non supportate elencate sopra, altrimenti l'importazione dei dati potrebbe non riuscire.

Errori CSV

Gli errori comuni dei file CSV includono:

• In alcune righe mancano i valori per una colonna di geometria. Tutte le righe di un file CSV devono contenere valori non vuoti per le colonne della geometria. Le colonne di geometria includono:
  • latitude, longitude
  • lat, long
  • x, y
  • wkt
  • address, city, state, zip
  • address
  • Una singola colonna contenente tutte le informazioni sull'indirizzo, ad esempio 1600 Amphitheatre Parkway Mountain View, CA 94043
  Nota : questo errore è spesso descritto da un messaggio nel formato "Impossibile convertire ' ' in un valore double" o "Impossibile analizzare l'input in geografia". value is missing".
• Se x e y sono le colonne della geometria, assicurati che le unità siano longitudine e latitudine. Alcuni set di dati pubblici utilizzano sistemi di coordinate diversi nelle intestazioni x e y. Se vengono utilizzate unità errate, il set di dati potrebbe essere importato correttamente, ma i dati sottoposti a rendering possono mostrare i punti del set di dati in posizioni impreviste.

Crea un set di dati

Per creare un set di dati:

1. Nella console Google Cloud, vai alla pagina Set di dati.
2. Fai clic su Crea set di dati.
3. Inserisci il nome del set di dati. Il nome deve essere univoco tra tutti i set di dati.
4. (Facoltativo) Inserisci una descrizione del set di dati.
5. Fai clic su Continua. Viene visualizzata la pagina Importa dati.
6. Seleziona Carica origine dei dati utilizzati per popolare il set di dati come Computer, ovvero un file locale sul tuo sistema, o Bucket Google Cloud Storage.
   • Per Computer, fai clic su Sfoglia e seleziona il file dal selettore di file.
   • Per Bucket Google Cloud Storage, fai clic su Sfoglia e seleziona il bucket e il file contenenti i dati.
7. Seleziona il Formato file.
8. Fai clic su Continua per rivedere le impostazioni.

9. Fai clic su Crea. Viene visualizzata la pagina Set di dati che mostra il nuovo set di dati. Lo stato deve essere Elaborazione.

   Se il caricamento dei dati va a buon fine:

   • Lo stato del set di dati è impostato su COMPLETATO.
   • Il set di dati diventa la versione "attiva" ed è la versione utilizzata dalla tua app.

   Se si verifica un errore nel caricamento:

   • Lo stato della nuova versione del set di dati è impostato su un valore diverso da COMPLETATO.

Visualizzare o modificare un set di dati

Dopo aver creato un set di dati, puoi visualizzarlo o modificarlo:

1. Nella console Google Cloud, vai alla pagina Set di dati.
2. Fai clic sul nome del set di dati. Viene visualizzata la pagina Dettagli set di dati.
   1. Fai clic sulla scheda Dettagli per visualizzare le informazioni sul set di dati. In questa scheda puoi anche modificare il nome e la descrizione del set di dati.
   2. Fai clic sulla scheda Anteprima per visualizzare il set di dati su una mappa (solo i set di dati con stato COMPLETATO o RIPRISTINATO).
   3. Fai clic sulla scheda Dati tabella per visualizzare tutti gli attributi del set di dati (solo i set di dati con stato COMPLETATO o RIPRISTINATO). Questi sono gli attributi che puoi utilizzare per applicare uno stile al set di dati sulla mappa.
   4. Fai clic sul pulsante Scarica per scaricare i dati in un file locale.
   5. Fai clic sul pulsante Elimina per eliminare il set di dati.

   6. Fai clic sul pulsante Importa file di dati per caricare nuovi dati nel set di dati.

      Il caricamento di nuovi dati nel set di dati crea una nuova versione del set di dati. Se i nuovi dati vengono caricati correttamente:

      • Lo stato della nuova versione del set di dati è impostato su COMPLETATO.
      • La nuova versione diventa la versione "attiva" ed è quella utilizzata dalla tua app.

      Se si verifica un errore nel caricamento:

      • Lo stato della nuova versione del set di dati è impostato su un valore diverso da COMPLETATO. Ad esempio, se esiste una versione "attiva" precedente, lo stato del set di dati viene impostato su REVERTED.
      • La versione del set di dati precedentemente "attiva" rimane tale ed è la versione utilizzata dalla tua app.