Percursos

Endereço base: https://nways.ng/maps/v1. Aqui, os percursos, as tarifas e o trânsito; para muitas origens e destinos de uma vez, veja a matriz de percursos, e para um lote de paragens a otimização de rotas. Referência

Obter um percurso

POST /maps/v1/routes/compute com um corpo JSON.

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

Corpo do pedido

?fields= mantém só alguns campos de cada percurso, por exemplo fields=distanceM,durationS,geometry.

Resposta

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

Erros

Os percursos básicos (carro, carrinha, a pé e de bicicleta sem trânsito em tempo real, até 10 paragens) e os avançados (trânsito em tempo real, okada, keke, danfo, mota, barco, comboio, mais de 10 paragens, ou tarifas) têm preços diferentes. Preços

Tarifas

Quanto deveria custar uma viagem, na moeda do país: táxi, táxi coletivo, okada, keke, danfo ou autocarro, barco e transporte por aplicação, segundo o que os passageiros pagaram (basis: crowd) ou fontes publicadas (basis: guide), com a noite, as horas de ponta, a chuva e as viagens fretadas.

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

A resposta dá a currency e uma entrada estimates por modo com os preços low, typical e high (na unidade principal da moeda), um text redigido como 8 150–15 200 ₦, se é um preço por pessoa (perPerson), e as suas sources. Os modos que a lei exclui da viagem estão em notAllowed, com a regra e a sua fonte (os okadas são proibidos em grande parte de Lagos).

Trânsito em tempo real

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

As estradas com medições em tempo real dentro de um retângulo (minLng,minLat,maxLng,maxLat, com menos de 3° de largura), em linhas GeoJSON com um nível de congestionamento, para desenhar num mapa. As medições vêm, de forma anónima, dos telemóveis com N-Ways na estrada. Não as guarde em cache: mudam de minuto para minuto. Para as velocidades por estrada e por sentido, para as suas próprias horas de chegada, veja o feed de trânsito.

O endereço antigo

POST https://nways.ng/v1/routes (com from, to e stops) e /v1/fares/estimate continuam a funcionar para os parceiros que já os usam durante pelo menos 12 meses, mas as suas respostas acompanham a aplicação N-Ways. Passe para /maps/v1, cujas respostas só ganham campos.