Traffic feed
Live road speeds from phones on the road, for your own maps, ETAs and dispatch.
N-Ways learns road speeds from phones on the road in Nigeria, Ghana, Benin, Togo, Gabon, Côte d’Ivoire, Liberia, Guinea, Sierra Leone, Guinea-Bissau, Senegal, Cameroon, Burkina Faso, Cabo Verde and The Gambia. Two ways to use them:
| Traffic | Traffic feed | |
|---|---|---|
| For | Drawing congestion on a map | Your own ETAs, dispatch and analytics |
| Address | GET /maps/v1/traffic | GET /maps/v1/fleet/traffic-feed |
| Gives | Congestion level per road, live | Speed in km/h and free-flow speed per road and direction, live or typical for a time of week, as GeoJSON or a stream |
| Plan | Any key with Traffic | By agreement (enterprise) |
The feed
cURL
curl "https://nways.ng/maps/v1/fleet/traffic-feed?bbox=3.30,6.42,3.45,6.55&kind=live&mode=motorcycle" \
-H "X-NWays-Api-Key: YOUR_SERVER_KEY"| Parameter | Description |
|---|---|
bbox | Required. minLng,minLat,maxLng,maxLat, at most 2° across. |
kind | live (the last 30 minutes, default) or typical (for a day type and 15-minute slot). |
at | With kind=typical: the time of week to read; default now. |
mode | car (default) or motorcycle: okadas weave through traffic cars sit in. |
format | geojson (default) or ndjson: an info line, then one road per line, to stream large areas. |
Each feature is a road (an OpenStreetMap way, by wayId) in one direction, with speedKmh, freeFlowKmh and a level: 0 free, 1 slow, 2 heavy, 3 standstill.
Privacy
The feed is aggregated: a road shows only when enough different devices passed (2 for live speeds, 3 for typical ones), and it never contains a trace, a device or a session. Show the attribution from the answer wherever you display the speeds.
Use
- Use the speeds for your own operations and apps. Don’t resell the feed or publish it as a dataset.
- Live speeds are for now: don’t store them to reuse as current speeds later. Keep
typicalspeeds for planning as long as your agreement says.