Cosa fa questo strumento
I file GeoParquet non sono leggibili dall'uomo. A differenza di GeoJSON, non è possibile aprirne uno in un editor di testo e vedere le coordinate, e la maggior parte degli strumenti GIS desktop di uso comune non apre ancora il formato direttamente. Questo crea un divario tra avere un file .parquet e sapere davvero cosa contiene: quanti elementi, quale tipo di geometria, quali colonne, quale area copre.
Questo visualizzatore colma quel divario. Trascina un file e lo strumento legge il contenitore Parquet, controlla i metadati GeoParquet del file per trovare la colonna di geometria e la sua codifica, decodifica ogni valore WKB (Well-Known Binary) riportandolo a coordinate reali e disegna il risultato su una mappa. Fai clic su qualsiasi elemento per vedere la sua tabella completa degli attributi, regola il colore e lo stile per rendere più facili da vedere i pattern, ed esporta tutto di nuovo come file GeoJSON quando ti serve un formato che più strumenti già capiscono. Nessun file viene caricato da nessuna parte: il lettore Parquet è una build WebAssembly che funziona interamente sul tuo computer.
Come il visualizzatore legge un file GeoParquet
Il processo si svolge in tre fasi. Prima, una build WebAssembly della libreria Parquet in Rust legge i dati grezzi delle colonne e li restituisce come tabella Apache Arrow, lo stesso formato in memoria usato internamente da GeoPandas e DuckDB. Poi, il visualizzatore legge i metadati dello schema della tabella cercando una chiave chiamata "geo", il piccolo blocco JSON che ogni file GeoParquet porta con sé e che indica la colonna di geometria principale, ne dichiara la codifica ed elenca i tipi di geometria presenti. Se questa chiave manca, il file è un semplice Parquet, non GeoParquet, e il visualizzatore lo segnala invece di tirare a indovinare.
Terzo, il visualizzatore scorre ogni riga della colonna di geometria, che contiene valori WKB grezzi in byte, e decodifica ciascuno riportandolo a coordinate: un byte di flag per l'ordine dei byte, un codice di quattro byte per il tipo di geometria, poi le coordinate stesse come coppie di numeri a 8 byte. Lo stesso decodificatore riconosce anche il flag SRID che PostGIS aggiunge alla sua uscita EWKB e i marcatori di dimensione Z/M dello standard ISO WKB, quindi anche i file esportati da un database spaziale vengono letti correttamente. Le proprietà in ogni altra colonna vengono lette allo stesso modo in cui Arrow già le memorizza e vengono associate a ciascun elemento, e l'insieme diventa una FeatureCollection GeoJSON standard pronta per essere disegnata sulla mappa.
Guida passo passo
Fai clic su "Upload" e scegli un file .parquet, trascinane uno sulla mappa, oppure fai clic su "Sample Data" per caricare un piccolo esempio già pronto.
Il file viene decodificato interamente nel tuo browser. Il pannello File Info mostra il numero di elementi, il tipo di geometria, il nome della colonna di geometria, il CRS e la dimensione del file, presi direttamente dai metadati del file stesso.
Fai clic su qualsiasi punto, linea o poligono sulla mappa per aprire un popup con l'elenco di tutte le proprietà memorizzate per quell'elemento.
Usa il pannello Style per cambiare il colore, lo spessore delle linee e l'opacità del riempimento applicati a ogni elemento sulla mappa.
Fai clic su "Download as GeoJSON" per esportare ogni elemento decodificato come file GeoJSON standard.
Casi d'uso reali
Dove aprire direttamente un file GeoParquet, senza scrivere codice, aiuta davvero.
- Controllo rapido dell'output di una pipeline di dati. Se uno script o un processo ETL scrive file GeoParquet, trascinare l'ultimo output direttamente in questo visualizzatore è un modo veloce per confermare che geometria e attributi siano corretti prima di fidarsi del file più a valle.
- Esplorare un dataset aperto prima di scrivere codice. Dataset come Overture Maps o le raccolte su Source Cooperative vengono distribuiti come GeoParquet. Scaricare un piccolo estratto e visualizzarlo qui mostra esattamente quali colonne e tipi di geometria contiene, prima di configurare DuckDB o GeoPandas.
- Verificare una conversione da GeoJSON a GeoParquet. Dopo aver convertito un file con uno strumento come il convertitore da GeoJSON a GeoParquet di questo sito, caricare di nuovo il risultato in questo visualizzatore conferma che il processo ha preservato correttamente ogni elemento e proprietà.
- Rivedere i dati prima di pubblicarli come open data. I team municipali e di ricerca pubblicano sempre più spesso GeoParquet insieme a GeoJSON. Un rapido controllo visivo qui individua problemi evidenti, come una colonna di geometria vuota o un bounding box nell'emisfero sbagliato, prima che il file venga pubblicato.
- Insegnare o dimostrare il formato GeoParquet. Poiché il pannello delle informazioni sul file mostra la colonna di geometria principale, il CRS e la codifica direttamente dai metadati del file, questo è un modo comodo per mostrare a studenti o colleghi cosa contiene davvero un file GeoParquet.
- Recuperare dati utilizzabili da un file quando non si ha a disposizione un altro visualizzatore. Non tutti gli strumenti GIS desktop leggono ancora GeoParquet. Quando serve solo vedere subito cosa c'è in un file .parquet, o estrarlo di nuovo come GeoJSON per uno strumento che capisce solo quel formato, questo evita di dover installare qualsiasi cosa.
Domande frequenti
Che tipo di file posso aprire qui?
Qualsiasi file che segua la specifica GeoParquet: un normale file Apache Parquet con una chiave di metadati "geo" a livello di schema che descrive una colonna di geometria. Funzionano i file prodotti da GeoPandas, dall'estensione spaziale di DuckDB, da ogr2ogr, da Apache Sedona o dal convertitore da GeoJSON a GeoParquet di questo stesso sito.
Quale codifica di geometria supporta il visualizzatore?
WKB (Well-Known Binary), che è la codifica predefinita e di gran lunga la più comune usata oggi dai file GeoParquet. GeoParquet 1.1 definisce anche codifiche Arrow native separate per ogni tipo di geometria; i file che le usano non sono ancora supportati, e il visualizzatore te lo segnala chiaramente se ne incontra uno.
Supporta file di Punti, Linee e Poligoni, incluse le geometrie multi-parte?
Sì. Point, LineString, Polygon, MultiPoint, MultiLineString e MultiPolygon vengono tutti decodificati correttamente, inclusi i file che mescolano più di un tipo di geometria nella stessa colonna.
Cosa succede alle coordinate 3D (Z) o misurate (M)?
Il lettore riconosce sia lo stile EWKB di PostGIS sia lo stile ISO WKB per contrassegnare le dimensioni Z e M, e salta correttamente quei valori extra così che il resto della geometria venga comunque decodificato. Poiché l'output GeoJSON e la mappa sono intrinsecamente 2D, vengono mantenuti per la visualizzazione solo X e Y.
Come fa il visualizzatore a sapere quale colonna contiene la geometria?
Legge il campo "primary_column" dai metadati "geo" del file, che ogni file GeoParquet valido deve includere. È anche così che il visualizzatore riporta il CRS e conferma la codifica prima di tentare di decodificare qualsiasi cosa.
Cosa succede se il mio file non ha alcun metadato "geo"?
Allora è un semplice file Parquet, non un file GeoParquet, e il visualizzatore lo segnala invece di tirare a indovinare. Una colonna di geometria senza metadati associati potrebbe essere WKB, WKT o qualcos'altro, quindi non c'è modo sicuro di decodificarla automaticamente.
C'è un limite alla dimensione del file?
I caricamenti sono limitati a 100 MB. I file molto grandi possono anche essere lenti da visualizzare sulla mappa perché ogni elemento diventa un layer Leaflet; per file con centinaia di migliaia di righe, la prima visualizzazione può richiedere alcuni secondi.
Posso recuperare i miei dati come GeoJSON?
Sì. Il pulsante "Download as GeoJSON" esporta ogni elemento decodificato, geometria e proprietà incluse, come una FeatureCollection GeoJSON standard che puoi aprire in qualsiasi strumento GIS.
Il mio file viene caricato su un server?
No. La lettura del file Parquet, la decodifica della geometria WKB e il rendering della mappa avvengono tutti localmente nel tuo browser usando WebAssembly. Il file non lascia mai il tuo dispositivo.
La lettura funziona interamente nel tuo browser usando Apache Arrow e una build WebAssembly di parquet-wasm. Nessun file viene mai caricato su un server. Tessere della mappa © contributori di OpenStreetMap, disegnate con Protomaps (ospitato da KONAKTIVE), con CARTO come riserva.
