Operasyonel planlama API'leri
Bu API'ler sevk kararlarını ve müşterinin kendi operasyon kayıtlarını destekler. Sınırlı modellerdir: canlı trafik, hukuki izin, gerçek zamanlı takip ya da rota, tesis veya teslimat başarısı garantisi sunmaz.
Yolculuk analitiği: ziyaret kanıtı
Zaman damgalı GPS örneklerini isteğe bağlı coğrafi çitler, kontrol noktaları ve planlanan geometri ile gönderin. API izi eşler; gözlenen ziyaret, durum, bekleme ve sapmayı döndürür.
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
}
]
}'İşlem koordinatları, zamanları ve bölgeleri saklamaz. Sonuçlar örneklerden çıkarılır; hukuki veya gerçek zamanlı bulunma kanıtı değildir.
Kamyon filosu optimizasyonu
Karma filo için her kesin boyut ve ağırlık birleşimi, VROOM atamasından önce ayrı statik kamyon matrisi alır.
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
]
}
]
}'Ulaşılamayan hücreler iade edilir. Küresel optimum iddiası yoktur; koşullu kısıtlar, tehlikeli yük, yasal açıklık ve trafik kapsam dışıdır.
Rota politikaları: değişmez istek kabulü
Rota politikası, profili, izinli işlemleri ve GeoJSON alanlarını sabitleyen sürümlü çalışma alanı sözleşmesidir.
Panelde oluşturun veya değiştirin; ardından ID'sini isteğe bağlı API anahtarına bağlayın. İstekler id@version kullanır; bağlı anahtar başka politikaları reddeder.
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"}'Kontrol route, matrix, VRP, isochrone motorundan önce yapılır. OSRM grafını değiştirmez, hukuki kural eklemez ve coğrafi tamlık garantilemez.
Bu API'leri kullanmadan önce
Belgelenmiş scope ile çalışma alanına ait Bearer anahtarı kullanın, kendi iş kayıtlarınızı saklayın ve bilinmeyen kapsamı, kullanılamayan matrisleri ve atanmamış işi uygulamanızda yönetin. Tam şema ve hata sözleşmesi için API Reference bölümüne bakın.