SpatialNET.IO: WKT und GeoJSON über die Factory, nur Geometrien
SpatialNET.IO liest und schreibt WKT und GeoJSON und erzeugt beim Lesen alle Geometrien über die Geometrie-Factory (optionaler Parameter, Fallback GeometryFactory.Default, ADR 0004). Die Abnehmer sind Fixtures und Orakel (ADR 0008), der Playground (Upload, Leaflet) und Hosts ohne eigene Geometrien. gView und WebGIS haben eigene GeoJSON-Unterstützung. Deshalb bleibt IO bewusst schmal: kein WKB, kein Feature-Modell (GeoJSON-properties werden ignoriert), keine CRS-Auswertung. IO hängt von Core und Extensions ab, damit der Writer die Gruppierung in Teilflächen und die Orientierung nicht nachbauen muss. JSON läuft über System.Text.Json, weitere Abhängigkeiten gibt es nicht.
English version: 0009-io-wkt-geojson-ueber-factory.md
Consequences
- Typabbildung: POINT →
IPoint2D, MULTIPOINT →IMultiPoint2D, (MULTI)LINESTRING →IPolyline2D, (MULTI)POLYGON →IPolygon2Dmit Teilflächen. Geschrieben wird jeweils der schlankste Typ, z. B. POLYGON bei einer Teilfläche. - GeometryCollection: Beim Lesen einer Einzelgeometrie gibt es eine
NotSupportedException. InReadAllbzw. beiFeatureCollectionwird sie flachgeklopft.POINT EMPTYwird als leererIMultiPoint2Dgelesen und alsMULTIPOINT EMPTYgeschrieben. - Z/M/CRS: Z wird gelesen. M wird still verworfen (teilweise abgelöst durch ADR 0015: WKT liest und schreibt künftig M). Ein CRS (auch das GeoJSON-
crs-Member von 2008) wird ignoriert. - Schreiben von Z über
ZMode:Auto(Standard): Z wird geschrieben, wenn die PunkteIPoint3Dsind und mindestens ein Z ≠ 0 und nicht NaN ist. Das ist nötig, weil die Hosts immerIPoint3Dmit Z = 0 liefern.Always/Never.
- Orientierung: Beide Writer normalisieren, Außenring gegen den Uhrzeigersinn, Loch im Uhrzeigersinn (RFC 7946, ADR 0003).
- API:
- WKT:
Wkt.Read,Wkt.Read<T>,ToWkt(WktOptions?) - GeoJSON:
GeoJson.Read/ReadAll(string,ReadOnlySpan<byte>,Stream),ToGeoJson(options?),WriteTo(Utf8JsonWriter) - Zahlenformat: invariant und Round-Trip-genau.
Read(ToWkt(g))liefert bitgenau dieselben Koordinaten.
- WKT:
- Strenge:
- Syntaxfehler →
FormatExceptionmit Position bzw. JSON-Pfad - Geometrisch ungültige, aber syntaktisch korrekte Eingaben werden akzeptiert (ADR 0002/0003)
EMPTYwird zu einer leeren Geometrie
- Syntaxfehler →
Considered Options
- WKB in v1 (verschoben: kein Abnehmer, lässt sich ohne Bruch nachrüsten; aufgehoben durch ADR 0016)
- Feature-Modell mit Properties (verworfen: neues Domänenkonzept, gehört zu den Hosts)
- IO nur auf Core, Hole-Gruppierung nachgebaut (verworfen: doppelte Logik)