API Bus Sun Side Online

Która strona autokaru ma słońce, a która cień w trakcie podróży i które miejsca są najlepsze dla cienia lub widoku. Podróż jest analizowana w krokach co 5 minut: pozycja i kierunek z trasy, położenie słońca w tym miejscu i czasie, a następnie szacunek dla każdego miejsca według wybranego układu autobusu. Użyj trasy z naszego rejestru licencjonowanych tras (route_id), dwóch punktów (from/to) lub wyślij własną trasę przez POST (przystanki lub polyline), aby otrzymać także mapę miejsc, mapę trasy i oś czasu jako obrazy. Wyniki to szacunek na podstawie geometrii i położenia słońca; rzeczywisty cień zależy też od zasłon, budynków, ukształtowania terenu i pogody.

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

Pola odpowiedzi — wewnątrz obiektu data w kopercie odpowiedzi. [] oznacza listę, więc data.items[].name to pole name każdego elementu. Pole bywa null, nieobecne lub jest pustą listą, gdy nie mamy wartości — nigdy nie wstawiamy atrapy.

Wypróbuj bez kodu: planer strony słonecznej w autobusie uruchamia to API dla dowolnej trasy lub Twojej własnej podróży i pokazuje plan miejsc, mapę, oś czasu, obrazy oraz kod wywołania. Otwórz planer →

Your route (POST)

Wyślij własną trasę jako treść JSON metodą POST na ten sam URL. Odpowiedź ma te same pola co GET oraz input (jak odczytano trasę), images (mapa miejsc, mapa trasy i oś czasu) i embed_html.

Przystanki bez geometrii są łączone naszym routerem drogowym; odcinek, którego nie da się wyznaczyć, jest rysowany jako linia prosta i liczony w input.legs_straight. Czasy: co najmniej dwa przystanki z godziną albo route.depart z route.duration_min lub route.speed_kmh. Podróż może trwać do 72 h.

Błędne lub brakujące pole daje HTTP 400 z error.field ustawionym na jego ścieżkę, na przykład route.stops[2].lat lub 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żdy obraz ma własny URL z losową nazwą pliku (.png, .webp lub .jpg). URL nie wymagają klucza i są ważne 12 godzin (expires_at); skopiuj pliki, jeśli potrzebujesz ich dłużej. embed_html to samodzielny figure z mapą miejsc jako inline SVG i linią z podaniem źródła nakordoni.eu; zachowaj podanie źródła przy wyświetlaniu.

Poniżej: obrazy dla przykładowej treści żądania powyżej (minibus, Poznań – Warszawa, 21 czerwca).

Bus catalogue

bus_model przyjmuje jedną z tych ogólnych klas pojazdów (nie konkretne marki). Każde wysłane pole autobusu nadpisuje model; seats jest przeliczane na rows według layout. Ta sama lista jest dostępna 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

Przy weather=1 (domyślnie; w treści POST "weather": true) odpowiedź korzysta z godzinowej prognozy pogody wzdłuż trasy na najbliższe 3 dni (72 h); dla późniejszych części podróży przyjmowane jest bezchmurne niebo. summary.sun_*_min są wtedy ważone prognozą, każdy wiersz timeline dostaje wx {code, f, temp, precip}, a weather {used, window_h, covered_pct, sunny_min, cloudy_min, rain_min, max_temp, note_key} pokazuje, jaką część podróży objęła prognoza. recommend_clear to odpowiedź dla bezchmurnego nieba; weather_changes_answer ma wartość true, gdy prognoza zmienia stronę cienia. Gdy prognoza to głównie chmury lub deszcz, recommend.reason_key ma wartość mostly_cloudy, a shade_side — any. recommend.tip_key hot_sun_side oznacza, że po słonecznej stronie prognozowane jest 28 °C lub więcej.

Quota and accuracy

GET oraz POST z "images": [] liczą się jako 1 jednostka klasy ciężkiej; POST tworzący obrazy liczy się jako 2. bus-sun-catalog to tanie wywołanie. Ta sama treść POST zwraca zapisaną odpowiedź do 6 godzin (1 godzina, gdy użyto prognozy pogody).

Wynik to szacunek na podstawie geometrii trasy i położenia słońca. Zasłony, przyciemniane szyby, budynki, drzewa, ukształtowanie terenu i zmieniona trasa nie są nam znane. Chmury i deszcz pochodzą z prognozy pogody tylko dla podróży w najbliższych 3 dniach; dla późniejszych podróży przyjmowane jest bezchmurne niebo. confidence jest niższe, gdy słońce jest nisko, podróż jest krótka, trasa często skręca lub prognoza jest głównie pochmurna.

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"