Skip to main content

Get a turn-by-turn route

POST 
/v2/route

Returns a turn-by-turn route between two points. Endpoints can be supplied as hex codes or raw lat/lng coordinates — exactly one form per endpoint.

Modes: driving (default), foot, bicycle, motor_scooter (okada).

Narration: Controls whether steps include landmark-based instructions:

  • street — standard street-name instructions only (default)
  • landmark — rewrite instructions to reference nearby landmarks
  • both — include both the standard and landmark-enriched instruction

Alternatives: Up to 2 alternative routes are returned in alternatives.

Traffic: eta_s is traffic-adjusted using Ghana-specific time-of-day multipliers (morning/evening rush, market days). duration_s is the raw Valhalla estimate with no traffic applied.

Verbal instructions: verbal_instruction on each step is a pre-built voice prompt suitable for text-to-speech ("In 300 metres, turn right onto Ring Road Central").

Request​

Responses​

Route calculated successfully