digi21.io.geojson
Module: digi21.io
Reads and writes GeoJSON files (.geojson): a FeatureCollection following RFC 7946, with WGS 84 longitude and latitude in degrees.
import digi21.io.geojson as geojson
open
open(path, digitab=None) -> DrawingFile
| Argument | Type | Description |
|---|---|---|
path |
str |
.geojson file path. |
digitab |
DigiTab | Optional code table. An empty one is used if omitted. |
Returns a DrawingFile. Each geometry's code is its Feature's Layer property. Text written by create is read as points. Raises FileNotFoundError if path does not exist.
create
create(path, digitab=None, crs="") -> DrawingWriter
| Parameter | Type | Default | Description |
|---|---|---|---|
path |
str |
— | .geojson file path. Replaces an existing file. |
digitab |
DigiTab | None |
Code table. An empty one is used if omitted. |
crs |
str |
"" |
Optional. Not saved in the file. If supplied and different from the exporter's declared system (WGS 84, EPSG:4979), reported in warnings. |
The format has no IMPORTATION_PARAMETERS parameters.
Exporter behavior:
- Writes coordinates without transformation: supply geometries with longitude and latitude in degrees.
digi21.iodoes not transform coordinates. - Writes each geometry as a
Featurewith its first code inLayer. A multi-code geometry is written once per code. - Writes text as points with content in the
textproperty. - Writes full-precision coordinates:
openreads the same values.
create exceptions: ValueError for invalid crs; FileNotFoundError if the path folder does not exist.
Examples
These examples were run with Python 3.12; the output shown is the actual output.
Create a file from scratch
import digi21.io.geojson as geojson
from digi21.base import Line, Point, Polygon, Text
# WGS 84 longitude and latitude in degrees; z is height.
with geojson.create("madrid.geojson") as writer:
writer.add(Point((-3.7038, 40.4168, 657.0), ["010123"]))
writer.add(Line(["040645"], [(-3.7038, 40.4168, 657.0), (-3.6921, 40.4189, 670.0), (-3.6883, 40.4153, 668.0)]))
writer.add(Polygon(["020402"], [(-3.70, 40.41, 650.0), (-3.69, 40.41, 650.0),
(-3.69, 40.42, 650.0), (-3.70, 40.41, 650.0)]))
writer.add(Text("Madrid", (-3.7038, 40.4168, 657.0), ["010123"], text_height=10.0))
print(writer.written, "escritas,", writer.rejected, "rechazadas")
4 escritas, 0 rechazadas
Read and count by code and type
import collections
import digi21.io.geojson as geojson
conteo = collections.Counter()
for geometry in geojson.open("madrid.geojson"):
conteo[(geometry.codes[0].code, type(geometry).__name__)] += 1
for (codigo, tipo), n in sorted(conteo.items()):
print(codigo, tipo, n)
010123 Point 2
020402 Polygon 1
040645 Line 1
Text Madrid is read as a second point with code 010123.
Convert BinDouble in geographic coordinates
import digi21.io.bindouble as bind
import digi21.io.geojson as geojson
# madrid.bind uses ETRS89 geographic coordinates (EPSG:4258): longitude and latitude in degrees.
origen = bind.open("madrid.bind")
print(origen.crs[:15])
with geojson.create("madrid-convertido.geojson") as writer:
for geometry in origen:
writer.add(geometry)
print(writer.written, "escritas,", writer.rejected, "rechazadas")
GEOGCS["ETRS89"
3 escritas, 0 rechazadas
The source must use longitude and latitude. A UTM file such as parcelas.bind in other digi21.io examples would be written with its UTM coordinates, producing invalid GeoJSON.
Read GeoJSON with json
import json
with open("madrid.geojson", encoding="utf-8-sig") as archivo:
documento = json.load(archivo)
print(documento["type"])
for feature in documento["features"]:
print(feature["geometry"]["type"], feature["properties"])
FeatureCollection
Point {'stroke': '#A8A8A8', 'Layer': '010123', 'Description': 'Desconocido', 'rotation': '0'}
LineString {'stroke': '#A8A8A8', 'Layer': '040645', 'Description': 'Desconocido'}
Polygon {'stroke': '#A8A8A8', 'Layer': '020402', 'Description': 'Desconocido'}
Point {'stroke': '#A8A8A8', 'Layer': '010123', 'Description': 'Desconocido', 'text': 'Madrid', 'rotation': '0', 'textHeight': '10', 'justification': '0'}
Without a code table, Description is Desconocido and stroke is the unknown code color. With a code table, Description and stroke contain each code's description and color respectively.
See also
- digi21.io — module index and shared behavior.
- digi21.io.kml — the other longitude/latitude format.
- DrawingFile and DrawingWriter
- GeoJSON format