osrmroute
ДокументацияБыстрый старт
Документация

API операционного планирования

Эти API поддерживают диспетчерские решения и собственные операционные записи клиента. Это ограниченные модели: они не дают данных о пробках, юридического разрешения, отслеживания в реальном времени или гарантии успеха маршрута, объекта либо доставки.

Аналитика поездки: подтверждение визита

Передайте GPS-образцы с временем, при необходимости геозоны, контрольные точки и плановую геометрию. API сопоставляет трек с картой и возвращает наблюдаемые визиты, статус точек, стоянку и отклонение.

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

Операция не хранит переданные координаты, время и зоны. Результаты выводятся из образцов и не являются юридическим или реальным доказательством присутствия.

Оптимизация грузового парка

Для смешанного парка каждая точная комбинация габаритов и веса получает отдельную статическую грузовую матрицу до назначения 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
      ]
    }
  ]
}'

Недостижимые ячейки матрицы возмещаются. Нет заявления о глобальном оптимуме; условные ограничения, опасные грузы, юридические габариты и трафик не входят в доказательную базу.

Политики маршрутизации: неизменный допуск запроса

Политика — версионируемый контракт рабочего пространства с фиксированными профилем, операциями и разрешёнными зонами GeoJSON.

Создайте или замените её в панели, затем при необходимости привяжите ID к ключу API. Запрос использует неизменную ссылку id@version; привязанный ключ отклоняет другие политики.

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

Проверка выполняется до route, matrix, VRP, isochrone. Политика не меняет граф OSRM, не добавляет юридические правила и не гарантирует полноту географии.

Перед использованием API

Используйте ключ Bearer рабочего пространства с документированным scope, храните собственные бизнес-записи и обрабатывайте неизвестное покрытие, недоступные матрицы и неназначенную работу в приложении. Полная схема и ошибки — в API Reference.

Поддержка OSRMRoute

Напишите нашей команде напрямую

МЫ ГОТОВЫ ПОМОЧЬ

Чем вам помочь?

Напишите нам. Ответы на обращения также отправляются на подтверждённую почту.

Ваши чаты

Ваши чаты появятся здесь.