Getmapstack

Getmapstack runs routing and geocoding on your own machine. One Docker image per country carries the OpenStreetMap data, the router and the geocoder together, so a single docker run gives you both APIs - no API keys, no per-request billing, and no coordinates leaving your infrastructure.

How do you run Getmapstack?

One command starts a country image and serves both engines:

docker run -p 8002:8002 -p 2322:2322 ghcr.io/roma8ok/getmapstack/cyprus

Routing answers on port 8002, geocoding on port 2322. The images are multi-arch (linux/amd64 and linux/arm64), so the same command works on a server, on Apple Silicon and on AWS Graviton. Nothing is fetched at runtime: the map data is already inside the image.

What does Getmapstack replace?

Getmapstack replaces the hosted routing and geocoding APIs a product would otherwise call over the network - directions, travel-time matrices, isochrones, forward and reverse geocoding, address autocomplete. Because the whole stack runs locally, request volume costs nothing beyond the machine, the same features are available for every country covered by OpenStreetMap, and user coordinates never reach a third party.

Which countries can you get?

Published country images today: Belgium, Brunei, Cyprus, Indonesia, Kazakhstan, Malaysia, Singapore, South Korea and Vietnam. Each is a separate image, built from that country's OpenStreetMap extract, and every image reports the age of its own map data. Countries are added on request.

Can you try Getmapstack without installing anything?

Yes. A public demo endpoint serves routing and geocoding for every supported country at https://api.getmapstack.com, under the /valhalla and /photon path prefixes:

curl "https://api.getmapstack.com/photon/api?q=Nicosia&limit=1"

The demo has no SLA and may change or disappear. Run a container for anything real.

Where is the source?

The build pipeline, the Dockerfiles and the full API documentation are on GitHub under the MIT license, and the country images are published on GitHub Container Registry. Routing is powered by Valhalla and geocoding by Photon, both open source.