Bus Sun Side API Online

Safar davomida avtobusning qaysi tomoni quyosh yoki soya oladi va soya yoki manzara uchun qaysi o'rindiqlar eng yaxshi. Safar 5 daqiqalik qadamlar bilan o'tiladi: marshrutdan joylashuv va yo'nalish, o'sha joy va vaqtdagi quyosh holati, so'ng tanlangan avtobus joylashuvi bo'yicha har bir o'rindiq uchun baho. Litsenziyalangan reyslar reyestrimizdagi marshrutdan (route_id), ikki nuqtadan (from/to) foydalaning yoki o'rindiqlar sxemasi, marshrut xaritasi va vaqt shkalasini rasm sifatida ham olish uchun o'z marshrutingizni POST orqali yuboring (bekatlar yoki polyline). Natijalar geometriya va quyosh holatiga asoslangan baho; haqiqiy soya pardalar, binolar, relyef va ob-havoga ham bog'liq.

GET https://nakordoni.eu/api/v2/data/bus-sun-side — kvota sinfi: heavy

Javob maydonlari — javob konvertidagi data obyekti ichida. [] ro‘yxatni bildiradi, ya’ni data.items[].name har bir elementning name maydonidir. Qiymatimiz bo‘lmagan maydon null bo‘ladi, umuman bo‘lmaydi yoki bo‘sh ro‘yxat qaytadi — o‘rniga hech qachon soxta qiymat qo‘ymaymiz.

Kodsiz sinab ko‘ring: quyoshli tomon rejalashtirgichi bu API’ni istalgan yo‘nalish yoki o‘z safaringiz uchun ishga tushiradi va o‘rindiqlar sxemasi, xarita, vaqt chizig‘i, rasmlar hamda so‘rov kodini ko‘rsatadi. Rejalashtirgichni ochish →

Your route (POST)

O'z marshrutingizni JSON tanasi sifatida POST orqali xuddi shu URL'ga yuboring. Javobda GET bilan bir xil maydonlar, shuningdek input (marshrut qanday o'qilgani), images (o'rindiqlar sxemasi, marshrut xaritasi va vaqt shkalasi) va embed_html bo'ladi.

Geometriyasiz bekatlar bizning yo'l marshrutizatorimiz bilan ulanadi; marshrut qurib bo'lmaydigan qism to'g'ri chiziq sifatida chiziladi va input.legs_straight da hisoblanadi. Vaqtlar: vaqti ko'rsatilgan kamida ikkita bekat yoki route.depart bilan route.duration_min yoki route.speed_kmh. Safar 72 h gacha davom etishi mumkin.

Noto'g'ri yoki yetishmayotgan maydon HTTP 400 qaytaradi, error.field esa uning yo'lini o'z ichiga oladi, masalan route.stops[2].lat yoki 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

Har bir rasmning tasodifiy fayl nomli o'z URL'i bor (.png, .webp yoki .jpg). URL'lar kalit talab qilmaydi va 12 soat amal qiladi (expires_at); uzoqroq kerak bo'lsa, fayllarni nusxalab oling. embed_html — o'rindiqlar sxemasi ichki SVG ko'rinishida va nakordoni.eu manba qatori bilan mustaqil figure; ko'rsatishda manba qatorini saqlang.

Quyida: yuqoridagi namunaviy tana uchun rasmlar (mikroavtobus, Poznan – Varshava, 21-iyun).

Bus catalogue

bus_model ushbu umumiy transport sinflaridan birini qabul qiladi (aniq markalarni emas). Yuborilgan har qanday avtobus maydoni modelni almashtiradi; seats layout bo'yicha rows ga aylantiriladi. Xuddi shu ro'yxat bus-sun-catalog orqali JSON sifatida mavjud.

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 bilan (standart; POST tanasida "weather": true) javob keyingi 3 kun (72 h) uchun safar bo'ylab soatlik ob-havo prognozidan foydalanadi; safarning keyingi qismlarida ochiq osmon olinadi. Bunda summary.sun_*_min prognoz bo'yicha tortiladi, har bir timeline qatori wx {code, f, temp, precip} oladi, weather {used, window_h, covered_pct, sunny_min, cloudy_min, rain_min, max_temp, note_key} esa safarning qancha qismini prognoz qamraganini ko'rsatadi. recommend_clear — ochiq osmon uchun javob; prognoz soya tomonini o'zgartirsa, weather_changes_answer true bo'ladi. Prognoz asosan bulutli yoki yomg'irli bo'lsa, recommend.reason_key mostly_cloudy, shade_side esa any bo'ladi. recommend.tip_key hot_sun_side quyoshli tomonda 28 °C yoki undan yuqori kutilayotganini bildiradi.

Quota and accuracy

GET, shuningdek "images": [] bilan POST og'ir sinfning 1 birligi hisoblanadi; rasm yaratuvchi POST 2 hisoblanadi. bus-sun-catalog — arzon chaqiruv. Xuddi shu POST tanasi saqlangan javobni 6 soatgacha qaytaradi (ob-havo prognozi ishlatilgan bo'lsa, 1 soat).

Natija marshrut geometriyasi va quyosh holatiga asoslangan baho. Pardalar, tonlangan oynalar, binolar, daraxtlar, relyef va o'zgargan marshrut bizga noma'lum. Bulut va yomg'ir faqat keyingi 3 kundagi safarlar uchun ob-havo prognozidan olinadi; keyingi safarlar uchun ochiq osmon taxmin qilinadi. Quyosh past bo'lsa, safar qisqa bo'lsa, marshrut tez-tez burilsa yoki prognoz asosan bulutli bo'lsa, confidence pastroq bo'ladi.

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"