Gegography

Gegography is a library for reading, manipulating and converting
geographical formats, written i pure Go. Currently, support is limited to
GeoJSON, WKT (Well-Known-Text) and Shapefiles (read only). I plan on
implementing WKB (Well-Known-Binary).

I do not plan on supporting writing Shapefiles. Shapefile must die!

Gegography supports the following geographical types:

• Point
• LineString
• Polygon
• MultiPoint
• MultiLineString
• MultiPolygon

Currently, only XY geometries are supported.

What is it for?

I wrote Gegography primarily as a utility for processing geographical data
uploaded to websites with Go backends. For example, I manage several websites
with interactive mapping capabilities, and a common request is for users to
be able to upload Shapefiles or GeoJSON-documents and have them automatically
displayed on the map, or saved in the underlying database for viewing on demand.

With gegography you can read a Shapefile or a GeoJSON-document and easily export
all features to WKT-strings for storage as geometries inside a database engine
such as PostgreSQL or SQL Server.

How do I use it?

A typical use-case would look something like this (convert a shapefile to geojson)

package main
import (
    "os"
    "github.com/Froglich/gegography"
    "io/ioutil"
)
func main() {
    infile := os.Args[1]
    fc, err := gegography.ReadShapefile(infile)
    if err != nil {
        panic(err)
    }
    gj, err := fc.ToPrettyGeoJSON()
    if err != nil {
        panic(err)
    }
    err = ioutil.WriteFile(infile[:len(infile)-4] + ".geojson", gj, 0755)
    if err != nil {
        panic(err)
    }
}

Installing

Install with go get github.com/Froglich/gegography .