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"