Routing & Navigation
Turn-by-turn routing, live traffic conditions, transit (bus / trotro) itineraries, distance matrices, isochrones, GPX export, and landmark narration powered by Valhalla and OTP2.
Landmarks covering or near a hex cell
Returns landmarks whose polygons contain the hex centroid ('inside') and
Geocode a free-text landmark to coordinates
Resolves a landmark by name to coordinates — Ghanaians navigate by
Report a landmark as wrong for turn-by-turn narration
Crowdsourced, anonymous — no API key, no admin review queue, same posture as `POST /v2/route/incidents`. Reports for the same landmark reinforce (increment `report_count`) rather than duplicate; there's no expiry, since a wrong landmark match is a persistent data problem, not a transient event. Once a landmark accumulates enough corroborated reports, it's automatically excluded from narration candidate selection (`instruction_landmark`/`landmark_confidence`/`alternate_landmarks` on `POST /v2/route`) until reviewed — general landmark search, geocoding, and POI density are unaffected.
Record that a rider picked a landmark
Call when a rider picks a landmark — a search result, a 'business around me' tap. Anonymous, no API key, rate-limited per client. The running `selected_count` is a recognisability signal for turn-by-turn narration: landmarks riders actually look for are more likely to be named in `instruction_landmark`. The ranking log-scales and caps it, so repeated calls buy little.
Resolve a hex code to a precise point
Converts a hex code to its best-known coordinates. Returns a structure-
Get a turn-by-turn route
Returns a turn-by-turn route between two points. Endpoints can be supplied
Distance and duration matrix
Computes a distance-and-duration matrix between N sources and M destinations.
Optimized multi-stop route
Finds the most efficient order to visit a list of stops using a
Plan routes for a fleet
**Paid API plans only** (basic, pro, enterprise). Other keys get
Isochrone / service area
Returns the area reachable from a location within specified travel-time
Find landmarks along a route
Given a route polyline the client already has, returns landmarks near
Map matching / GPS trace snapping
Snaps a GPS trace to the road network using Valhalla's map-matching engine.
Routing engine health
Returns the health of the Valhalla routing engine and the age of the OSM
Static route map image (PNG)
Renders the computed route as a static map image (Geoapify osm-bright,
Flood-prone zones currently in effect
Returns the flood-prone zones in effect right now as a GeoJSON
Active crowdsourced road-hazard reports
Returns currently active, unexpired road-hazard reports (accident,
Report a road hazard
Report an accident, flooding, blocked road, or police checkpoint at
Live traffic conditions
Returns the current congestion conditions for all four road classes
Plan a transit (bus / trotro) trip
Plans a point-to-point trip on the public transport network (Accra
What leaves from here? (nearby boardable transit lines)
The reverse of trip planning: given a point, returns the trotro/bus
Create or replace a landmark (admin)
Upserts a landmark polygon used for landmark narration. The `slug` is the
Recompute hex coverage for a landmark (admin)
Sweeps the landmark's bounding box at H3 resolution 7 and reclassifies
Promote a hex to structure-precision routing (admin)
Manually maps a structure-precision point for a hex code. When a user
Count landmarks by kind around a point
Returns how many landmarks of each kind are within `radius` metres of a
Turn-by-turn route for a client app (no user key)
The same request and response as `POST /v2/route`, for apps whose end
Route as a GPX file
Takes the same body as `POST /v2/route` and returns the route as a GPX 1.1
Snap a GPX track to the road network
Upload a GPX file (raw body, or a multipart `file` field; max 8 MB) and get
Route for turn-by-turn navigation clients (OSRM format)
Takes the same body as `POST /v2/route` and returns the routing engine's
Turn a spoken navigation command into destination candidates
Send a navigation command your app has already transcribed (English, for
POI counts for one hex cell
Landmark counts by kind inside one AfriHex cell.