N-Ways
Documentação para programadoresMatriz de percursos

Está a desenvolver com o N-Ways?

Obter uma chave de API

Matriz de percursos

Os tempos e as distâncias entre cada estafeta e cada encomenda num só pedido: a peça base da atribuição de entregas.

Nesta página

O tempo de viagem e a distância de cada uma de várias origens para cada um de vários destinos, num só pedido: cada estafeta para cada encomenda, cada armazém para cada cliente. A peça base da atribuição de entregas, do agrupamento e das zonas de entrega.

Pedir uma matriz

cURL
curl -X POST "https://nways.ng/maps/v1/routes/matrix?key=A_SUA_CHAVE_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: 'A_SUA_CHAVE_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',
})
CampoDescrição
origins, destinationsObrigatórios. De 1 a 50 cada, e no máximo 625 pares (origens × destinos). Cada um é { lat, lng }, { postcode } (a melhor entrada de um edifício NIPOST), { ghanaPost } ou { plusCode }.
modedrive (por omissão), van, okada, keke e danfo (que respeitam as suas proibições, como em Percursos), motorbike e dispatch (motas de estafetas: só se aplicam as proibições a todas as motas), walk ou bicycle.

Os elements da resposta têm uma entrada por par: originIndex, destinationIndex, durationS, distanceM e status (OK; ROUTE_NOT_FOUND quando não há caminho entre eles; NOT_ALLOWED quando o modo é proibido numa das pontas, com a ban). Os pontos a mais de 400 km um do outro de carro (200 km nos outros modos) são recusados com MATRIX_TOO_FAR. Referência

Nota:

Os okadas, os kekes e os danfos respeitam as suas zonas de proibição: um par que parte de uma zona proibida ou chega a ela volta NOT_ALLOWED, com a proibição. Para ordenar as motas dos seus próprios estafetas, que só têm de evitar as estradas fechadas a todas as motas, use dispatch.

Faturação

Uma matriz é faturada por elemento (par): 2 origens × 2 destinos são 4 elementos. Os limites de pedidos também contam elementos: 3 000 por minuto e por chave por omissão. Preços

Vê-la em ação

O exemplo de atribuição de entregas entrega cada nova encomenda ao estafeta que lá consegue chegar primeiro.