APIs de planeamento operacional
Estas APIs apoiam decisões de despacho e registos operacionais do cliente. São modelos limitados: não fornecem trânsito em direto, autorização legal, seguimento em tempo real nem garantia de sucesso de rota, instalação ou entrega.
Análise de viagem: prova de visita
Envie amostras GPS com hora e, opcionalmente, geocercas, pontos de controlo e geometria planeada. A API ajusta o trajeto e devolve visitas observadas, estado, permanência e desvio.
POST /api/v1/trip-analytics/visit-proof · scope: trip-analytics · 2 credits · 2–500 samples
curl --fail-with-body -X POST https://osrmroute.com/api/v1/trip-analytics/visit-proof \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"trace": [
{
"coordinate": [
49.8516,
40.3755
],
"timestamp": "2026-11-16T08:00:00Z"
},
{
"coordinate": [
49.86,
40.38
],
"timestamp": "2026-11-16T08:05:00Z"
}
],
"checkpoints": [
{
"id": "delivery-42",
"location": [
49.86,
40.38
],
"radius_m": 100
}
]
}'A operação não conserva coordenadas, horas ou zonas enviadas. Os resultados são inferidos das amostras; não são prova legal nem em tempo real de presença.
Otimização de frota de camiões
Numa frota mista, cada combinação exata de dimensões e peso recebe uma matriz estática de camião antes da atribuição VROOM.
POST /api/v1/truck/optimize · scope: route · up to 8 vehicles and 40 task endpoints
curl --fail-with-body -X POST https://osrmroute.com/api/v1/truck/optimize \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"vehicles": [
{
"id": "truck-1",
"start": [
49.8516,
40.3755
],
"vehicle": {
"height_m": 3.8,
"weight_t": 12
}
}
],
"services": [
{
"id": 1,
"location": [
49.86,
40.38
]
}
]
}'Células inalcançáveis são reembolsadas. Não há alegação de ótimo global; restrições condicionais, mercadorias perigosas, gabarito legal e trânsito ficam de fora.
Políticas de rotas: admissão imutável
Uma política é um contrato versionado do espaço de trabalho que fixa perfil, operações permitidas e áreas GeoJSON.
Crie-a ou substitua-a no painel e, opcionalmente, associe o ID a uma chave API. Os pedidos usam id@version; uma chave associada rejeita outras políticas.
curl --fail-with-body 'https://osrmroute.com/api/1/matrix' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"points":[[40.3755,49.8516],[40.38,49.86]],"routing_policy":"POLICY_UUID@1"}'A verificação é feita antes de route, matrix, VRP, isochrone. Não altera o grafo OSRM, não adiciona regras legais nem garante completude geográfica.
Antes de utilizar estas APIs
Use uma chave Bearer do espaço de trabalho com o scope documentado, guarde os seus registos e trate cobertura desconhecida, matrizes indisponíveis e trabalho não atribuído na aplicação. Consulte a referência da API para o esquema e erros.