Skip to main content
Menu
Yeni · API v2

Truck Route API: rota boyunca akaryakıt istasyonları ve tır parklarıyla kamyon rota planlama

Tek bir çağrı; aracınıza uygun bir kamyon rotası, AB sürüş süresi kurallarına göre bir sürücü dinlenme planı ve yol boyunca akaryakıt istasyonları ile tır parklarını döndürür — güncel fiyatlar, başlangıç noktasına uzaklık ve her birinin gerektirdiği sapma ile birlikte.

TruckTurn kamyon navigasyon uygulamamızla aynı rota motoru tarafından hesaplanır.

Ücretsiz API anahtarı alın Dokümantasyonu okuyun Fiyatlandırmayı görün

Filolar, sevkiyat ve TMS için tır rota planlayıcı

Taşımacı sevkiyat birimleri

Sürücü yola çıkmadan önce araca uygun bir tır rotası planlayın ve aracın yol boyunca nerede yakıt alıp dinlenebileceğini görün.

TMS ve ERP sağlayıcıları

Bir rota motoru geliştirmeden, barındırmadan veya bakımını yapmadan taşımacılık yönetim yazılımınıza bir kamyon rota planlama API'si ekleyin.

Filo telematiği

Canlı konumu ve sürücünün takograf durumunu dinlenme molalarını içeren gerçekçi bir ETA'ya dönüştürün, bir sonraki yakıt ya da park durağını önerin.

Yük pazar yerleri

Yükleri otomobil rotası yerine kamyona uygun mesafe ve molaları içeren sürüş süresi üzerinden fiyatlandırın.

Tek çağrıda neler alırsınız

Kamyon rota API'si

Aracınızın yüksekliğine, ağırlığına, uzunluğuna, genişliğine ve dingil yüküne ve beyan ettiğiniz tehlikeli madde sınıfına uyan mesafe, süre ve rota geometrisi.

Kamyon yasakları ve uygunluk kontrolleri

Bildiğimiz kamyon trafik yasakları ve araç kısıtlamaları rota hesaplanırken dikkate alınır.

AB sürüş süresi dinlenme planı

EU Regulation 561/2006 kapsamında molalar, günlük ve haftalık dinlenmeler; her biri rota üzerindeki bir tır parkına saatleriyle birlikte yerleştirilir.

Rota boyunca akaryakıt istasyonları

Rotaya yakın istasyonlar; elimizde olduğu yerlerde güncel fiyatlarıyla, karşınıza çıkacakları kilometre ve sapma mesafesiyle.

Rota boyunca tır parkları

Başlangıçtan itibaren kilometresi ve rotadan sapma mesafesiyle tır parkları ve dinlenme tesisleri.

Rota boyunca kantarlar

Rota üzerindeki kamyon kantarları ve tartı istasyonları, her birinin karşınıza çıkacağı kilometreyle birlikte.

Ülkelere göre geçiş ücretleri

Rotadaki kamyon geçiş ücretlerinin dingil sayınıza ve ağırlığınıza göre ülke bazında ve ücretli tüneller ile köprüler için euro cinsinden tahmini. Henüz fiyatlandıramadığımız ülkeler yanıtta belirtilir, asla ücretsiz sayılmaz.

Tehlikeli maddeler ve kaçınma seçenekleri

Yükünüzün ADR sınıflarını ve tünel kısıtlama kodunu (B, C, D veya E) beyan edin; kategorisi buna izin vermeyen tünellerden, kategorinin haritada bulunduğu yerlerde kaçınılır. Ayrıca ücretli yollardan, feribotlardan, otoyollardan, sınır kapılarından, tünellerden, asfaltsız yollardan ve düşük emisyon bölgelerinden kaçınabilirsiniz.

Eko rota

En kısa sürüş süresi yerine daha düşük yakıt tüketimini önceleyen bir rota isteyin.

Rusya ve Kaliningrad'dan kaçınır

Rotalar asla Rusya'dan veya Kaliningrad'dan geçmez.

AB sürüş süresi kurallarına göre sürücü dinlenme planı (561/2006 sayılı Tüzük)

Rotaya entegre bir tır mola planlayıcı. API; sürüş süresini, molaları ve dinlenmeleri EU Regulation 561/2006'da tanımlandığı şekilde planlar ve her durağı rota boyunca gerçek bir tır parkına yerleştirir — böylece aldığınız ETA kesintisiz sürüş süresi değil, dinlenme molalarını içeren bir kamyon ETA'sıdır.

Bir planlama yardımcısıdır; takograf kaydı veya hukuki tavsiye değildir. Sürüş süresi kurallarına uyulmasından sürücü ve işletmeci sorumlu olmaya devam eder.

Rota boyunca trafik tahmini

Varsayılan olarak rotanın süresi, isteği gönderdiğiniz ana göre değil, kamyonun her bölümden fiilen geçeceği ana yönelik bir trafik tahminiyle hesaplanır. Tahmin zaman çizelgesi ETA'yı, EU 561 dinlenme planını, sürüş yasaklarının zamanlamasını ve sınır kapılarına varış zamanını belirler.

Bir planlama tahminidir, garanti değildir. Veri toplama Eylül 2026'da başladı; bu nedenle öğrenilen kalıplar henüz yenidir ve haftalar biriktikçe iyileşir. Hava durumu her yerde kapsanmaz. Bir alternatif daha hızlı göründüğünde yanıtta önerilir; birincil rota sizin yerinize hiçbir zaman değiştirilmez.

Parametre: traffic

DeğerNe yapar
traffic=forecastVarsayılan. Öğrenilen tekrarlayan sıkışıklık, artı geçiş anındaki canlı trafik, yol çalışmaları, kapatmalar ve hava durumu.
traffic=liveYalnızca güncel trafik; öğrenilen hafta günü ve saat kalıbı olmadan.
traffic=offTrafik katmanı yok: rotanın süresi serbest akış sürüş süresiyle hesaplanır.

Yanıt bloğu: traffic_forecast

Yanıt bir traffic_forecast bloğu ekler: serbest akış ve tahmin edilen süreler, nedene göre ayrılmış gecikme (recurring, live, roadworks, weather), rota üzerindeki hotspots (ETA, neden, yol, güven ve hafta günü-saat bilgileriyle), rota üzerindeki hava noktaları, kaçınılan kapatmalar, daha hızlı olacağı tahmin edildiğinde önerilen bir alternatif ve coverage rakamları. Her alternatif rota forecast_duration_s taşır ve her sürüş yasağı, eta_at_ban_free yanında tahmin zaman çizelgesindeki eta_at_ban değerini taşır.

curl "https://nakordoni.eu/api/v2/data/truck-route?from=52.4064,16.9252&to=45.4642,9.1900&weight=40&height=4&alternatives=1&depart_at=2026-10-09T13:00:00%2B02:00&traffic=forecast" \
  -H "Authorization: Bearer $NKD_API_KEY"
Gerçek bir yanıt alıntısını göster 
{
  "traffic_forecast": {
    "model": "nkd-traffic-forecast-2",
    "mode": "forecast",
    "duration_base": "free_flow",
    "duration_s_free": 51732,
    "duration_s_forecast": 52067,
    "delay_s": { "recurring": 335, "live": 0, "roadworks": 0, "weather": 0, "total": 335 },
    "hotspots": [
      { "km_from_start": 0.5, "km_to": 4, "eta": "2026-10-09T13:00:32+02:00", "delay_s": 67,
        "reason": "recurring", "label": "Recurring congestion (historical pattern)", "road": "433, 196",
        "confidence": "low", "dow_hour": "Fri 13-14h", "delay_by_reason": { "recurring": 67 },
        "country": "PL", "jam_frequency": 1, "observations": 4 },
      { "km_from_start": 232, "km_to": 256, "eta": "2026-10-09T15:36:12+02:00", "delay_s": 248,
        "reason": "recurring", "label": "Recurring congestion (historical pattern)", "road": "L30",
        "confidence": "low", "dow_hour": "Fri 15-16h", "delay_by_reason": { "recurring": 248 },
        "country": "DE", "jam_frequency": 0.35, "observations": 3 }
    ],
    "weather_on_route": [
      { "km_from_start": 145, "eta": "2026-10-09T14:38:03+02:00", "temp_c": 14.8, "precip_mm_h": 0,
        "precip_type": null, "wind_gust_kmh": 17, "visibility_km": 25.8, "speed_factor": 1, "effects": [] }
    ],
    "closures_avoided": [],
    "recommended_alternative": null,
    "coverage": {
      "profile_cells_hit": 44, "ensemble_cells_hit": 0, "ensemble_cells_in_horizon": 0, "route_cells": 823,
      "sampled_since": "2026-09-15", "max_observations_per_weekday_hour": 54, "live_traffic_age_min": 44,
      "weather_covered_km": 55, "route_km": 1291.8,
      "note": "Recurring congestion is learned from our own traffic observations since 2026-09-15 … Delays are the excess over free-flow truck speed. …"
    },
    "calc_ms": 1345
  },
  "alternatives": [
    { "distance_m": 1359314, "duration_s": 54373, "forecast_duration_s": 54707, "…": "…" }
  ],
  "route": {
    "truck_bans": [
      { "name": "Seasonal", "country": "AT", "eta_at_ban": "2026-10-10T11:28:47+02:00",
        "eta_at_ban_free": "2026-10-09T23:38:13+02:00", "…": "…" }
    ],
    "…": "…"
  }
}

Gerçek bir yanıt; iki hotspot, bir hava noktası, bir alternatif ve bir yasağa kısaltıldı; uzun metinler kısaltıldı. Belgeler alanların tam listesini içerir.

Gerçek bir hesaplamayı görün

Popüler kamyon rotaları için API tarafından hesaplanmış kayıtlı yanıtlar — aşağıdaki harita, dinlenme durakları ve ETA, API'nin döndürdüğü sonuçlardır; bu sayfadan yapılan canlı bir çağrı değildir.

  • Akaryakıt istasyonu
  • Tır parkı
  • Kantar
  • Mola
  • Günlük dinlenme
  • Haftalık dinlenme
  • Sınırda bekleme
Mesafe930 km
Sürüş süresi10 sa 22 dk
Dinlenmeler dahil toplam süre22 sa 7 dk
  1. Kalkış1. gün, 06:00
  2. Sürüş · 394 km · 4 sa 24 dk
  3. Mola · 45 dk 1. gün, 10:24 · konum: Raststätte Börde-Nord 1, Hohe Börde
  4. Sürüş · 401 km · 4 sa 27 dk
  5. Günlük dinlenme · 11 sa 0 dk 1. gün, 15:37 · konum: Punkt 9749
  6. Sürüş · 135 km · 1 sa 29 dk
  7. Varış (ETA)2. gün, 04:06

İstek

GET https://nakordoni.eu/api/v2/data/truck-route?from=52.4064,16.9252&to=51.9244,4.4777&weight=40&height=4&crew=1&depart=2026-10-12T06:00:00%2B02:00
Yanıt kesiti 
{
    "slug": "poznan-rotterdam",
    "title": "Poznań → Rotterdam",
    "request_url": "https://nakordoni.eu/api/v2/data/truck-route?from=52.4064,16.9252&to=51.9244,4.4777&weight=40&height=4&crew=1&depart=2026-10-12T06:00:00%2B02:00",
    "departure": "2026-10-12T06:00:00+02:00",
    "geometry": "…",
    "totals": {
        "distance_km": 930,
        "driving_min": 622,
        "total_min": 1327,
        "border_wait_min": 0
    },
    "countries": [
        "PL",
        "DE",
        "…"
    ],
    "border_crossings": [],
    "tolls": {
        "currency": "EUR",
        "total_eur": 245.9,
        "complete": true,
        "by_country": [
            {
                "country": "DE",
                "km_toll": 556.4,
                "cost_eur": 193.63,
                "basis": "distance-based HGV toll: tolled km × per-km truck rate for this axle/weight class"
            },
            {
                "country": "NL",
                "km_toll": 204,
                "cost_eur": 31.82,
                "basis": "distance-based HGV toll: tolled km × per-km truck rate for this axle/weight class"
            },
            {
                "country": "PL",
                "km_toll": 159.3,
                "cost_eur": 20.45,
                "basis": "distance-based HGV toll: tolled km × per-km truck rate for this axle/weight class"
  …

Hesaplanma: 2026-10-09 04:30 UTC

Örnek istek ve yanıt

curl "https://nakordoni.eu/api/v2/data/truck-route?from=52.4064,16.9252&to=45.4642,9.1900&weight=40&height=4&include=fuel,parking" \
  -H "Authorization: Bearer $NKD_API_KEY"
{
  "route": {
    "distance_km": 1186.4,
    "driving_time_min": 905,
    "eta": "2026-10-04T18:40:00+02:00",
    "vehicle": { "weight_t": 40, "height_m": 4.0 },
    "geometry": "…"
  },
  "rest_plan": [
    { "type": "break_45", "km_from_start": 352.1,
      "arrive": "2026-10-04T10:31:00+02:00", "depart": "2026-10-04T11:16:00+02:00",
      "parking": { "name": "…", "detour_km": 0.3 } },
    { "type": "daily_rest", "hours": 11, "km_from_start": 708.9, "parking": { "name": "…" } }
  ],
  "fuel": [
    { "name": "…", "km_from_start": 118.6, "detour_km": 0.8,
      "prices": { "diesel": 1.629 }, "currency": "EUR" }
  ],
  "parking": [
    { "name": "…", "km_from_start": 352.1, "detour_km": 0.3, "spaces": 60 }
  ]
}

Kısaltılmış ve temsilîdir — alan adları yayından önce hâlâ değişebilir. Tam parametre listesi ve yanıt şeması dokümantasyonda yer alır.

Kapsam

Rotalama Avrupa'yı kapsar ve asla Rusya'dan veya Kaliningrad'dan geçmez. Akaryakıt fiyatları ve park yoğunluğu ülkeye göre değişir — aşağıdaki listeler doğrudan canlı verilerimizden gelir.

Akaryakıt istasyonu fiyatları olan ülkeler

Güncel istasyon fiyatları yalnızca bu ülkelerde mevcuttur. Diğer yerlerde rota, dinlenme planı ve park bilgisi yine çalışır, ancak akaryakıt fiyatları döndürülmez.

  • İtalya · 58,659 istasyon
  • Almanya · 43,672 istasyon
  • İspanya · 39,429 istasyon
  • Fransa · 31,496 istasyon
  • Yunanistan · 14,154 istasyon
  • Portekiz · 9,807 istasyon
  • Norveç · 4,001 istasyon
  • Hırvatistan · 2,540 istasyon
  • Avusturya · 1,996 istasyon
  • Slovenya · 1,736 istasyon
  • Polonya · 151 istasyon · sınırlı kapsam

Ülkelere göre tır parkları

Elimizdeki tır parkı konumları, ülkelere göre. Kapsam bazı ülkelerde diğerlerinden daha yoğundur.

  • Polonya · 6,286 park alanı
  • Almanya · 3,518 park alanı
  • Fransa · 1,184 park alanı
  • Çekya · 963 park alanı
  • Romanya · 924 park alanı
  • Belçika · 815 park alanı
  • İspanya · 731 park alanı
  • Avusturya · 677 park alanı
  • Hollanda · 633 park alanı
  • Macaristan · 572 park alanı
  • İtalya · 535 park alanı
  • Slovakya · 472 park alanı
  • Hırvatistan · 429 park alanı
  • Litvanya · 360 park alanı
  • Bulgaristan · 340 park alanı
  • Birleşik Krallık · 241 park alanı
  • Letonya · 235 park alanı
  • Sırbistan · 215 park alanı
  • Ukrayna · 200 park alanı
  • Estonya · 199 park alanı
  • Kuzey Makedonya · 135 park alanı
  • Yunanistan · 116 park alanı
  • Slovenya · 116 park alanı
  • Portekiz · 104 park alanı
  • İsveç · 84 park alanı
  • Danimarka · 83 park alanı
  • İsviçre · 79 park alanı
  • Norveç · 67 park alanı
  • Lüksemburg · 64 park alanı
  • Karadağ · 55 park alanı
  • Arnavutluk · 51 park alanı

Ayrıca 2 ülkede daha az sayıda.

Sayılar veritabanımızdan okunur ve birkaç saatte bir yenilenir.

Fiyatlandırma

Her hesap

Ücretsiz
  • Günde 10 rota çağrısı
  • Explorer dahil her hesapta ücretsiz. Kart gerekmez.
Ücretsiz API anahtarı alın

Pro

€99 / ay
  • Günde 2,000 rota çağrısı
  • Planın diğer veri API çağrılarıyla birlikte plana dahildir.
Bir plan seçin

Pro MAX

€299 / ay
  • Günde 10,000 rota çağrısı
  • Planın diğer veri API çağrılarıyla birlikte plana dahildir.
Bir plan seçin

Ek rota çağrıları

Blok başına €9 / ay
  • Günde +100 rota çağrısı
  • Filonuz daha fazlasına ihtiyaç duyduğunda ücretli bir plana blok ekleyin.

Fiyatlar KDV hariç net fiyatlardır.

Sıkça sorulan sorular

Truck Route API nedir?

Bir kamyon rota API'si: başlangıç noktasını, varış noktasını ve aracınızı gönderirsiniz; kamyona uygun bir rota, AB sürüş süresi kurallarına göre bir sürücü dinlenme planı ve yol boyunca akaryakıt istasyonları ile tır parklarını tek bir JSON yanıtında alırsınız.

Otomobil rota API'sinden farkı nedir?

Bir otomobil rotası, 4 metre yüksekliğinde ve 40 tonluk bir aracı alçak bir köprünün altına veya ağırlık kısıtlamalı bir yola gönderebilir. Bu rota ise aracınızın boyutlarına, ağırlıklarına, dingil yüküne ve tehlikeli madde sınıfına göre hesaplanır ve kamyon trafik yasaklarını dikkate alır.

Sürücü molalarını ve dinlenmelerini planlıyor mu?

Evet. EU Regulation 561/2006 kapsamında molaları, günlük ve haftalık dinlenmeleri — bölünmüş molalar, indirilmiş dinlenmeler ve iki sürücülü ekip sürüşü dahil — planlar, her durağı rota üzerindeki bir tır parkına yerleştirir ve ETA'ya dahil eder. Sürücünün mevcut sürüş sürelerini gönderin, plan sürücünün bulunduğu durumdan başlasın.

Dinlenme planı yasal bir garanti midir?

Hayır. Kuralları bizim uyguladığımız şekliyle izleyen bir planlama yardımcısıdır. Takograf kaydı veya hukuki tavsiye değildir ve uyumluluğu garanti etmez. Sorumluluk sürücüde ve işletmecide kalır; gerçek trafik, bekleme ve yükleme süreleri planı değiştirecektir.

Hangi ülkelerde akaryakıt fiyatları var?

Yalnızca bu sayfada Kapsam bölümünde listelenen ülkelerde. Bu liste canlı verilerimizden oluşturulur, dolayısıyla API'nin bugün neleri döndürebildiğini gösterir.

Bir rota hiç Rusya'dan geçer mi?

Hayır. Rotalar Rusya'dan ve Kaliningrad'dan kaçınır.

Kaç rota çağrısı ücretsiz?

Her hesap günde 10 ücretsiz rota çağrısı alır. Ücretli planlar daha fazlasını içerir ve ek rota çağrıları günde 100'lük bloklar halinde eklenebilir.

TMS veya sevkiyat yazılımımda kullanabilir miyim?

Evet. JSON döndüren basit bir HTTPS GET isteğidir; dolayısıyla REST API çağırabilen her TMS, ERP, sevkiyat veya telematik sistemi bunu kullanabilir. Dokümantasyonda tüm parametreler ve yanıt şeması listelenir.

API geçiş ücretlerini döndürüyor mu?

Evet, euro cinsinden bir tahmin olarak: ülke bazında, rotadaki ücretli kilometrelerden ve dingil sayınıza ve ağırlığınıza karşılık gelen kamyon tarifesinden, artı rotadaki ücretli tüneller ve köprüler. Tarifeler Euro VI tarifeleridir. Kayıtlı tarifesi olmayan bir ülke sıfır olarak sayılmak yerine bir kapsam notunda listelenir ve toplamın dışında bırakılır.

Tehlikeli madde (ADR) rotaları planlayabilir mi?

Yükün ADR sınıflarını ve tünel kısıtlama kodunu gönderebilirsiniz. Kategorisi bu kodu yasaklayan tünellerden, kategorinin haritada bulunduğu yerlerde kaçınılır; başka bir rota yoksa yanıt bunu belirtir. Yükünüz için geçerli ADR kurallarını kontrol etmek sizin sorumluluğunuzdadır.

İlk kamyon rotanızı planlayın

Ücretsiz bir hesap oluşturun ve anahtarınızı alın — her hesapta günde 10 rota çağrısı ücretsizdir.

Ücretsiz API anahtarı alın Dokümantasyonu okuyun