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"