Serving vector tiles is no fun. Grandine wants to change this.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
cmd
fileformat
lib
viewer
.gitignore
.travis.yml
LICENSE
Makefile
README.md

README.md

Grandine

GoDoc Build Status

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.

Prototype Fund Bundesministerium für Bildung und Forschung Open Knowledge Foundation Deutschland

Requirements

  • Go ≥ 1.8
  • GEOS

Quickstart

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.
  • Execute go get -u github.com/thomersch/grandine. This will checkout a current version of the code into ~/go/src/github.com/thomersch/grandine
  • Go to the checkout directory. Execute make build, this will put all executables into the bin directory.
  • All the executables can be called with the -help flag which will print out basic usage info.

Structure

  • fileformat contains 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.
  • In lib you'll find a few Go libraries that provide a few primitives for handling spatial data:
    • lib/spatial contains 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/mvt contains code for serializing Mapbox Vector Tiles.
  • There are a few command line tools in cmd:
    • converter is a helper tool for converting and concatenating geo data files
    • spatialize converts OpenStreetMap data into a Spaten data file as defined in fileformat
    • tiler generates vector tiles from spatial data