Popularity
0.4
Growing
Activity
10.0
Stable
3
1
0

Description

The geojson2h3 library includes a set of utilities for conversion between GeoJSON objects and H3 hexagon indexes, using uber H3 and GeoJSON.

Programming language: Go
License: MIT License
Tags: Geospatial     Go Tools     Geo     Golang     Geojson     H3     H3GeoJSON    

go-geojson2h3 alternatives and similar packages

Based on the "Go Tools" category.
Alternatively, view go-geojson2h3 alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of go-geojson2h3 or a related project?

Add another 'Go Tools' Package

README

go-geojson2h3

Coverage Status Documentation Go Report Card

The geojson2h3 library includes a set of utilities for conversion between GeoJSON Objects:

  • Point, MultiPoint,
  • LineString, MultiLineString
  • Polygon,MultiPolygon
  • GeometryCollection
  • Feature,FeatureCollection
  • Circle

and H3 hexagon indexes, using: H3-GO and GeoJSON

Installation

$ go get github.com/mmadfox/go-geojson2h3

API

// ToH3 converts a GeoJSON objects to a list of hexagons with specified resolution.
ToH3(resolution int, o geojson.Object) (indexes []h3.H3Index, err error)

// ToFeatureCollection converts a set of hexagons to a GeoJSON `FeatureCollection`
// with the set outline(s). The feature's geometry type will be `Polygon`.
ToFeatureCollection(indexes []h3.H3Index) (*geojson.FeatureCollection, error)

Examples

  • [Point, MultiPoint](examples/point.go)
  • [LineString, MultiLineString](examples/line.go)
  • [Polygon,MultiPolygon](examples/polygon.go)
  • [GeometryCollection](examples/collection.go)
  • [Feature,FeatureCollection](examples/feature.go)
  • [Circle](examples/circle.go)
  • [Rect](examples/rect.go)
package main

import (
    "fmt"

    "github.com/mmadfox/go-geojson2h3"
    "github.com/tidwall/geojson"
    "github.com/uber/h3-go/v3"
)

func main() {
    resolution := 9
    object, err := geojson.Parse(`{"type":"FeatureCollection","features":[{"type":"Feature","properties":{"shape":"Polygon","name":"Unnamed Layer","category":"default"},"geometry":{"type":"Polygon","coordinates":[[[-73.901303,40.756892],[-73.893924,40.743755],[-73.871476,40.756278],[-73.863378,40.764175],[-73.871444,40.768467],[-73.879852,40.760014],[-73.885515,40.764045],[-73.891522,40.761054],[-73.901303,40.756892]]]},"id":"a6ca1b7e-9ddf-4425-ad07-8a895f7d6ccf"}]}`, nil)
    if err != nil {
        panic(err)
    }

    indexes, err := geojson2h3.ToH3(resolution, object)
    if err != nil {
        panic(err)
    }
    for _, index := range indexes {
        fmt.Printf("h3index: %s\n", h3.ToString(index))
    }

    featureCollection, err := geojson2h3.ToFeatureCollection(indexes)
    if err != nil {
        panic(err)
    }
    fmt.Println("Polyfill:")
    fmt.Println(featureCollection.JSON())
}

Contributing

Pull requests and Github issues are welcome. Please include tests for new work, and keep the library test coverage at 90-100%.