osrmroute
DocumentaçãoInício rápido
Documentação

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

Visit evidence request
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

Heterogeneous truck request
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.

Request admission
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.

Suporte OSRMRoute

Escreva diretamente à nossa equipa

ESTAMOS PARA AJUDAR

Como podemos ajudar?

Envie uma mensagem. As respostas aos pedidos também são enviadas para o seu email verificado.

Suas conversas

Suas conversas aparecerão aqui.