Perché convertire GeoJSON in Shapefile
GeoJSON è il formato che la maggior parte delle mappe web e delle API ti fornisce. Ma molto lavoro di GIS desktop, uffici comunali, aziende di servizi e vecchi progetti ArcGIS si aspettano ancora uno Shapefile. Se invii un file .geojson a queste persone, la risposta di solito è: “puoi darmi uno shapefile?”
I due formati sono costruiti in modo diverso, quindi la conversione è più di un cambio di nome. Uno Shapefile in realtà è un insieme di cinque o sei file che stanno insieme. La geometria sta nel file .shp, un indice nel file .shx, la tabella degli attributi nel file .dbf e il sistema di coordinate nel file .prj. Inoltre uno Shapefile può contenere un solo tipo di geometria, mentre un file GeoJSON può mescolare liberamente punti, linee e poligoni. Questo strumento gestisce queste differenze per te.
Carichi un file GeoJSON e ottieni un solo file .zip. Se i tuoi dati mescolano tipi di geometria, lo zip contiene uno Shapefile per i punti, uno per le linee e uno per i poligoni, quindi nessun elemento va perso. I nomi lunghi delle proprietà vengono accorciati ai 10 caratteri che il formato permette, e il pannello dei risultati ti dice esattamente quali nomi sono cambiati. La conversione gira nel tuo browser, quindi i tuoi dati non lasciano mai il tuo computer.
Il formato Shapefile: storia, struttura e limiti
Esri ha introdotto lo Shapefile all'inizio degli anni '90 per il suo software desktop ArcView. Doveva essere un formato semplice e veloce, leggibile senza un database. Nel luglio 1998 Esri ha pubblicato una descrizione tecnica pubblica, e da allora quasi tutti i programmi GIS, gratuiti o a pagamento, sanno leggerlo e scriverlo. Questa è la ragione principale per cui il formato è ancora ovunque più di 30 anni dopo.
La tabella degli attributi dentro uno Shapefile usa il formato di file dBase III, ancora più vecchio. Da qui vengono i limiti più noti. I nomi dei campi possono avere al massimo 10 caratteri, un valore di testo al massimo 254 byte, e un campo non può contenere dati annidati. Un file .dbf non ha nemmeno un vero tipo per data con ora, quindi molti strumenti le salvano come testo.
Il file della geometria ha limiti propri. Gli offset al suo interno sono numeri a 32 bit, quindi un singolo file .shp o .dbf non può superare circa 2 GB. Ogni file contiene esattamente un tipo di geometria, come punti, polilinee o poligoni. In un poligono l'anello esterno deve andare in senso orario e ogni foro in senso antiorario. GeoJSON (RFC 7946, pubblicato nel 2016) usa l'ordine opposto per gli anelli esterni, quindi un convertitore corretto deve girare gli anelli.
Niente di tutto questo rende lo Shapefile un buon formato per i nuovi progetti. GeoPackage e GeoParquet risolvono la maggior parte di questi limiti. Ma lo Shapefile è ancora il formato che conosce ogni ufficio, ogni ente e ogni corso di GIS, quindi saperne produrre uno pulito in fretta è utile.
Guida passo dopo passo

Scegli un file .geojson dal tuo computer, incolla testo GeoJSON nel riquadro oppure clicca su “Prova l'esempio” per caricare un piccolo esempio tedesco con punti, linee e poligoni.

Controlla il nome del livello. Diventa il nome dei file dentro lo zip e dello zip stesso. Poi clicca su “Converti in Shapefile”. I file tipici finiscono in una frazione di secondo.

Un riepilogo mostra una riga per ogni Shapefile (punti, linee, poligoni), il riquadro di delimitazione, le colonne delle proprietà e i nomi di campo che è stato necessario accorciare.

Gli elementi vengono disegnati sulla mappa così puoi controllare che siano stati convertiti i dati giusti. La mappa parte vuota. Spunta “Mostra mappa di base” se vuoi tessere stradali sotto i dati.

Clicca sul pulsante di download per salvare il file .zip. Decomprimilo e apri il file .shp in QGIS, ArcGIS o un altro programma GIS.
Sei casi d'uso reali
Situazioni in cui serve uno Shapefile anche se i dati sono nati come GeoJSON.
- Inviare dati a un utente ArcGIS. Un collega o un cliente lavora con ArcGIS Desktop e chiede uno Shapefile. Esporti GeoJSON da uno strumento web e lo converti qui in pochi secondi.
- Consegnare dati a un ufficio pubblico. Molti uffici di pianificazione e di rilascio permessi accettano solo Shapefile. Uno zip con i file .shp, .shx, .dbf e .prj è esattamente ciò che chiede il loro modulo di caricamento.
- Usare dati di mappe web in software più vecchio. I programmi di rilievo, i componenti aggiuntivi CAD e alcuni programmi di ingegneria non leggono GeoJSON. Quasi sempre però importano uno Shapefile.
- Sistemare un download da API. Hai scaricato degli elementi da un'API web e vuoi guardarli in un GIS desktop. La conversione in Shapefile ti dà un file standard con un .prj corretto, così il livello si allinea con gli altri tuoi dati.
- Didattica ed esercitazioni. Molti corsi di GIS distribuiscono ancora esercizi in Shapefile. Gli studenti possono esportare i propri dati GeoJSON e convertirli qui senza installare GDAL.
- Passare dati a un team di stampa o cartografia. I cartografi lavorano spesso con strumenti che importano Shapefile di default. Dividere dati misti in file separati di punti, linee e poligoni rende più facile dare uno stile a ogni livello.
Domande e risposte tecniche
Dieci domande frequenti su come funziona questo convertitore, con risposte dirette.
1. Quali file ci sono nello zip che scarico?
Per ogni tipo di geometria ricevi cinque file con lo stesso nome di base. Il file .shp contiene le forme, il file .shx è un indice di dove inizia ogni forma, il file .dbf è la tabella degli attributi, il file .prj indica il sistema di coordinate e il file .cpg dice che il testo è UTF-8. Tienili insieme. Un file .shp da solo non è uno Shapefile completo.
2. Il mio GeoJSON ha punti, linee e poligoni. Cosa succede?
Uno Shapefile può contenere un solo tipo di geometria, quindi il convertitore scrive uno Shapefile per tipo e li mette tutti nello stesso zip. I file hanno un suffisso, per esempio converted_points, converted_lines e converted_polygons. Se i tuoi dati hanno un solo tipo, non c'è alcun suffisso.
3. Quale sistema di coordinate usa il risultato?
WGS 84 con longitudine e latitudine (EPSG:4326). GeoJSON è definito in questo sistema, quindi i numeri vengono copiati così come sono e viene scritto un file .prj corrispondente. Se il tuo GeoJSON usa un altro sistema in modo non standard, riproiettalo prima in WGS 84, perché questo strumento non fa riproiezioni.
4. Perché alcuni nomi dei miei campi sono cambiati?
Il formato dBase dentro uno Shapefile permette solo 10 caratteri per nome di campo. Un nome come population_estimate diventa population, e quando due nomi diventerebbero uguali viene aggiunto un numero, per esempio a_very_lon e a_very_lo1. I caratteri diversi da lettere, cifre e trattini bassi vengono sostituiti con un trattino basso. Il pannello dei risultati elenca ogni modifica.
5. Che fine fanno numeri, valori vero/falso e testo?
Gli interi e i decimali diventano campi numerici, con i decimali impostati al massimo usato da un elemento. I valori vero e falso diventano campi logici. Il testo diventa un campo di caratteri largo quanto il valore più lungo, fino a 254 byte. Se una proprietà mescola tipi, per esempio numeri in alcuni elementi e testo in altri, l'intera colonna viene salvata come testo.
6. Che fine fanno gli oggetti e gli array annidati nelle proprietà?
Una tabella Shapefile è piatta, quindi un oggetto o un array viene scritto come stringa di testo JSON in un campo di caratteri. Puoi rileggerlo con qualsiasi strumento JSON. I valori più lunghi di 254 byte vengono tagliati, e il pannello dei risultati ti dice quanti sono stati tagliati.
7. I fori dei poligoni e il senso degli anelli sono corretti?
Sì. Il convertitore legge l'area con segno di ogni anello e lo gira quando serve, così gli anelli esterni vanno in senso orario e i fori in senso antiorario, come richiede la specifica dello Shapefile. Gli elementi MultiPolygon vengono scritti come un solo record con più anelli esterni e i loro fori.
8. E le coordinate 3D e gli elementi senza geometria?
Vengono scritte solo X e Y, quindi ogni valore di quota (Z) viene scartato, e il pannello dei risultati lo segnala. Gli elementi con geometria nulla o inutilizzabile vengono saltati, e il pannello mostra quanti. Nemmeno le loro proprietà vengono scritte, perché una riga di Shapefile ha bisogno di una forma.
9. Funziona con file grandi?
Funziona bene con file di diverse decine di megabyte, perché tutto il lavoro avviene nella memoria del tuo browser. I file molto grandi possono essere lenti o esaurire la memoria su un telefono. Inoltre un singolo Shapefile non può superare circa 2 GB, che è un limite del formato stesso.
10. Il mio file GeoJSON viene caricato su un server?
No. La lettura, la scrittura dei cinque file e la compressione in zip avvengono tutte nel tuo browser. Il tuo file non lascia mai il tuo dispositivo, e nessuna parte della conversione tocca un server.
Come è costruito lo Shapefile, byte per byte
Nella conversione non c'è nulla di indovinato. Ogni parte dell'output segue una disposizione fissa di byte della specifica Esri. Ecco cosa fa lo strumento con i tuoi dati.
1. Una famiglia di geometria per file
Prima lo strumento legge ogni elemento e assegna la sua geometria a uno di tre gruppi: punti (Point, MultiPoint), linee (LineString, MultiLineString) e poligoni (Polygon, MultiPolygon). Una GeometryCollection viene divisa nelle sue parti, e ogni parte va nel suo gruppo. Ogni gruppo non vuoto diventa il proprio Shapefile con il proprio codice di tipo di forma: 1 per un punto, 8 per un multipunto, 3 per una polilinea e 5 per un poligono.
2. Disposizione di .shp, .shx e .dbf
Il file .shp inizia con un'intestazione di 100 byte. Contiene il codice file 9994, la versione 1000, il tipo di forma e il riquadro di delimitazione. Dopo viene un record per elemento. Ogni record ha un'intestazione di 8 byte (numero del record e lunghezza, entrambi big-endian) e poi il contenuto, la cui dimensione dipende dalla forma. Una polilinea o un poligono con p parti e n punti richiede 4 + 32 + 4 + 4 + 4p + 16n byte di contenuto:
.shp header = 100 bytes: 9994 | file length | 1000 | shape type | bbox record = 8-byte header + content (record number, length in 16-bit words) Point = 4 + 16 = 20 bytes MultiPoint(n) = 4 + 32 + 4 + 16n PolyLine/Polygon(p parts, n points) = 4 + 32 + 4 + 4 + 4p + 16n (r = records, f = fields) .shx = 100 + 8r .dbf = 32 + 32f + 1 | r records of (1 + sum of field widths) | 0x1A
La dimensione è esatta, quindi lo strumento può allocare il buffer una sola volta e scrivere ogni numero con un DataView. Una linea semplice con 3 punti e 1 parte occupa 4 + 32 + 4 + 4 + 4 + 48 = 96 byte di contenuto, più 8 byte di intestazione del record. Il file .shx ripete offset e lunghezza di ogni record, ed è per questo che misura sempre 100 + 8r byte.
3. Girare gli anelli dei poligoni
Il senso di un anello si trova con la formula dell'area di Gauss (shoelace). Per punti (x, y) in ordine, l'area con segno è la somma di (x_prev + x) * (y_prev - y) divisa per 2. Un risultato negativo significa senso orario. GeoJSON vuole gli anelli esterni in senso antiorario, e uno Shapefile li vuole in senso orario, quindi ogni anello esterno con area positiva viene invertito. I fori seguono la regola opposta. Gli anelli vengono anche chiusi se il primo e l'ultimo punto sono diversi.
4. Dimensionare la tabella degli attributi
L'intestazione del .dbf misura 32 + 32f + 1 byte, e ogni riga è un carattere spazio (il flag “non cancellato”) più la larghezza di ogni campo. Per scegliere una larghezza, lo strumento misura ogni valore. Per il testo usa la lunghezza in byte UTF-8 più grande (al massimo 254). Per i numeri usa il maggior numero di cifre prima della virgola, più il maggior numero di decimali trovato, più uno per la virgola e uno per il segno meno se un valore è negativo. Un numero viene scritto con toFixed e riempito a sinistra con spazi fino alla larghezza del campo.
Poiché ogni dimensione viene calcolata prima di scrivere qualsiasi cosa, l'output è deterministico: lo stesso GeoJSON convertito due volte dà gli stessi byte di .shp, .shx e .dbf. Cambia da un giorno all'altro solo la data salvata nell'intestazione del .dbf.
La conversione avviene interamente nel tuo browser. I file Shapefile sono scritti dal codice di questo sito e impacchettati con JSZip. Nessun file viene mai caricato su un server. Mappe di base opzionali © contributori di OpenStreetMap, disegnate con Protomaps (ospitato da KONAKTIVE), con CARTO come riserva.
