N-Ways Maps Platform
Maps, addresses and routes for the apps that move people and parcels 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. NIPOST postcodes, GhanaPost addresses, N-Ways home codes and Plus Codes; routes by okada, zémidjan, Jakarta, bendskin, pen-pen, keke and boat around each city’s bans; fares in naira, cedis, F CFA, Liberian dollars, Guinean francs, leones, escudos and dalasis; live traffic and fleet tracking.
Lagos
An okada from Allen Avenue, Ikeja, to a NIPOST postcode, with the fare.
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}'What comes back
The okada route to the postcode, the ban areas it kept out of (vehicleRules), and what the ride should cost in naira (fares).
Accra
A GhanaPost GPS address, typed the way your customer gives it.
curl "https://nways.ng/maps/v1/geocode?q=GA-183-8164" \
-H "X-NWays-Api-Key: YOUR_API_KEY"What comes back
The place with its coordinates, its GhanaPost address and its Plus Code. The same call takes NIPOST postcodes, N-Ways home codes, landmarks, street names and nicknames, in all fifteen countries.
Geocoding guide
Cotonou
Cadjèhoun to Dantokpa market: what a zémidjan and a taxi should cost, answered in French.
curl -G "https://nways.ng/maps/v1/fares/estimate" \
-d from=6.3605,2.3960 -d to=6.3722,2.4338 \
-d mode=okada,taxi -d lang=fr \
-H "X-NWays-Api-Key: YOUR_API_KEY"What comes back
Low, typical and high prices in F CFA (XOF), from what riders paid, or from published fares until enough riders have answered (basis). On 27 October 2026: 530–995 F CFA by zémidjan, 1,925–3,250 F CFA by taxi.
Lomé
The home code your system stored, back as people say it. No key needed.
curl "https://map.nways.ng/v1/homecodes/TG-FRJ-1058-2"What comes back
Fréau-Jardin 1058, the form people say and type, with the gate to route to, the street address Lomé gave the door (officialAddress: Rue Mission Tové) and the credit to show beside the code.
Libreville
Oloumi to Mont-Bouët market: a taxi to yourself or a seat in a shared one, answered in French.
curl -G "https://nways.ng/maps/v1/fares/estimate" \
-d from=0.3742,9.4638 -d to=0.4012,9.4519 \
-d mode=taxi,shared_taxi -d lang=fr \
-H "X-NWays-Api-Key: YOUR_API_KEY"What comes back
Prices in Central African F CFA (XAF). On 27 October 2026: 2,800–5,200 F CFA for the whole taxi, 180–340 F CFA for a seat in a shared one.
Fares guide
Abidjan
Marcory to the Plateau by woro-woro (shared taxi) or gbaka (minibus), answered in French.
curl -G "https://nways.ng/maps/v1/fares/estimate" \
-d from=5.2887,-3.9883 -d to=5.3220,-4.0180 \
-d mode=shared_taxi,bus -d lang=fr \
-H "X-NWays-Api-Key: YOUR_API_KEY"What comes back
Prices in F CFA, with the rush hour counted (rush). In the evening rush on 27 October 2026: 335–625 F CFA by woro-woro, 240–410 F CFA by gbaka.
Monrovia
Sinkor to Red Light Market: a pen-pen (motorbike taxi) or a shared taxi?
curl -G "https://nways.ng/maps/v1/fares/estimate" \
-d from=6.2922,-10.7795 -d to=6.2924,-10.6908 \
-d mode=okada,shared_taxi \
-H "X-NWays-Api-Key: YOUR_API_KEY"What comes back
Pen-pens are banned in Sinkor, so the pen-pen comes back in notAllowed, with the reason. The shared taxi: L$125–235 in the evening rush on 27 October 2026.
Conakry
Camayenne to the Grand Marché in Madina by moto-taxi or taxi, answered in French.
curl -G "https://nways.ng/maps/v1/fares/estimate" \
-d from=9.5348,-13.6858 -d to=9.5632,-13.6425 \
-d mode=okada,taxi -d lang=fr \
-H "X-NWays-Api-Key: YOUR_API_KEY"What comes back
Prices in Guinean francs (GNF), in whole francs as people pay. In the evening rush on 27 October 2026: 5,500–14,000 FG by moto-taxi, 25,000–60,000 FG by taxi.
Fares guide
Freetown
What’s the home code here? A point at Congo Cross. No key needed.
curl "https://map.nways.ng/v1/homecodes/at?lat=8.4827&lng=-13.2691"What comes back
Freetown 1545, the compound’s home code, beside its official address (officialAddress: FPMJ+39 Freetown), with the gate to route to and each building’s profile.
Bissau
A home code as people say it in Bissau. No key needed.
curl "https://map.nways.ng/v1/homecodes/Bandim%20537"What comes back
The compound’s gate, its written line Bandim 537 · Bissau and how to say it, in Portuguese (spoken): “Bandim, quinhentos e trinta e sete”.
Dakar
Plateau to Sea Plaza: can a Jakarta (motorbike taxi) take you, and what does a taxi cost? Answered in French.
curl -G "https://nways.ng/maps/v1/fares/estimate" \
-d from=14.6663,-17.4395 -d to=14.6938,-17.4747 \
-d mode=okada,taxi -d lang=fr \
-H "X-NWays-Api-Key: YOUR_API_KEY"What comes back
Jakartas are banned in the Dakar region, so the Jakarta comes back in notAllowed: “Pas de Jakarta : les Jakartas sont interdits dans la région de Dakar.” The taxi: 1,225–2,300 F CFA in the evening rush on 27 October 2026.
Douala
Akwa to Kadji Square by bendskin (motorbike taxi) or taxi, answered in French.
curl -G "https://nways.ng/maps/v1/fares/estimate" \
-d from=4.0489,9.7007 -d to=4.0351,9.6941 \
-d mode=okada,taxi -d lang=fr \
-H "X-NWays-Api-Key: YOUR_API_KEY"What comes back
Prices in Central African F CFA (XAF). On 27 October 2026: 120–295 F CFA by bendskin, 2,100–3,900 F CFA by taxi.
Fares guide
Ouagadougou
A home code typed into the ordinary geocoding call.
curl "https://nways.ng/maps/v1/geocode?q=Koulouba+1776" \
-H "X-NWays-Api-Key: YOUR_API_KEY"What comes back
The first result is the compound in Ouagadougou ("category": "homecode"), with the point to go to, its Plus Code and the credit to show (attribution). The same call takes street names and landmarks.
Praia
Palmarejo to Sucupira market by taxi or bus, answered in Portuguese.
curl -G "https://nways.ng/maps/v1/fares/estimate" \
-d from=14.9201,-23.5402 -d to=14.9226,-23.5096 \
-d mode=taxi,bus -d lang=pt \
-H "X-NWays-Api-Key: YOUR_API_KEY"What comes back
Prices in escudos (CVE). In the evening rush on 27 October 2026: 210–400 Esc by taxi, 40–55 Esc by bus.
Fares guide
Banjul
Westfield, Serrekunda, to Albert Market in Banjul by taxi or gele-gele (minibus).
curl -G "https://nways.ng/maps/v1/fares/estimate" \
-d from=13.4483,-16.6783 -d to=13.4541,-16.5717 \
-d mode=taxi,bus \
-H "X-NWays-Api-Key: YOUR_API_KEY"What comes back
Prices in dalasis (GMD). In the evening rush on 27 October 2026: D245–520 by taxi, D20–45 by gele-gele.
Fares guideFrom sign-up to your first map in a minute.
-
Sign up
At the partner console, with Google, Apple or email.
-
Say how you’ll use it
Your app, your deliveries, your ERP or your own product: four ways in. Then your company’s name, and your console is ready at once. Free usage every month.
-
Put it in your app
Three steps on the same screen for a website, Android, iOS or your server. Past the free calls, add credit and pay for what you use.
Four ways in. Which is right for you?
Tell the console which fits when you sign up, and it puts what you need first. Nothing is locked: change your answer any time.
- Add N-Ways to your app
- You have your own app, like a ride-hailing or delivery app. Use the maps, geocoding, routes, arrival times and tracking APIs and SDKs, with your keys, usage and webhooks. Get an API key
- Run your deliveries on N-Ways
- No system of your own? Dispatch, follow and prove deliveries in the console: your riders on the N-Ways Business app, N-Ways drivers, or both. No code. Open a dispatch console
- Dispatch here, synced to your ERP
- Run deliveries on N-Ways and keep SAP, Odoo, Microsoft Dynamics or your own system in step: every event as a signed webhook, plus the export and the fleet API. Connect your ERP
- Build your product on N-Ways
- A tech or logistics company building dispatch or tracking for others: the fleet API, webhooks, SDKs, test projects and the simulator. Fleet tracking
What you can build with.
Every API answers in English, French or Portuguese, and knows the fifteen countries’ addresses, roads and money. All of them are live today.
Maps
- Maps SDK for the webAn N-Ways map in your page, light or dark, with French or Portuguese labels.1.1
- Native maps in your app, with the same calls.1.0, from source
- Tiles APIVector tiles, fonts and hosted styles for your own maps.
- Static mapsA map picture from a URL, for receipts and order pages.
- Offline packsMaps and road data your riders’ apps download ahead.
Addresses and places
- GeocodingAddresses, NIPOST postcodes, GhanaPost, home codes and Plus Codes to coordinates, and back.
- AutocompleteSuggestions as people type an address.
- Address validationCheck and complete an address before you send a rider.
- PlacesBusinesses and places near a point, by category or name.
Routes
- RoutesCar, okada, keke, danfo, walking, boat and train, with traffic, tolls, bans and borders.
- Route matrixTimes between many riders and orders at once, for dispatch.
- Route optimisationThe best order for a rider’s or a small fleet’s deliveries.
- FaresWhat a taxi, okada, keke, bus or boat ride should cost.
Fleet and traffic
- Fleet trackingLive positions, delivery ETAs and tracking links for your customers.
- WebhooksYour server hears when a rider is arriving or a delivery is done.
- TrafficLive congestion from N-Ways phones on the road.
- Traffic feedSpeeds per road and direction, for your own arrival times.
Home codes
A home code for every compound, in 12 countries.
Where streets have no names or numbers, N-Ways has given every compound a code: the name of a quarter or village people already say and a short number, unique in the whole country, that leads to the gate. People get theirs in the N-Ways app with Get my code; where a council has named the street, its address comes first with the code beside it.
Look one up with GET https://map.nways.ng/v1/homecodes/{code}, or ask for the code at a point with /v1/homecodes/at. No key is needed. The geocoding call takes home codes too.
Benin
Cadjéhoun 18 07
Burkina Faso
Koulouba 17 76
Cabo Verde
Palmarejo 12 34
Cameroon
Intendance 137
Côte d’Ivoire
Bonoumin 61 36
Gabon
Louis 12 01
Guinea
Hafia 3 · 1230
Guinea-Bissau
Bandim 537
Senegal
Ouakam 2512
Sierra Leone
Moyamba 157 27
The Gambia
Bakau 2389
Togo
Fréau-Jardin 10 58
Host it yourself
The codes, the areas and the engine are open on GitHub: every issued code, the reference engine with its test vectors, and a ready-made registry server you start with docker compose up. Run lookups on your own servers, offline if you need to, with no calls to N-Ways.
Engine and server Apache 2.0; codes and areas ODbL 1.0, so credit N-Ways where you show them and share a database you make from them under ODbL too; papers CC BY 4.0. Each repository’s LICENSING.md has the exact credit line.
Made for the apps that move West and Central Africa.
- Delivery
- Find the customer from a NIPOST postcode, a GhanaPost address, a home code or a landmark, route the rider to the right gate, and send a tracking link by SMS or WhatsApp. Delivery tracking sample
- Ride-hailing
- Find the pick-up from whatever the customer typed, plan motorbike-taxi and keke trips around each city’s ban areas, and show the fare before the ride. Rider pick-up sample
- Logistics
- Give each order to the rider who gets there first and put a van’s stops in the best order, border crossings included. Dispatch sample
- Fintech
- Check and complete a customer’s address as they type it, and turn it into a point on the map. Address validation
Free every month, then a fraction of Google’s prices.
Each API has its own free calls, every month. Past them you pay per 1,000 calls, less as you grow, priced in your own currency: naira, cedis, F CFA, Liberian dollars, Guinean francs, leones, escudos and dalasis. No US dollars, no exchange rates.
- No card on file. Top up credit or pay a monthly invoice, in your own currency. In Nigeria, Ghana, Benin and Togo, payment is by arrangement: write to us. Elsewhere, the free calls work today and paying past them is by arrangement: write to us. Paying in your country
- Cap your spending. A daily cap per key and API stops a bug or a copied key from running up a bill.
- Startups: early-stage African startups can get six months of Growth usage free, up to a cap. Tell us about yours
| APIand its free calls | Nigerianaira | Ghanacedis | Benin, Togo, Côte d’Ivoire, Guinea-Bissau, Senegal, Burkina Faso, Gabon and CameroonF CFA (XOF and XAF) | LiberiaLiberian dollars | GuineaGuinean francs | Sierra Leoneleones | Cabo Verdeescudos | The Gambiadalasis |
|---|---|---|---|---|---|---|---|---|
| Map loads, web50,000 free a month | ₦2,250 | GH₵22.50 | 900 F CFA | L$220 | 11,000 FG | Le30 | 150 Esc | D73 |
| Map loads, Android and iOS | Free | Free | Free | Free | Free | Free | Free | Free |
| Geocoding and postcodes20,000 free a month | ₦2,250 | GH₵22.50 | 900 F CFA | L$220 | 11,000 FG | Le30 | 150 Esc | D73 |
| Autocomplete, per session20,000 free a month | ₦1,500 | GH₵15 | 600 F CFA | L$150 | 7,500 FG | Le20 | 100 Esc | D50 |
| Routes, basic20,000 free a month | ₦3,000 | GH₵30 | 1,200 F CFA | L$300 | 15,000 FG | Le40 | 200 Esc | D100 |
| Routes with traffic, okada, keke, boat or train10,000 free a month | ₦4,500 | GH₵45 | 1,800 F CFA | L$450 | 22,000 FG | Le60 | 300 Esc | D150 |
| Route matrix, per element25,000 free a month | ₦2,250 | GH₵22.50 | 900 F CFA | L$220 | 11,000 FG | Le30 | 150 Esc | D73 |
Prices per 1,000 calls past the free ones, up to 500,000 calls a month; lower past that. Fleet tracking, route optimisation, the traffic feed and offline packs are by agreement.
| Calls | Free | Cost | |
|---|---|---|---|
| Web map loads | 120,000 | 50,000 | ₦157,500 |
| Geocoding | 60,000 | 20,000 | ₦90,000 |
| Motorcycle routes with traffic | 40,000 | 10,000 | ₦135,000 |
| Total | ₦382,500 | ||
Prices in naira; every country pays in its own currency. Prices for your country
Help when you need it.
-
Documentation
Guides, the API reference, OpenAPI files, a Postman collection and client libraries for TypeScript, Python, Kotlin and Swift.
-
Status
Each API’s state, live, and the incidents of the last 90 days.
-
hello@nways.ng
Questions, integrations and support, in English. Signed-in partners can also ask from the console. Support
Start with the free calls.
Sign up with Google, Apple or email and get your key in a minute. Free usage every month.