API операционного планирования
Эти API поддерживают диспетчерские решения и собственные операционные записи клиента. Это ограниченные модели: они не дают данных о пробках, юридического разрешения, отслеживания в реальном времени или гарантии успеха маршрута, объекта либо доставки.
Аналитика поездки: подтверждение визита
Передайте GPS-образцы с временем, при необходимости геозоны, контрольные точки и плановую геометрию. API сопоставляет трек с картой и возвращает наблюдаемые визиты, статус точек, стоянку и отклонение.
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
}
]
}'Операция не хранит переданные координаты, время и зоны. Результаты выводятся из образцов и не являются юридическим или реальным доказательством присутствия.
Оптимизация грузового парка
Для смешанного парка каждая точная комбинация габаритов и веса получает отдельную статическую грузовую матрицу до назначения 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
]
}
]
}'Недостижимые ячейки матрицы возмещаются. Нет заявления о глобальном оптимуме; условные ограничения, опасные грузы, юридические габариты и трафик не входят в доказательную базу.
Политики маршрутизации: неизменный допуск запроса
Политика — версионируемый контракт рабочего пространства с фиксированными профилем, операциями и разрешёнными зонами GeoJSON.
Создайте или замените её в панели, затем при необходимости привяжите ID к ключу API. Запрос использует неизменную ссылку id@version; привязанный ключ отклоняет другие политики.
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.