This repository contains libraries and command line tools for working with geospatial data. It aims to streamline vector tile generation and provides tooling for standardized geo data serialization.
The work has been partly funded by the Prototype Fund, powered by Open Knowledge Foundation Germany and the German Ministry for Research and Education.
- Go ≥ 1.8
If you have built a Go project before, you probably already know what to do. If not:
- Make sure you have Go installed. Preferably version 1.8 or higher.
go get -u github.com/thomersch/grandine. This will checkout a current version of the code into
- Go to the checkout directory. Execute
make build, this will put all executables into the
- All the executables can be called with the
-helpflag which will print out basic usage info.
fileformatcontains a draft spec for a new geo data format that aims to be flexible, with a big focus on being very fast to serialize/deserialize.
libyou'll find a few Go libraries that provide a few primitives for handling spatial data:
lib/spatialcontains functionality for handling points/lines/polygons and basic transformation operations. If you miss functionality, feel free to send a Pull Request, it would be greatly appreciated.
lib/mvtcontains code for serializing Mapbox Vector Tiles.
- There are a few command line tools in
converteris a helper tool for converting and concatenating geo data files
spatializeconverts OpenStreetMap data into a Spaten data file as defined in
tilergenerates vector tiles from spatial data