Bus Sun Side API Online

Egy autóbusz melyik oldala kap napot vagy árnyékot az úton, és mely ülések a legjobbak árnyékhoz vagy kilátáshoz. Az utat 5 perces lépésekben járjuk végig: pozíció és haladási irány az útvonalból, a nap helyzete azon a helyen és időpontban, majd ülésenkénti becslés a választott buszelrendezésre. Használjon útvonalat engedélyezett járataink nyilvántartásából (route_id), két pontot (from/to), vagy küldje el POST-tal saját útvonalát (megállók vagy polyline), hogy ülésrendet, útvonaltérképet és idővonalat is kapjon képként. Az eredmények a geometria és a nap helyzete alapján készült becslések; a valódi árnyék a függönyöktől, épületektől, domborzattól és időjárástól is függ.

GET https://nakordoni.eu/api/v2/data/bus-sun-side — kvótaosztály: heavy

Válaszmezők — a válaszboríték data objektumán belül. A [] listát jelöl, tehát a data.items[].name az egyes elemek name mezője. Egy mező null, hiányzik vagy üres lista, ha nincs rá értékünk — helykitöltőt soha nem teszünk oda.

Próbálja ki kód nélkül: a napos oldal tervező bármely járatra vagy saját útra lefuttatja ezt az API-t, és megmutatja az ülésrendet, a térképet, az idővonalat, a képeket és a hívás kódját. Tervező megnyitása →

Your route (POST)

Küldje el saját útvonalát JSON törzsként POST kéréssel ugyanarra az URL-re. A válasz ugyanazokat a mezőket tartalmazza, mint a GET, továbbá input (hogyan lett beolvasva az útvonal), images (ülésrend, útvonaltérkép és idővonal) és embed_html.

A geometria nélküli megállókat közúti útvonaltervezőnk köti össze; a nem tervezhető szakaszt egyenes vonalként rajzoljuk, és az input.legs_straight számolja. Időpontok: legalább két időponttal megadott megálló, vagy route.depart a route.duration_min vagy route.speed_kmh mezővel. Egy út legfeljebb 72 h lehet.

Hibás vagy hiányzó mező esetén HTTP 400 a válasz, az error.field a mező útvonalát tartalmazza, például route.stops[2].lat vagy 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

Minden képnek saját URL-je van véletlenszerű fájlnévvel (.png, .webp vagy .jpg). Az URL-ekhez nem kell kulcs, és 12 óráig érvényesek (expires_at); másolja le a fájlokat, ha tovább van rájuk szüksége. Az embed_html egy önálló figure, amely az ülésrendet inline SVG-ként és egy nakordoni.eu forrássort tartalmaz; megjelenítéskor tartsa meg a forrásmegjelölést.

Lent: a fenti példa törzshöz tartozó képek (kisbusz, Poznań – Varsó, június 21.).

Bus catalogue

A bus_model ezen általános járműosztályok egyikét fogadja (nem konkrét márkákat). Bármely elküldött buszmező felülírja a modellt; a seats értékből a layout szerinti rows lesz. Ugyanez a lista JSON-ként elérhető a bus-sun-catalog végponton.

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 esetén (alapértelmezett; POST törzsben "weather": true) a válasz óránkénti időjárás-előrejelzést használ az út mentén a következő 3 napra (72 h); az út későbbi részeinél derült égbolttal számol. A summary.sun_*_min értékek ekkor az előrejelzés szerint súlyozottak, minden timeline sor kap wx {code, f, temp, precip} mezőt, a weather {used, window_h, covered_pct, sunny_min, cloudy_min, rain_min, max_temp, note_key} pedig megmutatja, az út mekkora részét fedte le az előrejelzés. A recommend_clear a derült égboltra vonatkozó válasz; a weather_changes_answer értéke true, ha az előrejelzés megváltoztatja az árnyékos oldalt. Ha az előrejelzés főleg felhős vagy esős, a recommend.reason_key értéke mostly_cloudy, a shade_side értéke any. A recommend.tip_key hot_sun_side azt jelenti, hogy a napos oldalra 28 °C vagy több várható.

Quota and accuracy

A GET, valamint a POST "images": [] beállítással 1 egységnek számít a nehéz osztályban; a képeket készítő POST 2-nek számít. A bus-sun-catalog olcsó hívás. Ugyanaz a POST törzs legfeljebb 6 óráig a tárolt választ adja vissza (1 óráig, ha időjárás-előrejelzés került felhasználásra).

Az eredmény becslés az útvonal geometriája és a nap helyzete alapján. A függönyöket, sötétített üvegeket, épületeket, fákat, domborzatot és a módosított útvonalat nem ismerjük. A felhők és az eső csak a következő 3 napban induló utaknál származnak időjárás-előrejelzésből; későbbi utaknál derült égbolttal számolunk. A confidence alacsonyabb, ha a nap alacsonyan jár, az út rövid, az útvonal gyakran fordul, vagy az előrejelzés főleg felhős.

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"