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"