Bus Sun Side API Online

Která strana autobusu má během cesty slunce nebo stín a která sedadla jsou nejlepší pro stín nebo výhled. Cesta se prochází v 5minutových krocích: poloha a směr jízdy z trasy, poloha slunce v daném místě a čase, pak odhad pro každé sedadlo podle zvoleného rozložení autobusu. Použijte trasu z našeho registru licencovaných linek (route_id), dva body (from/to) nebo pošlete vlastní trasu přes POST (zastávky nebo polyline) a získejte také mapu sedadel, mapu trasy a časovou osu jako obrázky. Výsledky jsou odhad z geometrie a polohy slunce; skutečný stín závisí také na závěsech, budovách, terénu a počasí.

GET https://nakordoni.eu/api/v2/data/bus-sun-side — třída kvóty: heavy

Pole odpovědi — uvnitř objektu data v obálce odpovědi. [] označuje seznam, takže data.items[].name je pole name každého prvku. Pole bývá null, chybí nebo je prázdný seznam, když pro něj nemáme hodnotu — zástupný údaj nedoplňujeme.

Vyzkoušejte bez kódu: plánovač slunné strany spustí toto API na libovolné lince nebo vaší cestě a ukáže plánek sedadel, mapu, časovou osu, obrázky a kód volání. Otevřít plánovač →

Your route (POST)

Pošlete vlastní trasu jako tělo JSON metodou POST na stejnou URL. Odpověď má stejná pole jako GET a navíc input (jak byla trasa načtena), images (mapa sedadel, mapa trasy a časová osa) a embed_html.

Zastávky bez geometrie se propojí naším silničním plánovačem; úsek, který nelze naplánovat, se vykreslí jako přímka a započte do input.legs_straight. Časy: alespoň dvě zastávky s časem, nebo route.depart s route.duration_min či route.speed_kmh. Cesta může trvat až 72 h.

Chybné nebo chybějící pole vrátí HTTP 400, přičemž error.field obsahuje jeho cestu, například route.stops[2].lat nebo 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ázek má vlastní URL s náhodným názvem souboru (.png, .webp nebo .jpg). URL nevyžadují klíč a platí 12 hodin (expires_at); pokud je potřebujete déle, soubory si zkopírujte. embed_html je samostatný figure s mapou sedadel jako inline SVG a řádkem s uvedením zdroje nakordoni.eu; při zobrazení uvedení zdroje zachovejte.

Níže: obrázky pro ukázkové tělo výše (minibus, Poznaň – Varšava, 21. června).

Bus catalogue

bus_model přijímá jednu z těchto obecných tříd vozidel (ne konkrétní značky). Každé poslané pole autobusu přepíše model; seats se převede na rows podle layout. Stejný seznam je dostupný jako 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

Při weather=1 (výchozí; v těle POST "weather": true) odpověď používá hodinovou předpověď počasí podél cesty na příští 3 dny (72 h); pro pozdější části cesty se použije jasná obloha. summary.sun_*_min jsou pak vážené podle předpovědi, každý řádek 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, jakou část cesty předpověď pokryla. recommend_clear je odpověď pro jasnou oblohu; weather_changes_answer má hodnotu true, když předpověď mění stranu stínu. Když je předpověď převážně oblačná nebo deštivá, recommend.reason_key je mostly_cloudy a shade_side je any. recommend.tip_key hot_sun_side znamená, že na slunečné straně se předpovídá 28 °C nebo více.

Quota and accuracy

GET i POST s "images": [] se počítají jako 1 jednotka těžké třídy; POST, který vytváří obrázky, se počítá jako 2. bus-sun-catalog je levné volání. Stejné tělo POST vrací uloženou odpověď až 6 hodin (1 hodinu, pokud byla použita předpověď počasí).

Výsledek je odhad z geometrie trasy a polohy slunce. Závěsy, tónovaná skla, budovy, stromy, terén a změněná trasa nám nejsou známy. Mraky a déšť pocházejí z předpovědi počasí jen pro cesty v příštích 3 dnech; pro pozdější cesty se předpokládá jasná obloha. confidence je nižší, když je slunce nízko, cesta je krátká, trasa často zatáčí nebo je předpověď převážně 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"