osrmroute
DokümanlarHızlı başlangıç
Dokümanlar

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

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

İş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

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

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.

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

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.

OSRMRoute Destek

Ekibimize doğrudan yazın

YARDIMA HAZIRIZ

Nasıl yardımcı olabiliriz?

Mesaj gönderin. Talep yanıtları doğrulanmış e-posta adresinize de gönderilir.

Sohbetleriniz

Sohbetleriniz burada görünecek.