Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ryankurte/go-mapbox
Golang Mapbox API module
https://github.com/ryankurte/go-mapbox
api golang mapbox
Last synced: 17 days ago
JSON representation
Golang Mapbox API module
- Host: GitHub
- URL: https://github.com/ryankurte/go-mapbox
- Owner: ryankurte
- License: mit
- Created: 2017-03-16T03:26:11.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2022-01-04T05:52:04.000Z (almost 3 years ago)
- Last Synced: 2024-10-19T21:10:45.023Z (25 days ago)
- Topics: api, golang, mapbox
- Language: Go
- Size: 91.8 KB
- Stars: 38
- Watchers: 3
- Forks: 20
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# go-mapbox
Mapbox API wrappers for Golang
[](https://godoc.org/github.com/ryankurte/go-mapbox/lib)
[](https://github.com/ryankurte/go-mapbox)
[](https://travis-ci.org/ryankurte/go-mapbox)
See [here](https://golanglibs.com/top?q=mapbox) for other golang/mapbox projects.
## Status
Very early WIP, pull requests and issues are most welcome. See [lib/geocode/](lib/geocode) or [lib/directions/](lib/directions) for an example module to mimic.
Because Travis-CI does not expose the build environment to untrusted branches (ie. Pull Requests) tests have to be manually prompted by a repository admin then force merged. Don't panic when your local tests pass but travis fails with "Mapbox API token not found", we will manually run them as soon as possible. See issue [#10](https://github.com/ryankurte/go-mapbox/issues/10) for more information.
### Modules
- [X] Geocoding
- [X] Directions
- [X] Directions Matrix
- [X] Map Matching
- [ ] Styles
- [X] Maps
- [ ] Static
- [ ] Datasets
## Examples
### Initialisation
```go
// Import the core module (and any required APIs)
import (
"gopkg.in/ryankurte/go-mapbox.v0/lib"
"gopkg.in/ryankurte/go-mapbox.v0/lib/base"
)
// Fetch token from somewhere
token := os.Getenv("MAPBOX_TOKEN")
// Create new mapbox instance
mapBox := mapbox.NewMapbox(token)
```
### Map API
``` go
import (
"gopkg.in/ryankurte/go-mapbox.v0/lib/maps"
)
img, err := mapBox.Maps.GetTiles(maps.MapIDSatellite, 1, 0, 0, maps.MapFormatJpg90, true)
```
### Geocoding
```go
import (
"gopkg.in/ryankurte/go-mapbox.v0/lib/geocode"
)
// Forward Geocoding
var forwardOpts geocode.ForwardRequestOpts
forwardOpts.Limit = 1
place := "2 lincoln memorial circle nw"
forward, err := mapBox.Geocode.Forward(place, &forwardOpts)
// Reverse Geocoding
var reverseOpts geocode.ReverseRequestOpts
reverseOpts.Limit = 1
loc := &base.Location{72.438939, 34.074122}
reverse, err := mapBox.Geocode.Reverse(loc, &reverseOpts)
```
### Directions
```go
import (
"gopkg.in/ryankurte/go-mapbox.v0/lib/directions"
)
var directionOpts directions.RequestOpts
locs := []base.Location{{-122.42, 37.78}, {-77.03, 38.91}}
directions, err := mapBox.Directions.GetDirections(locs, directions.RoutingCycling, &directionOpts)
```
## Layout
- [lib/base](lib/base/) contains a common base for API modules
- [lib/maps](lib/maps/) contains the maps API module
- [lib/directions](lib/directions/) contains the directions API module
- [lib/geocode](lib/geocode/) contains the geocoding API module
---
If you have any questions, comments, or suggestions, feel free to open an issue or a pull request.