Matrice d’itinéraires

Les temps et distances entre chaque livreur et chaque commande en une requête : la brique de base de l’attribution des courses.

Sur cette page

Demander une matrice
Facturation
La voir à l’œuvre

Le temps de trajet et la distance de chacun de plusieurs départs vers chacune de plusieurs arrivées, en une seule requête : chaque livreur vers chaque commande, chaque entrepôt vers chaque client. La brique de base de l’attribution des courses, du regroupement et des zones de livraison.

Demander une matrice

cURL

curl -X POST "https://nways.ng/maps/v1/routes/matrix?key=VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{"origins": [{"lat": 6.6018, "lng": 3.3515}, {"lat": 6.5005, "lng": 3.3581}], "destinations": [{"lat": 6.5965, "lng": 3.3421}, {"lat": 6.4413, "lng": 3.4250}], "mode": "dispatch"}'

JavaScript

import { createClient } from '@nways/maps'

const nways = createClient({ key: 'VOTRE_CLE_API' })
const { elements } = await nways.matrix({
  origins: [{ lat: 6.6018, lng: 3.3515 }, { lat: 6.5005, lng: 3.3581 }],
  destinations: [{ lat: 6.5965, lng: 3.3421 }, { postcode: 'LA08A09DB09' }],
  mode: 'dispatch',
})

Champ	Description
`origins`, `destinations`	Obligatoires. De 1 à 50 chacun, et au plus 625 paires (départs × arrivées). Chacun est `{ lat, lng }`, `{ postcode }` (la meilleure entrée d’un bâtiment NIPOST), `{ ghanaPost }` ou `{ plusCode }`.
`mode`	`drive` (par défaut), `van`, `okada`, `keke` et `danfo` (qui respectent leurs interdictions, comme Itinéraires), `motorbike` et `dispatch` (motos de coursiers : seules les interdictions visant toutes les motos s’appliquent), `walk` ou `bicycle`.

Les elements de la réponse comptent une entrée par paire : originIndex, destinationIndex, durationS, distanceM et status (OK, ou ROUTE_NOT_FOUND quand aucun chemin ne les relie). Les points à plus de 400 km l’un de l’autre en voiture (200 km dans les autres modes) sont refusés avec MATRIX_TOO_FAR. Référence

Remarque :

Les okadas, les kekes et les danfos respectent leurs zones d’interdiction : une paire qui part d’une zone interdite ou y arrive revient NOT_ALLOWED, avec l’interdiction. Pour classer les motos de vos propres coursiers, qui doivent seulement éviter les routes fermées à toutes les motos, utilisez dispatch.

Facturation

Une matrice est facturée par élément (paire) : 2 départs × 2 arrivées font 4 éléments. Les limites de débit comptent aussi les éléments : 3 000 par minute et par clé par défaut. Tarifs

La voir à l’œuvre

L’exemple d’attribution des courses confie chaque nouvelle commande au livreur qui peut l’atteindre le premier.