GeoJSON

Was es ist

GeoJSON ist ein offenes Austauschformat für Kartenobjekte: Punkte,
Linien und Flächen einer Karte samt den zugehörigen Angaben in einem
einfachen JSON-Dokument. Die IETF standardisierte es im August 2016
als RFC 7946. Es ersetzte die 2008 erstmals veröffentlichte
Gemeinschaftsspezifikation. Ein GeoJSON-Text wird mit dem Medientyp
`application/geo+json` übertragen und meist mit der Erweiterung
i.geojson gespeichert. Auch einfaches .json ist registriert.		engineer.company	70

Das Format kennt drei Objektarten. Jedes Objekt gibt seine Art in
einem Member namens "type" an.

  * Geometry ist eine Form. Es gibt sieben Typen: Point, MultiPoint,
LineString, MultiLineString, Polygon, MultiPolygon und
GeometryCollection. Es sind die Formen des Simple-Features-Modells
des Open Geospatial Consortium (OGC), dieselben, die WKT und WKB in
Text- und Binärform kodieren.

  * Feature ist ein Gegenstand auf der Karte: eine Geometrie, ein
Objekt "properties" mit seinen Attributen und eine optionale "id".
Bei einem Feature mit unbekanntem Standort darf die Geometrie null
sein.

  * FeatureCollection enthält eine Liste von Features in einem
Member namens "features". So sind die meisten Dateien und
API-Antworten aufgebaut.

Ein einzelnes Feature für einen intelligenten Zähler sieht so aus:

```json
{
    "type": "Feature",
    "id": "meter-0417",
    "geometry": {
        "type": "Point",
        "coordinates": [12.5683, 55.6761]
    },
    "properties": {
        "name": "Meter 417",
        "installed": "2023-04-12"
    }
}
```

Jede Position ist ein Zahlenarray: zuerst Längengrad, dann
Breitengrad, optional danach die Höhe in Metern. Laut Spezifikation
stehen die ersten beiden „genau in dieser Reihenfolge“. Der Punkt
oben liegt daher im Zentrum von Kopenhagen, 12,57 Grad östlich und
55,68 Grad nördlich. Jede Koordinate nutzt dasselbe Referenzsystem:
WGS 84 mit Längen- und Breitengraden in Dezimalgrad, vom OGC als
CRS84 bezeichnet. Die Fassung von 2008 erlaubte es, in einem Member
"crs" ein anderes System anzugeben. RFC 7946 entfernte diesen
Member, weil gemischte Referenzsysteme Interoperabilitätsprobleme
verursacht hatten. Ein anderes System ist nur zulässig, wenn alle
Beteiligten es vorab vereinbart haben.

Für Polygone gelten eigene Regeln. Jeder Ring ist geschlossen und
hat mindestens vier Positionen; die letzte wiederholt die erste. Der
erste Ring ist die äußere Grenze, alle weiteren sind Löcher. RFC
7946 ergänzt eine Rechte-Hand-Regel: Außenringe verlaufen gegen den
Uhrzeigersinn, Löcher im Uhrzeigersinn. Weil die Fassung von 2008
aber keine Umlaufrichtung vorgab, sollen Parser auch Polygone
akzeptieren, die diese Regel verletzen.

Warum es wichtig ist

Alles, was JSON lesen kann, kann GeoJSON lesen. Ein Browser parst es
ohne Plugin, eine Webkartenbibliothek zeichnet es direkt, eine
Dokumentdatenbank speichert es unverändert. RFC 7946 hält fest, dass
es „in JavaScript-Bibliotheken für Webkarten, JSON-basierten
Dokumentdatenbanken und Web-APIs weitverbreitet ist“. Diese
Reichweite macht es zum üblichen Format, wenn Kartendaten ein
Desktop-GIS in Richtung Webseite oder API verlassen.

Auch Standards bauen darauf auf. OGC API – Features, der
OGC-Standard zum Ausliefern geografischer Features über HTTP,
empfiehlt GeoJSON überall dort, wo sich die Daten darin darstellen
lassen. Ein Server mit GeoJSON-Angebot gibt für eine Feature-Liste
eine FeatureCollection und für ein einzelnes Feature ein Feature
zurück, beides als `application/geo+json`. Sein
Standardreferenzsystem ist dasselbe WGS 84 mit Längen- und
Breitengraden, das GeoJSON festlegt.

Dieselben Entwurfsentscheidungen setzen die Grenzen.

  * Ein Referenzsystem. Daten aus einem nationalen Koordinatengitter
müssen vor dem Schreiben in Längen- und Breitengrade transformiert
werden. Wer mit den Daten in Metern misst, muss sie
zurücktransformieren.

  * Nur einfache Formen. Die Geometrietypen decken Punkte, Linien
aus geraden Segmenten und Polygone ab. Kurven, Körper wie
3D-Stadtmodelle und Koordinaten außerhalb von WGS 84 fallen nicht
unter das Format. OGC API – Features nennt genau diese Fälle als
Beispiele nicht darstellbarer Daten.

  * Größe. Jede Koordinate wird in Dezimalziffern ausgeschrieben.
Eine FeatureCollection ist ein einzelner JSON-Wert, den ein
gewöhnlicher JSON-Parser bis zum letzten Byte liest, bevor er ein
Feature zurückgibt. RFC 8142 definiert GeoJSON Text Sequences mit
dem Medientyp `application/geo+json-seq` und einem GeoJSON-Text pro
Datensatz. Beliebig große Datenbestände lassen sich damit
schrittweise lesen.

  * Keine gemeinsamen Kanten. Zwei benachbarte Polygone speichern
ihre gemeinsame Grenze jeweils vollständig. Die Grenze steht also
doppelt da. Die Änderung einer Kopie kann eine Lücke oder
Überlappung öffnen.

RFC 7946 sagt auch klar, was das Format anderen überlässt. GeoJSON
bietet selbst weder Vertraulichkeits- noch Integritätsschutz. Bei
der Übertragung sind die Daten daher auf TLS angewiesen. Der
Sicherheitsabschnitt warnt, dass die Veröffentlichung der Standorte
schutzbedürftiger Menschen, Tiere, Lebensräume oder Einrichtungen
sie Verfolgung oder Schaden aussetzen kann. Das Vergröbern von
Positionen in einem anonymisierten Datensatz dürfte einen
entschlossenen Angriff kaum abwehren.

Wie es in der Praxis aussieht

GeoJSON war neben Shapefiles, GeoTIFF, KML und Vektorkacheln eines
der Formate, zwischen denen GDAL/OGR Daten verschob, und zwar in
mehr als dreißig GIS-Projekten, die gebaut, bereitgestellt und in
Produktion betreut wurden. Darunter hielt PostgreSQL mit PostGIS die
räumlichen Daten. QGIS und JOSM dienten der eigentlichen
Datenarbeit, die Browserkarten darüber nutzten Mapbox GL und
Leaflet.

Vor all dem muss das Referenzsystem feststehen. Bei einer Migration
von MSSQL zu PostgreSQL mit der Erweiterung PostGIS durchliefen über
50 Millionen räumliche Datensätze ETL-Pipelines. Deren
Transformationsschritte brachten sie zum SRID-Standard EPSG:4326.
Dieser Code bezeichnet dasselbe WGS-84-Datum in Grad, das GeoJSON
festlegt. Laut PostGIS-Handbuch entspricht die Ausgabe seiner
Funktion ST_AsGeoJSON für Geometrien in EPSG:4326 dem RFC 7946, ohne
dass eine Transformation nötig ist.

Wo es schiefgeht

Punkte landen im falschen Meer. Eine Ebene mit dänischen Adressen
erscheint mitten im Arabischen Meer. Jede Bereichsprüfung wird
trotzdem bestanden, weil beide Zahlen gültige Gradangaben sind.
Breite und Länge wurden beim Einlesen vertauscht. EPSG:4326 führt
formal zuerst die Breite auf. Viele Datenquellen folgen dem, GeoJSON
verlangt aber die Länge zuerst. Bauen Sie jede Position aus
benannten Feldern statt anhand der Spaltenreihenfolge auf. Behalten
Sie ein Test-Feature an einer bekannten Adresse bei, damit eine
Vertauschung im Test auffällt statt erst beim Prüfen der Karte.

Koordinaten kommen in Metern an. Eine Ebene fehlt auf der Karte oder
wird vom Client abgelehnt. Die Datei enthält Koordinaten in den
Hunderttausenden, wo Gradangaben hingehören. Die Geometrie war in
einem projizierten nationalen Koordinatengitter gespeichert und
wurde unverändert exportiert. Transformieren Sie sie zuerst in
Längen- und Breitengrade, in PostGIS mit `ST_Transform(geom, 4326)`.
Ohne Transformation fügt ST_AsGeoJSON standardmäßig einen Member
"crs" an, den RFC 7946 entfernte.

Polygone erscheinen in einem Client umgestülpt. Ein
Versorgungsgebiet füllt die ganze Karte außer seiner eigenen Form,
während andere Werkzeuge dieselbe Datei richtig zeichnen. Dieser
Client unterscheidet innen und außen anhand der Richtung jedes
Rings. Die Ringe verlaufen andersherum, was die Fassung von 2008
zuließ. Laut PostGIS-Handbuch verlangen manche Clients die
Rechte-Hand-Regel. Wenden Sie sie deshalb vor dem Export mit
`ST_ForcePolygonCCW(geom)` an und prüfen Sie die Ausgabe in jedem
Client, der sie verwendet.

Dateien enthalten mehr Ziffern, als die Karte braucht. Eine Ebene
mit detaillierten Polygonen braucht auf einem Telefon Sekunden zum
Herunterladen. Ihre Koordinaten haben neun oder mehr
Nachkommastellen. ST_AsGeoJSON schreibt standardmäßig bis zu neun
Nachkommastellen. Laut RFC 7946 kann der Wechsel von sechs auf
fünfzehn die Textgröße fast verdoppeln, während sechs bereits etwa
10 Zentimeter auflösen. Übergeben Sie einen kleineren Wert für
`maxdecimaldigits`. Verringern Sie vorher die Präzision mit
`ST_ReducePrecision`, denn laut Warnung im PostGIS-Handbuch kann
allein das Abschneiden von Ziffern bei der Ausgabe eine Geometrie
ungültig machen.

Interne Spalten werden in properties ausgeliefert. Ein öffentlicher
Endpunkt gibt Eigentümernamen, Kosten oder Notizen aus, die in der
Datenbank bleiben sollten. Erhält ST_AsGeoJSON eine ganze Zeile,
legt es alle Spalten außer der Geometrie in "properties" ab. Wählen
Sie in einer Unterabfrage nur die zur Veröffentlichung bestimmten
Spalten aus. Benennen Sie ab PostGIS 3.5 außerdem die
Schlüsselspalte, damit sie zur "id" des Features wird:

```sql
SELECT json_build_object(
  'type', 'FeatureCollection',
  'features', json_agg(ST_AsGeoJSON(m.*, id_column => 'id')::json)
)
FROM (SELECT id, name, geom FROM meters) AS m;
```

Weiterführende Lektüre

  * RFC 7946: Das GeoJSON-Format — der IETF-Standard mit
Objekttypen, Koordinatenreihenfolge, Umlaufregel,
Präzisionshinweisen und Sicherheitsaspekten.

  * RFC 8142: GeoJSON Text Sequences — das Begleitformat, das einen
großen Datenbestand in einen GeoJSON-Text je Datensatz aufteilt.

  * ST_AsGeoJSON — das PostGIS-Handbuch zum Export von Geometrien
und ganzen Zeilen als GeoJSON, mit Präzisions- und Optionsflags.

  * EPSG:4326 WGS 84 — der Registereintrag mit Breite vor Länge als
Achsenreihenfolge, umgekehrt zu GeoJSON.

  * OGC API – Features – Part 1: Core — der OGC-Standard, der
GeoJSON für die Auslieferung von Features über HTTP empfiehlt.

hDiese Seite im Web	URL:https://engineer.company/de/glossary/geojson/	engineer.company	70
