Crea e gestisci un set di dati

Questo prodotto o questa funzionalità è in anteprima (pre-GA). I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Le Offerte pre-GA sono coperte dai Termini di servizio specifici per Google Maps Platform. Per maggiori informazioni, consulta le descrizioni della fase di lancio.

I set di dati consentono di caricare i dati geospaziali da un file locale o da Google Cloud Storage in 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 per le mappe, utilizza l'API per lo stile basato sui dati per definire in modo dinamico lo stile dell'applicazione per le mappe.

Puoi anche utilizzare un'API REST per caricare i dati geospaziali in un set di dati. Per ulteriori informazioni, consulta la pagina relativa all'API Maps Datasets

Configura ruoli

Per creare e gestire set di dati in un progetto Google Cloud, devi disporre del ruolo IAM Proprietario o Editor nel 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 di servizio che utilizzi per gestire i set di dati:

• Il ruolo Maps Platform Datasets Admin concede all'account utente o di servizi 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 di 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 ulteriori informazioni, 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.

Nota: puoi caricare i dati in un set di dati solo una volta. In altre parole, dopo aver eseguito la richiesta per caricare i dati da Cloud Storage o da un file locale, non puoi ricaricare i dati nello stesso set di dati. Se si verifica un errore durante il caricamento, devi ricreare il set di dati e riprovare a eseguire il caricamento.

• Quando carichi i dati da Cloud Storage, specifica il percorso del file della risorsa contenente i dati in Cloud Storage. Il percorso del percorso è 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 ulteriori informazioni sulla gestione dell'accesso a Cloud Storage, consulta la 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 tuo progetto Google Cloud.
• I nomi visualizzati devono contenere meno di 64 byte. Poiché questi caratteri sono rappresentati in formato UTF-8, in alcune lingue ogni carattere può essere rappresentato da più byte.
• Le descrizioni devono essere inferiori a 1000 byte.

Durante il caricamento dei dati:

• I tipi di file supportati sono CSV, GeoJSON e KML.
• Le dimensioni massime supportate per i file sono 350 MB.
• I nomi delle colonne degli attributi non possono iniziare con la stringa "?_".
• Le geometrie tridimensionali non sono supportate. Sono inclusi il suffisso "Z" nel formato WKT e le coordinate di altitudine nel formato GeoJSON.

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

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

Requisiti GeoJSON

L'API Maps JavaScript supporta l'attuale specifica GeoJSON. L'API Maps JavaScript supporta anche i file GeoJSON che contengono uno dei seguenti tipi di oggetti:

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

L'API Maps JavaScript 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

L'API Maps JavaScript prevede i seguenti requisiti:

• Tutti gli URL devono essere locali (o relativi) rispetto al file stesso.
• Geometrie di punti, linee e poligoni supportate.
• Tutti gli attributi dei dati sono considerati stringhe.

Le seguenti funzionalità KML non sono supportate:

• Icone o <styleUrl> definite all'esterno del file.
• Link di rete, ad esempio <NetworkLink>
• Overlay del suolo, ad esempio <GroundOverlay>
• Geometrie 3D o tag correlati all'altitudine come <altitudeMode>
• Specifiche della fotocamera come <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 (testo noto)
• address, city, state e zip
• address
• Una singola colonna contenente tutte le informazioni sull'indirizzo, ad esempio 1600 Amphitheatre Parkway Mountain View, CA 94043

Ad esempio, il tuo file contiene colonne denominate x, y e wkt. Poiché x e y hanno una priorità più elevata, in base all'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. Ciò significa che non puoi avere una colonna denominata xy contenente dati con le coordinate x e 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, possono essere presenti in qualsiasi ordine.

Gestione degli errori di caricamento dei dati

Durante il caricamento dei dati in un set di dati, potresti riscontrare uno degli errori comuni descritti in questa sezione.

Errori GeoJSON

Gli errori più comuni di GeoJSON includono:

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

Errori KML

Gli errori KML più comuni sono:

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

Errori CSV

Gli errori CSV più comuni includono:

• In alcune righe mancano valori per una colonna geometrica. Tutte le righe di un file CSV devono contenere valori non vuoti per le colonne geometriche. Le colonne della geometria includono:
  • latitude, longitude
  • lat, long
  • x, y
  • wkt
  • address, city, state e 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 doppio" o "Impossibile analizzare l'input nell'area geografica.: Valore geografico mancante".
• Se x e y sono le colonne geometriche, 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, l'importazione del set di dati potrebbe essere eseguita correttamente, ma i dati visualizzati 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. Facoltativamente, inserisci una descrizione del set di dati.
5. Fai clic su Continua. Viene visualizzata la pagina Importa dati.
6. Seleziona l'origine di caricamento dei dati utilizzati per completare il set di dati come Desktop, 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, in cui viene mostrato il nuovo set di dati. Lo stato dovrebbe essere In elaborazione.
10. Attendi che lo stato del set di dati sia Completato.

Visualizzare o modificare un set di dati

Dopo aver creato correttamente un set di dati, lo stato visualizzato sarà Completato. Puoi quindi esaminare i dettagli del set di dati.

Per visualizzare il set di dati:

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 del 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.
   3. Fai clic sulla scheda Dati tabella per visualizzare un sottoinsieme dei dati associati al set di dati.
   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.