Routes

Base address: https://nways.ng/maps/v1. Routes, fares and traffic here; for many origins and destinations at once see the route matrix, and for a batch of stops route optimisation. Reference

Get a route

POST /maps/v1/routes/compute with a JSON body.

curl -X POST "https://nways.ng/maps/v1/routes/compute" \
  -H "X-NWays-Api-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"origin": {"lat": 6.6018, "lng": 3.3515}, "destination": {"postcode": "LA08A09DB09"}, "mode": "okada", "fares": true}'

import { createClient } from '@nways/maps'

const nways = createClient({ key: process.env.NWAYS_API_KEY })
const { routes } = await nways.route({
  origin: { lat: 9.0579, lng: 7.4951 },
  intermediates: [{ lat: 9.0765, lng: 7.3986 }],
  destination: { lat: 9.0034, lng: 7.2633 },
  mode: 'drive',
  avoid: ['tolls'],
})
console.log(Math.round(routes[0].durationS / 60), 'min')

import os
import requests

res = requests.post(
    "https://nways.ng/maps/v1/routes/compute",
    headers={"X-NWays-Api-Key": os.environ["NWAYS_API_KEY"]},
    json={"origin": {"lat": 5.6037, "lng": -0.187}, "destination": {"lat": 6.1319, "lng": 1.2228}, "mode": "drive", "lang": "fr"},
    timeout=20,
)
res.raise_for_status()
best = res.json()["routes"][0]
print(round(best["durationS"] / 60), "min")

Request body

?fields= keeps only some fields of each route, such as fields=distanceM,durationS,geometry.

Response

{
  "routes": [
    {
      "distanceM": 1395,
      "durationS": 228,
      "staticDurationS": 228,
      "trafficDelayS": 0,
      "summary": "Admiralty Way and Awudu Ekpekha Boulevard",
      "geometry": { "type": "LineString", "coordinates": [[3.472352, 6.4474], [3.472352, 6.447802], "…"] },
      "legs": [{ "distanceM": 1395, "durationS": 228 }],
      "steps": [
        { "maneuver": "depart_left", "instruction": "Drive north on Victoria Arobieke Street.", "distanceM": 44, "durationS": 6, "streetNames": ["Victoria Arobieke Street"], "startIndex": 0, "endIndex": 1 }
      ],
      "country": "NG"
    }
  ]
}

Errors

Basic routes (car, van, walking and cycling without live traffic, up to 10 stops) and advanced ones (live traffic, okada, keke, danfo, motorbike, boat, train, more than 10 stops, or fares) are priced differently. Pricing

Fares

What a ride should cost, in the country’s money: taxi, shared taxi, okada, keke, danfo or bus, boat and ride-hailing, from what riders paid (basis: crowd) or published sources (basis: guide), with night, rush hour, rain and chartered rides.

GET /maps/v1/fares/estimate

curl "https://nways.ng/maps/v1/fares/estimate?from=6.4474,3.4720&to=6.5244,3.3792&mode=okada,taxi" \
  -H "X-NWays-Api-Key: YOUR_API_KEY"

The answer has the currency and one estimates entry per mode with low, typical and high prices (in the currency’s main unit), a written text such as ₦8,150–15,200, whether it’s perPerson, and its sources. Modes the law keeps off the trip are in notAllowed, with the rule and its source (okadas are banned in much of Lagos).

Live traffic

curl "https://nways.ng/maps/v1/traffic?bbox=3.30,6.40,3.50,6.60" -H "X-NWays-Api-Key: YOUR_API_KEY"

Roads with live readings in a box (minLng,minLat,maxLng,maxLat, under 3° across), as GeoJSON lines with a congestion level, for drawing on a map. Readings come from N-Ways phones on the road, anonymously. Don’t cache it: it changes by the minute. For speeds per road and direction, for your own ETAs, see the traffic feed.

The earlier address

POST https://nways.ng/v1/routes (with from, to and stops) and /v1/fares/estimate keep working for partners who started with them for at least 12 months, but their answers follow the N-Ways app. Move to /maps/v1, whose answers only ever gain fields.