Bus Sun Side API Online

Која страна аутобуса добија сунце или сенку на путовању и која седишта су најбоља за сенку или за поглед. Путовање се прелази у корацима од 5 минута: положај и смер из руте, положај сунца на том месту и у то време, затим процена за свако седиште према изабраном распореду аутобуса. Користите руту из нашег регистра лиценцираних линија (route_id), две тачке (from/to) или пошаљите сопствену руту методом POST (станице или polyline) да бисте добили и шему седишта, мапу руте и временску линију као слике. Резултати су процена на основу геометрије и положаја сунца; стварна сенка зависи и од завеса, зграда, терена и времена.

GET https://nakordoni.eu/api/v2/data/bus-sun-side — класа квоте: heavy

Поља одговора — унутар објекта data у коверти одговора. [] означава листу, па је data.items[].name поље name сваког елемента. Поље је null, недостаје или је празна листа када немамо вредност — никада не убацујемо замену.

Пробајте без кода: планер сунчане стране покреће овај API за било коју линију или ваше путовање и приказује распоред седишта, мапу, временску линију, слике и код позива. Отвори планер →

Your route (POST)

Пошаљите сопствену руту као JSON тело методом POST на исти URL. Одговор има иста поља као GET, плус input (како је рута прочитана), images (шема седишта, мапа руте и временска линија) и embed_html.

Станице без геометрије повезују се нашим друмским рутером; деоница која не може да се рутира црта се као права линија и броји у input.legs_straight. Времена: најмање две станице са временом, или route.depart са route.duration_min или route.speed_kmh. Путовање може трајати до 72 h.

Погрешно или недостајуће поље даје HTTP 400, при чему error.field садржи његову путању, на пример route.stops[2].lat или 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

Свака слика има свој URL са насумичним називом датотеке (.png, .webp или .jpg). URL-ови не захтевају кључ и важе 12 сати (expires_at); копирајте датотеке ако су вам потребне дуже. embed_html је самосталан figure са шемом седишта као уграђеним SVG-ом и редом са навођењем извора nakordoni.eu; задржите навођење извора при приказу.

Испод: слике за пример тела изнад (минибус, Познањ – Варшава, 21. јун).

Bus catalogue

bus_model прихвата једну од ових општих класа возила (не конкретне марке). Свако послато поље аутобуса замењује модел; seats се претвара у rows према layout. Иста листа је доступна као JSON преко 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

Са weather=1 (подразумевано; у телу POST захтева "weather": true) одговор користи сатну временску прогнозу дуж путовања за наредна 3 дана (72 h); каснији делови путовања користе ведро небо. summary.sun_*_min се тада пондеришу према прогнози, сваки ред у timeline добија wx {code, f, temp, precip}, а weather {used, window_h, covered_pct, sunny_min, cloudy_min, rain_min, max_temp, note_key} показује колики део путовања је покрила прогноза. recommend_clear је одговор за ведро небо; weather_changes_answer је true када прогноза мења страну сенке. Када је прогноза претежно облачна или кишна, recommend.reason_key је mostly_cloudy, а shade_side је any. recommend.tip_key hot_sun_side значи да се за сунчану страну прогнозира 28 °C или више.

Quota and accuracy

GET, као и POST са "images": [], рачунају се као 1 јединица тешке класе; POST који прави слике рачуна се као 2. bus-sun-catalog је јефтин позив. Исто POST тело враћа сачувани одговор до 6 сати (1 сат када је коришћена временска прогноза).

Резултат је процена на основу геометрије руте и положаја сунца. Завесе, затамњена стакла, зграде, дрвеће, терен и измењена рута нису нам познати. Облаци и киша потичу из временске прогнозе само за путовања у наредна 3 дана; каснија путовања претпостављају ведро небо. confidence је нижи када је сунце ниско, путовање кратко, рута често скреће или је прогноза претежно облачна.

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"