Bus Sun Side API Online

Ktorá strana autobusu má počas cesty slnko alebo tieň a ktoré sedadlá sú najlepšie pre tieň alebo výhľad. Cesta sa prechádza v 5-minútových krokoch: poloha a smer jazdy z trasy, poloha slnka na danom mieste a v danom čase, potom odhad pre každé sedadlo podľa zvoleného rozloženia autobusu. Použite trasu z nášho registra licencovaných liniek (route_id), dva body (from/to) alebo pošlite vlastnú trasu cez POST (zastávky alebo polyline) a získajte aj mapu sedadiel, mapu trasy a časovú os ako obrázky. Výsledky sú odhad z geometrie a polohy slnka; skutočný tieň závisí aj od záclon, budov, terénu a počasia.

GET https://nakordoni.eu/api/v2/data/bus-sun-side — trieda kvóty: heavy

Polia odpovede — vnútri objektu data v obálke odpovede. [] označuje zoznam, takže data.items[].name je pole name každého prvku. Pole býva null, chýba alebo je prázdny zoznam, keď preň nemáme hodnotu — zástupný údaj nedopĺňame.

Vyskúšajte bez kódu: plánovač slnečnej strany spustí toto API na ľubovoľnej linke alebo vašej ceste a ukáže plán sedadiel, mapu, časovú os, obrázky a kód volania. Otvoriť plánovač →

Your route (POST)

Pošlite vlastnú trasu ako telo JSON metódou POST na rovnakú URL. Odpoveď má rovnaké polia ako GET a navyše input (ako bola trasa načítaná), images (mapa sedadiel, mapa trasy a časová os) a embed_html.

Zastávky bez geometrie sa spoja naším cestným plánovačom; úsek, ktorý sa nedá naplánovať, sa nakreslí ako priamka a započíta do input.legs_straight. Časy: aspoň dve zastávky s časom alebo route.depart s route.duration_min či route.speed_kmh. Cesta môže trvať až 72 h.

Nesprávne alebo chýbajúce pole vráti HTTP 400, pričom error.field obsahuje jeho cestu, napríklad route.stops[2].lat alebo 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

Každý obrázok má vlastnú URL s náhodným názvom súboru (.png, .webp alebo .jpg). URL nevyžadujú kľúč a sú platné 12 hodín (expires_at); ak ich potrebujete dlhšie, súbory si skopírujte. embed_html je samostatný figure s mapou sedadiel ako inline SVG a riadkom s uvedením zdroja nakordoni.eu; pri zobrazení uvedenie zdroja ponechajte.

Nižšie: obrázky pre ukážkové telo vyššie (minibus, Poznaň – Varšava, 21. júna).

Bus catalogue

bus_model prijíma jednu z týchto všeobecných tried vozidiel (nie konkrétne značky). Každé poslané pole autobusu prepíše model; seats sa prepočíta na rows podľa layout. Rovnaký zoznam je dostupný ako JSON z bus-sun-catalog.

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

Pri weather=1 (predvolené; v tele POST "weather": true) odpoveď používa hodinovú predpoveď počasia pozdĺž cesty na najbližšie 3 dni (72 h); pre neskoršie časti cesty sa použije jasná obloha. summary.sun_*_min sú potom vážené podľa predpovede, každý riadok timeline dostane wx {code, f, temp, precip} a weather {used, window_h, covered_pct, sunny_min, cloudy_min, rain_min, max_temp, note_key} ukazuje, akú časť cesty predpoveď pokryla. recommend_clear je odpoveď pre jasnú oblohu; weather_changes_answer má hodnotu true, keď predpoveď mení stranu tieňa. Keď je predpoveď prevažne oblačná alebo daždivá, recommend.reason_key je mostly_cloudy a shade_side je any. recommend.tip_key hot_sun_side znamená, že na slnečnej strane sa predpovedá 28 °C alebo viac.

Quota and accuracy

GET aj POST s "images": [] sa počítajú ako 1 jednotka ťažkej triedy; POST, ktorý vytvára obrázky, sa počíta ako 2. bus-sun-catalog je lacné volanie. Rovnaké telo POST vracia uloženú odpoveď až 6 hodín (1 hodinu, ak sa použila predpoveď počasia).

Výsledok je odhad z geometrie trasy a polohy slnka. Záclony, tónované sklá, budovy, stromy, terén a zmenená trasa nám nie sú známe. Oblaky a dážď pochádzajú z predpovede počasia iba pre cesty v najbližších 3 dňoch; pre neskoršie cesty sa predpokladá jasná obloha. confidence je nižšia, keď je slnko nízko, cesta je krátka, trasa často odbočuje alebo je predpoveď prevažne oblačná.

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"