1# geo
2
3sublimated renders `.geojson` files as interactive maps. push via [git](../git/), view the rendered map on the web.
4
5- maps are rendered client-side using MapLibre GL JS
6- geo metadata (format, bbox, feature count) is extracted server-side on push and stored as item attributes
7- the raw GeoJSON is fetched from CAS and rendered onto the map
8- supports points, lines, polygons, and mixed FeatureCollections
9
10## demos
11
12one file per geometry type — push them to see them rendered:
13
14- [points](points.geojson) — world cities as point features
15- [lines](lines.geojson) — routes and paths as LineStrings
16- [polygons](polygons.geojson) — country/region boundaries as Polygons
17- [mixed](mixed.geojson) — FeatureCollection with points, lines, and polygons together
18- [single](single.geojson) — a single Feature (not wrapped in FeatureCollection)
19
20## how it works
21
221. push a `.geojson` file via git (or upload via API)
232. sublimated detects the geo format and extracts metadata (bounding box, feature count, geometry types)
243. metadata is stored as item attributes: `geo_format`, `geo_bbox`, `geo_feature_count`
254. when you view the file, MapLibre GL JS loads from CDN and renders the data on a map
265. the map auto-fits to the bounding box of the data
276. polygons get a semi-transparent fill, lines get a colored stroke, points get circles
28
29## supported formats
30
31phase 1 (now): `.geojson` files served directly from CAS
32
33future phases:
34- geoparquet (`.parquet` with geo metadata) — needs features API endpoint
35- shapefiles, KML, CSV with lat/lon columns — needs server-side conversion