Itinéraires

Adresse de base : https://nways.ng/maps/v1. Ici, les itinéraires, les tarifs et le trafic ; pour de nombreux départs et arrivées à la fois, voyez la matrice d’itinéraires, et pour un lot d’arrêts l’optimisation de tournées. Référence

Obtenir un itinéraire

POST /maps/v1/routes/compute avec un corps JSON.

curl -X POST "https://nways.ng/maps/v1/routes/compute" \
  -H "X-NWays-Api-Key: VOTRE_CLE_API" -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")

Corps de la requête

?fields= ne garde que certains champs de chaque itinéraire, par exemple fields=distanceM,durationS,geometry.

Réponse

{
  "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"
    }
  ]
}

Erreurs

Les itinéraires de base (voiture, camionnette, à pied et à vélo sans trafic en direct, jusqu’à 10 arrêts) et les itinéraires avancés (trafic en direct, okada, keke, danfo, moto, bateau, train, plus de 10 arrêts, ou tarifs) n’ont pas le même prix. Tarifs

Tarifs

Ce que devrait coûter une course, dans la monnaie du pays : taxi, taxi collectif, okada, keke, danfo ou bus, bateau et VTC, d’après ce que les passagers ont payé (basis: crowd) ou des sources publiées (basis: guide), avec la nuit, les heures de pointe, la pluie et les courses privatisées.

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: VOTRE_CLE_API"

La réponse donne la currency et une entrée estimates par mode avec les prix low, typical et high (dans l’unité principale de la monnaie), un text rédigé comme 8 150–15 200 ₦, s’il s’agit d’un prix par personne (perPerson), et ses sources. Les modes que la loi exclut du trajet sont dans notAllowed, avec la règle et sa source (les okadas sont interdits dans une grande partie de Lagos).

Trafic en direct

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

Les routes avec des mesures en direct dans un rectangle (minLng,minLat,maxLng,maxLat, moins de 3° de large), en lignes GeoJSON avec un niveau d’embouteillage, pour les dessiner sur une carte. Les mesures viennent, de façon anonyme, des téléphones N-Ways sur la route. Ne les mettez pas en cache : elles changent d’une minute à l’autre. Pour les vitesses par route et par sens, pour vos propres heures d’arrivée, voyez le flux de trafic.

L’ancienne adresse

POST https://nways.ng/v1/routes (avec from, to et stops) et /v1/fares/estimate continuent de fonctionner pour les partenaires qui les utilisent déjà pendant au moins 12 mois, mais leurs réponses suivent l’application N-Ways. Passez à /maps/v1, dont les réponses ne font que gagner des champs.