API Bus Sun Side 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"