Was dieses Tool macht
GeoParquet-Dateien sind für Menschen nicht direkt lesbar. Anders als bei GeoJSON kann man eine solche Datei nicht einfach in einem Texteditor öffnen und die Koordinaten sehen, und die meisten alltäglichen GIS-Desktop-Programme öffnen das Format bis heute nicht direkt. Dadurch entsteht eine Lücke zwischen dem Besitz einer .parquet-Datei und dem tatsächlichen Wissen darüber, was darin steckt: wie viele Features, welcher Geometrietyp, welche Spalten, welches Gebiet abgedeckt wird.
Dieser Viewer schließt genau diese Lücke. Legen Sie eine Datei ab, und er liest den Parquet-Container aus, prüft die eigenen GeoParquet-Metadaten der Datei, um die Geometriespalte und ihre Kodierung zu finden, dekodiert jeden WKB-Wert (Well-Known Binary) zurück in echte Koordinaten und zeichnet das Ergebnis auf einer Karte. Klicken Sie auf ein beliebiges Feature, um seine vollständige Attributtabelle zu sehen, passen Sie Farbe und Stil an, um Muster leichter erkennbar zu machen, und exportieren Sie alles wieder als GeoJSON-Datei, wenn Sie es in einem Format brauchen, das mehr Programme bereits verstehen. Es wird keine Datei irgendwohin hochgeladen; der Parquet-Reader ist ein WebAssembly-Build, der vollständig auf Ihrem eigenen Rechner läuft.
Wie der Viewer eine GeoParquet-Datei liest
Der Vorgang läuft in drei Schritten ab. Zuerst liest ein WebAssembly-Build der Rust-Parquet-Bibliothek die rohen Spaltendaten und übergibt sie als Apache-Arrow-Tabelle, dasselbe Speicherformat, das GeoPandas und DuckDB intern verwenden. Zweitens sucht der Viewer in den Schema-Metadaten der Tabelle nach einem Schlüssel namens "geo", dem kleinen JSON-Block, den jede GeoParquet-Datei mitführt und der die primäre Geometriespalte benennt, ihre Kodierung angibt und auflistet, welche Geometrietypen vorhanden sind. Fehlt dieser Schlüssel, handelt es sich um eine reine Parquet-Datei und nicht um GeoParquet, und der Viewer sagt das klar, statt zu raten.
Drittens durchläuft der Viewer jede Zeile der Geometriespalte, die rohe WKB-Byte-Werte enthält, und dekodiert jeden Wert zurück in Koordinaten: ein Byte für die Byte-Reihenfolge, vier Bytes für den Code des Geometrietyps, dann die Koordinaten selbst als Paare von 8-Byte-Zahlen. Derselbe Decoder erkennt außerdem das SRID-Flag, das PostGIS seiner EWKB-Ausgabe hinzufügt, sowie die Z/M-Dimensionsmarkierungen des ISO-WKB-Standards, sodass auch Dateien, die aus einer räumlichen Datenbank exportiert wurden, korrekt gelesen werden. Die Eigenschaften in jeder anderen Spalte werden genauso gelesen, wie Arrow sie bereits speichert, und jedem Feature zugeordnet, und das Ganze wird zu einer standardmäßigen GeoJSON-FeatureCollection, die bereit ist, auf der Karte gezeichnet zu werden.
Schritt-für-Schritt-Anleitung
Klicken Sie auf "Upload" und wählen Sie eine .parquet-Datei aus, ziehen Sie eine Datei per Drag-and-Drop auf die Karte, oder klicken Sie auf "Sample Data", um ein kleines, fertiges Beispiel zu laden.
Die Datei wird vollständig in Ihrem Browser dekodiert. Das Dateiinfo-Panel zeigt Featureanzahl, Geometrietyp, Namen der Geometriespalte, CRS und Dateigröße direkt aus den eigenen Metadaten der Datei.
Klicken Sie auf einen beliebigen Punkt, eine Linie oder ein Polygon auf der Karte, um ein Popup mit allen für dieses Feature gespeicherten Eigenschaften zu öffnen.
Nutzen Sie das Stil-Panel, um Farbe, Linienstärke und Füllungsdeckkraft für alle Features auf der Karte zu ändern.
Klicken Sie auf "Download as GeoJSON", um jedes dekodierte Feature als standardmäßige GeoJSON-Datei zu exportieren.
Anwendungsfälle aus der Praxis
Wo es tatsächlich hilft, eine GeoParquet-Datei direkt zu öffnen, ohne eine Zeile Code zu schreiben.
- Die Ausgabe einer Datenpipeline stichprobenartig prüfen. Wenn ein Skript oder ein ETL-Job GeoParquet-Dateien schreibt, ist es ein schneller Weg, die neueste Ausgabe direkt in diesen Viewer zu ziehen, um zu bestätigen, dass Geometrie und Attribute stimmen, bevor man der Datei nachgelagert vertraut.
- Einen offenen Datensatz erkunden, bevor man Code schreibt. Datensätze wie Overture Maps oder die Sammlungen auf Source Cooperative werden als GeoParquet ausgeliefert. Lädt man einen kleinen Ausschnitt herunter und betrachtet ihn hier, sieht man genau, welche Spalten und Geometrietypen enthalten sind, noch bevor man DuckDB oder GeoPandas einrichtet.
- Eine GeoJSON-zu-GeoParquet-Konvertierung überprüfen. Nach der Konvertierung einer Datei mit einem Tool wie dem GeoJSON-zu-GeoParquet-Konverter dieser Website bestätigt das erneute Laden des Ergebnisses in diesen Viewer, dass der Roundtrip jedes Feature und jede Eigenschaft korrekt erhalten hat.
- Daten prüfen, bevor sie als offene Daten veröffentlicht werden. Kommunale und wissenschaftliche Teams veröffentlichen zunehmend GeoParquet neben GeoJSON. Eine schnelle visuelle Prüfung hier deckt offensichtliche Probleme auf, etwa eine leere Geometriespalte oder eine Bounding Box in der falschen Hemisphäre, bevor die Datei live geht.
- Das GeoParquet-Format unterrichten oder vorführen. Weil das Dateiinfo-Panel die primäre Geometriespalte, das CRS und die Kodierung direkt aus den eigenen Metadaten der Datei zeigt, lässt sich hier bequem zeigen, was tatsächlich in einer GeoParquet-Datei steckt, sei es für Studierende oder Kolleginnen und Kollegen.
- Nutzbare Daten aus einer Datei retten, für die gerade kein anderer Viewer zur Hand ist. Noch liest nicht jedes GIS-Desktop-Programm GeoParquet. Wenn man einfach nur schnell sehen möchte, was in einer .parquet-Datei steckt, oder sie als GeoJSON für ein Tool herausholen will, das nur dieses Format versteht, erspart das die Installation von irgendetwas.
Häufig gestellte Fragen
Welche Art von Datei kann ich hier öffnen?
Jede Datei, die der GeoParquet-Spezifikation folgt: eine gewöhnliche Apache-Parquet-Datei mit einem Metadatenschlüssel "geo" auf Schema-Ebene, der eine Geometriespalte beschreibt. Dateien, die von GeoPandas, der räumlichen Erweiterung von DuckDB, ogr2ogr, Apache Sedona oder dem eigenen GeoJSON-zu-GeoParquet-Konverter dieser Website erzeugt wurden, funktionieren alle.
Welche Geometriekodierung unterstützt der Viewer?
WKB (Well-Known Binary), die Standardkodierung und mit Abstand die heute am häufigsten verwendete Kodierung für GeoParquet-Dateien. GeoParquet 1.1 definiert außerdem separate native Arrow-Kodierungen für jeden Geometrietyp; Dateien, die diese verwenden, werden noch nicht unterstützt, und der Viewer weist eindeutig darauf hin, wenn er auf eine solche stößt.
Unterstützt es Punkt-, Linien- und Polygondateien, auch mit mehrteiligen Geometrien?
Ja. Point, LineString, Polygon, MultiPoint, MultiLineString und MultiPolygon werden alle korrekt dekodiert, auch bei Dateien, die mehr als einen Geometrietyp in derselben Spalte mischen.
Was passiert mit 3D-Koordinaten (Z) oder gemessenen Werten (M)?
Der Reader erkennt sowohl den PostGIS-EWKB-Stil als auch den ISO-WKB-Stil zur Kennzeichnung von Z- und M-Dimensionen und überspringt diese zusätzlichen Werte korrekt, sodass der Rest der Geometrie trotzdem dekodiert wird. Da die GeoJSON-Ausgabe und die Karte grundsätzlich 2D sind, werden zur Anzeige nur X und Y beibehalten.
Woher weiß der Viewer, welche Spalte die Geometrie enthält?
Er liest das Feld "primary_column" aus den "geo"-Metadaten der Datei, die jede gültige GeoParquet-Datei enthalten muss. So meldet der Viewer auch das CRS und bestätigt die Kodierung, bevor überhaupt versucht wird, etwas zu dekodieren.
Was, wenn meine Datei gar keine "geo"-Metadaten hat?
Dann handelt es sich um eine reine Parquet-Datei und nicht um eine GeoParquet-Datei, und der Viewer sagt das klar, statt zu raten. Eine Geometriespalte ohne begleitende Metadaten könnte WKB, WKT oder etwas völlig anderes sein, daher gibt es keine sichere Möglichkeit, sie automatisch zu dekodieren.
Gibt es eine Begrenzung für die Dateigröße?
Uploads sind auf 100 MB begrenzt. Sehr große Dateien können außerdem langsam auf der Karte gerendert werden, da jedes Feature zu einem Leaflet-Layer wird; bei Dateien mit mehreren hunderttausend Zeilen ist es normal, dass das erste Rendern einige Sekunden dauert.
Kann ich meine Daten wieder als GeoJSON herausbekommen?
Ja. Die Schaltfläche "Download as GeoJSON" exportiert jedes dekodierte Feature, einschließlich Geometrie und Eigenschaften, als standardmäßige GeoJSON-FeatureCollection, die sich in jedem GIS-Tool öffnen lässt.
Wird meine Datei auf einen Server hochgeladen?
Nein. Das Lesen der Parquet-Datei, das Dekodieren der WKB-Geometrie und das Rendern der Karte laufen alle lokal in Ihrem Browser mithilfe von WebAssembly ab. Die Datei verlässt Ihr Gerät nie.
Das Lesen läuft vollständig in Ihrem Browser mithilfe von Apache Arrow und einem WebAssembly-Build von parquet-wasm ab. Es wird nie eine Datei auf einen Server hochgeladen. Kartenkacheln © OpenStreetMap-Mitwirkende, gezeichnet mit Protomaps (gehostet von KONAKTIVE), mit CARTO als Ersatz.
