API de planification opérationnelle
Ces API soutiennent la répartition et les dossiers opérationnels du client. Ce sont des modèles bornés : pas de trafic en direct, d'autorisation juridique, de suivi temps réel ni de garantie de réussite d'un trajet, site ou livraison.
Analyse de trajet : preuve de visite
Envoyez des échantillons GPS horodatés avec, si besoin, géozones, points de contrôle et géométrie prévue. L'API rapproche la trace et renvoie visites observées, état, durée d'arrêt et écart.
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
}
]
}'L'opération ne conserve ni coordonnées, ni heures, ni zones. Les résultats sont déduits des échantillons, jamais une preuve juridique ou temps réel de présence.
Optimisation de flotte de camions
Pour une flotte mixte, chaque combinaison exacte de dimensions et poids reçoit une matrice camion statique distincte avant l'affectation 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
]
}
]
}'Les cellules inaccessibles sont remboursées. Aucune optimalité globale n'est affirmée ; restrictions conditionnelles, marchandises dangereuses, gabarit légal et trafic sont exclus.
Politiques de routage : admission immuable
Une politique est un contrat versionné de l'espace de travail qui fixe profil, opérations permises et zones GeoJSON.
Créez-la ou remplacez-la dans le tableau de bord, puis liez éventuellement son ID à une clé API. Les requêtes utilisent id@version ; une clé liée refuse les autres politiques.
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"}'Le contrôle est fait avant route, matrix, VRP, isochrone. Il ne modifie pas le graphe OSRM, n'ajoute pas de règles juridiques et ne garantit pas la complétude géographique.
Avant d'utiliser ces API
Utilisez une clé Bearer de l'espace de travail avec le scope documenté, conservez vos dossiers et gérez couverture inconnue, matrices indisponibles et travail non attribué dans votre application. Consultez la référence API pour le schéma et les erreurs.