API de planificación operativa
Estas API apoyan decisiones de despacho y registros operativos del cliente. Son modelos acotados: no ofrecen tráfico en vivo, autorización legal, seguimiento en tiempo real ni garantía de éxito de una ruta, instalación o entrega.
Analítica de viaje: prueba de visita
Envíe muestras GPS con hora y, opcionalmente, geocercas, puntos de control y geometría prevista. La API ajusta el trazado y devuelve visitas observadas, estado, permanencia y desviación.
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
}
]
}'La operación no conserva coordenadas, horas ni zonas enviadas. Los resultados se infieren de las muestras; no son prueba legal ni en tiempo real de presencia.
Optimización de flota de camiones
Para una flota mixta, cada combinación exacta de dimensiones y peso recibe una matriz estática de camión antes de la asignación 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
]
}
]
}'Las celdas inalcanzables se reembolsan. No se afirma optimalidad global; restricciones condicionales, mercancías peligrosas, gálibo legal y tráfico quedan fuera.
Políticas de rutas: admisión inmutable
Una política es un contrato versionado del espacio de trabajo que fija perfil, operaciones permitidas y áreas GeoJSON.
Créela o reemplácela en el panel y, opcionalmente, vincule su ID a una clave API. Las solicitudes usan id@version; una clave vinculada rechaza otras 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"}'Se comprueba antes de route, matrix, VRP, isochrone. No cambia el grafo OSRM, añade reglas legales ni garantiza cobertura geográfica.
Antes de usar estas API
Use una clave Bearer del espacio de trabajo con el scope documentado, conserve sus registros y gestione cobertura desconocida, matrices no disponibles y trabajo sin asignar en su aplicación. Consulte la referencia de API para el esquema y los errores.