40 lines
1.7 KiB
Markdown
40 lines
1.7 KiB
Markdown
# Geo Tools
|
||
|
||
Inspect, edit, measure and convert geospatial files locally in the browser.
|
||
|
||
Geo Tools is a standalone local-first application in the [add·ideas Toolbox](https://git.add-ideas.de/lotobo/toolbox-portal). Inputs are processed in the browser and are not uploaded.
|
||
|
||
## Version 0.1 scope
|
||
|
||
- Bounded GeoJSON, GPX, KML and coordinate-CSV parsing into a common model with Point, LineString, Polygon, MultiPoint, MultiLineString, MultiPolygon and nested GeometryCollection support
|
||
- WGS 84 bounds, point counts, great-circle LineString distance and elevation gain/loss
|
||
- Explicit lossy conversion among the four supported formats
|
||
- Iterative Douglas–Peucker LineString simplification and decimal-degree/DMS conversion
|
||
- A coordinate-only local sketch with no map tiles or projection service
|
||
- Full-model GeoJSON geometry replacement, append/delete, nested coordinate editing and line-direction reversal with validation after every edit
|
||
- GPX-derived track inventory plus a local two-point distance, initial-bearing and midpoint ruler
|
||
|
||
Geometry collections are limited to 20,000 geometry nodes, 16 nesting levels
|
||
and 200,000 coordinates. GPX/CSV conversions flatten geometry grouping and
|
||
report that loss. Scalar properties are preserved; there is no CRS
|
||
transformation, basemap request or claim of survey-grade geodesy. See
|
||
[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) and [docs/PRIVACY-SECURITY.md](docs/PRIVACY-SECURITY.md).
|
||
|
||
## Development
|
||
|
||
Requires Node.js 22 and npm 11.
|
||
|
||
```sh
|
||
npm ci
|
||
npm run check
|
||
npm run test:browser
|
||
```
|
||
|
||
## Release
|
||
|
||
`npm run release:artifact` creates a deterministic `release/geo-tools-0.2.0.zip` and checksum sidecar.
|
||
|
||
## Licence
|
||
|
||
GPL-3.0-or-later. Runtime dependencies retain their own licences; see [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
|