osrmroute
DocumentationDémarrage rapide
Documentation

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

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
    }
  ]
}'

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

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
      ]
    }
  ]
}'

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.

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"}'

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.

Assistance OSRMRoute

Écrivez directement à notre équipe

À VOTRE ÉCOUTE

Comment vous aider ?

Envoyez un message. Les réponses aux tickets sont aussi envoyées à votre adresse e-mail vérifiée.

Vos discussions

Vos discussions apparaîtront ici.