luzifer/staticmap
1
0
Fork 0
mirror of https://github.com/Luzifer/staticmap.git synced 2024-10-18 07:34:23 +00:00
Code Issues Releases Wiki Activity
Webserver to generate static maps from OpenStreetMap tiles
17 commits 2 branches 10 tags 3.4 MiB
Go 93.2%
Dockerfile 4%
Makefile 2.8%
Find a file
Knut Ahlers cfc21d4049
Allow disabling of attribution rendering 
Signed-off-by: Knut Ahlers <knut@ahlers.me>
2018-04-03 21:20:34 +02:00
example Add meta files 2017-06-27 23:42:36 +02:00
vendor Allow disabling of attribution rendering 2018-04-03 21:20:34 +02:00
.gitignore Initial version 2017-06-27 22:49:53 +02:00
.repo-runner.yaml Add auto-build 2017-06-27 23:11:49 +02:00
cache.go Allow disabling of attribution rendering 2018-04-03 21:20:34 +02:00
cache_filesystem.go Allow disabling of attribution rendering 2018-04-03 21:20:34 +02:00
CONTRIBUTING.md Add meta files 2017-06-27 23:42:36 +02:00
Dockerfile Follow hadolint advices 2018-04-03 20:39:24 +02:00
Gopkg.lock Allow disabling of attribution rendering 2018-04-03 21:20:34 +02:00
Gopkg.toml Allow disabling of attribution rendering 2018-04-03 21:20:34 +02:00
History.md prepare release v0.2.0 2018-04-03 20:39:44 +02:00
LICENSE Add meta files 2017-06-27 23:42:36 +02:00
main.go Allow disabling of attribution rendering 2018-04-03 21:20:34 +02:00
Makefile Add auto-build 2017-06-27 23:11:49 +02:00
map.go Allow disabling of attribution rendering 2018-04-03 21:20:34 +02:00
README.md Add meta files 2017-06-27 23:42:36 +02:00

README.md

Luzifer / staticmap

staticmap is a webserver written in Go to generate static maps from OpenStreetMap tiles. Its API is inspired by the Google Static Maps API but supports only a subset of the functions and parameters described there.

API

All map operations are made against the /map.png endpoint of the server and are controlled by parameters:

Parameter Description
center (required) Describes where to center the map. Must be given in decimal coordinates in format lat,lon (eg. 62.107733,-145.541936)
zoom (required) Describes the zoom level of the map. Must be a number between 1 and 16 like in the OpenStreetMap itself
size (required) Output format of the requested map. Must be two numbers joined by an x (eg. 600x300) - By default there is a limit to 1024px on each edge, you can set this in the parameters of the server.
markers (optional) Marker definition, supports size and color attribute and marker positions must be given in format lat,lon. Elements of the marker definition are joined by a vertical bar. Valid sizes are tiny, mid, small. Valid colors are black, brown, green, purple, yellow, blue, gray, orange, red, white or a hex color in 3 or 6 letter notation: 0x333, 0x333333.

Example of a map having two different markers

/map.png
    ?center=53.5438,9.9768
    &zoom=15
    &size=800x500
    &markers=color:blue|53.54129165,9.98420576699353
    &markers=color:yellow|53.54565525,9.9680555636958

The map center is set to a coordinate within Hamburg, Germany with a zoom level of 15. Additionally there are two markers set: One blue marker to the Elbphilharmonie, one yellow marker to the Hard Rock Cafe Hamburg. The example above (of course without the line breaks) produced this image:

Setup

  • There is a Docker container available: quay.io/luzifer/staticmap
  • This repository has precompiled binaries attached in the releases section
  • You can go get github.com/Luzifer/staticmap the project and build it from source

Afterwards just see staticmap --help (or docker run --rm -ti quay.io/luzifer/staticmap --help) for commandline parameters.