Bus Sun Side API Online

Səfər zamanı avtobusun hansı tərəfi günəş və ya kölgə alır və kölgə və ya mənzərə üçün hansı oturacaqlar ən yaxşısıdır. Səfər 5 dəqiqəlik addımlarla keçilir: marşrutdan mövqe və istiqamət, həmin yerdə və vaxtda günəşin mövqeyi, sonra seçilmiş avtobus düzülüşü üzrə hər oturacaq üçün təxmin. Lisenziyalı reyslər reyestrimizdən marşrut (route_id), iki nöqtə (from/to) istifadə edin və ya oturacaq sxemi, marşrut xəritəsi və zaman xəttini şəkil kimi də almaq üçün öz marşrutunuzu POST ilə göndərin (dayanacaqlar və ya polyline). Nəticələr həndəsə və günəşin mövqeyinə əsaslanan təxmindir; real kölgə həm də pərdələrdən, binalardan, relyefdən və havadan asılıdır.

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

Cavab sahələri — cavab zərfindəki data obyektinin içində. [] siyahını bildirir, yəni data.items[].name hər elementin name sahəsidir. Dəyəri olmayan sahə null olur, ümumiyyətlə görünmür və ya boş siyahı qaytarır — heç vaxt doldurucu qoymuruq.

Kodsuz sınayın: günəşli tərəf planlaşdırıcısı bu API-ni istənilən marşrut və ya öz səfəriniz üçün işə salır və oturacaq sxemini, xəritəni, xronologiyanı, şəkilləri və sorğunun kodunu göstərir. Planlaşdırıcını aç →

Your route (POST)

Öz marşrutunuzu JSON gövdəsi kimi POST ilə eyni URL-ə göndərin. Cavabda GET ilə eyni sahələr, üstəlik input (marşrutun necə oxunduğu), images (oturacaq sxemi, marşrut xəritəsi və zaman xətti) və embed_html olur.

Həndəsəsiz dayanacaqlar yol marşrutlaşdırıcımızla birləşdirilir; marşrutlaşdırıla bilməyən hissə düz xətt kimi çəkilir və input.legs_straight-da sayılır. Vaxtlar: vaxtı göstərilmiş ən azı iki dayanacaq və ya route.duration_min ya da route.speed_kmh ilə route.depart. Səfər 72 h-a qədər davam edə bilər.

Səhv və ya çatışmayan sahə HTTP 400 qaytarır, error.field isə onun yolunu göstərir, məsələn route.stops[2].lat və ya 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

Hər şəklin təsadüfi fayl adı olan öz URL-i var (.png, .webp və ya .jpg). URL-lər açar tələb etmir və 12 saat etibarlıdır (expires_at); daha uzun müddət lazımdırsa, faylları kopyalayın. embed_html oturacaq sxemini daxili SVG kimi və nakordoni.eu mənbə sətrini ehtiva edən müstəqil figure-dur; göstərərkən mənbə sətrini saxlayın.

Aşağıda: yuxarıdakı nümunə gövdə üçün şəkillər (mikroavtobus, Poznan – Varşava, 21 iyun).

Bus catalogue

bus_model bu ümumi nəqliyyat siniflərindən birini qəbul edir (konkret markaları deyil). Göndərdiyiniz istənilən avtobus sahəsi modeli əvəz edir; seats layout üzrə rows-a çevrilir. Eyni siyahı bus-sun-catalog vasitəsilə JSON kimi mövcuddur.

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 ilə (standart; POST gövdəsində "weather": true) cavab növbəti 3 gün (72 h) üçün səfər boyunca saatlıq hava proqnozundan istifadə edir; səfərin sonrakı hissələri üçün açıq səma götürülür. Bu halda summary.sun_*_min proqnoza görə çəkilir, hər timeline sətri wx {code, f, temp, precip} alır, weather {used, window_h, covered_pct, sunny_min, cloudy_min, rain_min, max_temp, note_key} isə səfərin nə qədərini proqnozun əhatə etdiyini göstərir. recommend_clear açıq səma üçün cavabdır; proqnoz kölgə tərəfini dəyişəndə weather_changes_answer true olur. Proqnoz əsasən buludlu və ya yağışlı olduqda recommend.reason_key mostly_cloudy, shade_side isə any olur. recommend.tip_key hot_sun_side günəşli tərəfdə 28 °C və ya daha çox proqnozlaşdırıldığını bildirir.

Quota and accuracy

GET, həmçinin "images": [] ilə POST ağır sinfin 1 vahidi sayılır; şəkil yaradan POST 2 sayılır. bus-sun-catalog ucuz çağırışdır. Eyni POST gövdəsi saxlanmış cavabı 6 saata qədər qaytarır (hava proqnozu istifadə olunubsa, 1 saat).

Nəticə marşrut həndəsəsi və günəşin mövqeyinə əsaslanan təxmindir. Pərdələr, tündləşdirilmiş şüşələr, binalar, ağaclar, relyef və dəyişdirilmiş marşrut bizə məlum deyil. Bulud və yağış yalnız növbəti 3 gündəki səfərlər üçün hava proqnozundan gəlir; sonrakı səfərlər üçün açıq səma fərz edilir. Günəş alçaqda olduqda, səfər qısa olduqda, marşrut tez-tez döndükdə və ya proqnoz əsasən buludlu olduqda confidence daha aşağı olur.

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"