Bus Sun Side API Online

Bir yolculukta otobüsün hangi tarafının güneş ya da gölge aldığı ve gölge veya manzara için en iyi koltukların hangileri olduğu. Yolculuk 5 dakikalık adımlarla izlenir: güzergâhtan konum ve yön, o yerde ve saatte güneşin konumu, ardından seçilen otobüs düzeni için koltuk başına bir tahmin. Lisanslı hat kaydımızdaki bir güzergâhı (route_id), iki noktayı (from/to) kullanın ya da koltuk planı, güzergâh haritası ve zaman çizelgesini görsel olarak da almak için kendi güzergâhınızı POST ile gönderin (duraklar veya polyline). Sonuçlar geometri ve güneşin konumuna dayalı bir tahmindir; gerçek gölge perdelere, binalara, araziye ve havaya da bağlıdır.

GET https://nakordoni.eu/api/v2/data/bus-sun-side — kota sınıfı: heavy

Yanıt alanları — yanıt zarfındaki data nesnesinin içinde. [] bir listeyi gösterir; yani data.items[].name her öğenin name alanıdır. Değerimiz olmayan bir alan null olur, hiç bulunmaz ya da boş liste döner — asla yer tutucu koymayız.

Kod yazmadan deneyin: güneşli taraf planlayıcısı bu API’yi herhangi bir hatta veya kendi yolculuğunuzda çalıştırır; koltuk planı, harita, zaman çizelgesi, görseller ve çağrı kodunu gösterir. Planlayıcıyı aç →

Your route (POST)

Kendi güzergâhınızı JSON gövdesi olarak POST ile aynı URL'ye gönderin. Yanıt, GET ile aynı alanlara ek olarak input (güzergâhınızın nasıl okunduğu), images (koltuk planı, güzergâh haritası ve zaman çizelgesi) ve embed_html içerir.

Geometrisi olmayan duraklar karayolu yönlendiricimizle birleştirilir; yönlendirilemeyen bir kesim düz çizgi olarak çizilir ve input.legs_straight içinde sayılır. Saatler: saati olan en az iki durak ya da route.duration_min veya route.speed_kmh ile birlikte route.depart. Bir yolculuk en fazla 72 h sürebilir.

Hatalı veya eksik bir alan HTTP 400 döndürür ve error.field alanın yolunu içerir, örneğin route.stops[2].lat veya bus.seats.

curl -X POST "https://nakordoni.eu/api/v2/data/bus-sun-side" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "route": {
        "stops": [
            {
                "name": "Poznań Dworzec Autobusowy",
                "lat": 52.4011,
                "lon": 16.911,
                "dep": "08:00"
            },
            {
                "name": "Konin",
                "lat": 52.223,
                "lon": 18.2511,
                "arr": "09:20",
                "dep": "09:25"
            },
            {
                "name": "Łódź Kaliska",
                "lat": 51.7573,
                "lon": 19.4306,
                "arr": "10:55",
                "dep": "11:05"
            },
            {
                "name": "Warszawa Zachodnia",
                "lat": 52.219,
                "lon": 20.965,
                "arr": "13:10"
            }
        ],
        "date": "2026-06-21",
        "timezone": "Europe/Warsaw"
    },
    "bus": {
        "bus_model": "minibus"
    },
    "images": [
        "seat_map",
        "route_map",
        "timeline"
    ],
    "format": "png",
    "theme": "light",
    "lang": "en",
    "weather": true
}'

const res = await fetch('https://nakordoni.eu/api/v2/data/bus-sun-side', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer NKD-DEV-XXXX-XXXX-XXXX', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    route: { stops: [
      { name: 'Poznań', lat: 52.4011, lon: 16.911, dep: '08:00' },
      { name: 'Warszawa', lat: 52.219, lon: 20.965, arr: '11:30' } ],
      date: '2026-06-21', timezone: 'Europe/Warsaw' },
    bus: { bus_model: 'comfort_coach_2_1' },
    images: ['seat_map'], format: 'svg', lang: 'pl'
  })
});
const { data } = await res.json();
console.log(data.recommend.shade_side, data.recommend.best_shade_seats);
document.querySelector('#seats').innerHTML = data.embed_html;   // or <img src="data.images.seat_map.url">

Images and embed_html

Her görselin rastgele dosya adına sahip kendi URL'si vardır (.png, .webp veya .jpg). URL'ler anahtar gerektirmez ve 12 saat geçerlidir (expires_at); daha uzun süre gerekiyorsa dosyaları kopyalayın. embed_html, koltuk planını satır içi SVG olarak ve bir nakordoni.eu kaynak satırını içeren bağımsız bir figure öğesidir; gösterirken kaynak satırını koruyun.

Aşağıda: yukarıdaki örnek gövde için görseller (minibüs, Poznań – Varşova, 21 Haziran).

Bus catalogue

bus_model bu genel araç sınıflarından birini alır (belirli markaları değil). Gönderdiğiniz her otobüs alanı modeli geçersiz kılar; seats, layout için rows değerine dönüştürülür. Aynı liste bus-sun-catalog üzerinden JSON olarak da mevcuttur.

Allowed values: layout 2+2 | 2+1 | 1+2 · rows {"min":4,"max":20,"custom_min":8} · door_side right | left · windshield large | normal · rear_window none | small | large · window_height standard | panoramic · deck single | upper | lower · mid_door true | false

Weather

weather=1 ile (varsayılan; POST gövdesinde "weather": true) yanıt, önümüzdeki 3 gün (72 h) için yolculuk boyunca saatlik hava tahminini kullanır; yolculuğun sonraki kısımlarında açık gökyüzü kullanılır. Bu durumda summary.sun_*_min tahmine göre ağırlıklandırılır, her timeline satırı wx {code, f, temp, precip} alır ve weather {used, window_h, covered_pct, sunny_min, cloudy_min, rain_min, max_temp, note_key} yolculuğun ne kadarının tahminle kapsandığını gösterir. recommend_clear açık gökyüzü yanıtıdır; tahmin gölge tarafını değiştirdiğinde weather_changes_answer true olur. Tahmin çoğunlukla bulutlu veya yağmurlu olduğunda recommend.reason_key mostly_cloudy, shade_side ise any olur. recommend.tip_key hot_sun_side, güneşli tarafta 28 °C veya üzeri beklendiği anlamına gelir.

Quota and accuracy

GET ve "images": [] içeren POST, ağır sınıftan 1 birim sayılır; görsel üreten bir POST 2 sayılır. bus-sun-catalog ucuz bir çağrıdır. Aynı POST gövdesi, saklanan yanıtı 6 saate kadar döndürür (hava tahmini kullanıldıysa 1 saat).

Sonuç, güzergâh geometrisi ve güneşin konumuna dayalı bir tahmindir. Perdeler, renkli camlar, binalar, ağaçlar, arazi ve değişen bir güzergâh tarafımızdan bilinmez. Bulut ve yağmur yalnızca önümüzdeki 3 gün içindeki yolculuklar için hava tahmininden gelir; sonraki yolculuklarda açık gökyüzü varsayılır. Güneş alçakta olduğunda, yolculuk kısa olduğunda, güzergâh sık döndüğünde veya tahmin çoğunlukla bulutlu olduğunda confidence daha düşüktür.

curl "https://nakordoni.eu/api/v2/data/bus-sun-side?route_id=521&dir=direct&date=2026-06-21&bus_model=standard_coach&lang=en" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"