API documentation

Base URL

https://gw.taxiaddis.com

Authentication

Send your key in the X-API-Key header. For map-tile layers and <img> tags that cannot set headers, use the ?api_key= query parameter instead.

curl -H "X-API-Key: tak_live_xxx" "https://gw.taxiaddis.com/routing/route/v1/driving/38.75,9.01;38.80,9.03"
# or, for tiles:
https://gw.taxiaddis.com/tiles/{z}/{x}/{y}.png?api_key=tak_live_xxx

Services

• Routing (OSRM) — /routing/
• Geocoding (Nominatim) — /geocode/
• Places / POI — /places/
• Map Tiles — /tiles/

Error codes

Status	Code	Meaning
401	invalid_api_key	Missing or unknown key.
403	key_disabled	Key revoked or suspended.
402	insufficient_credits	Balance exhausted — top up.
429	rate_limited	Too many requests.
404	unknown_service	No API mapped to this path.
502	upstream_error	Upstream service failed.
503	gateway_unavailable	Gateway temporarily down.