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 — орындар сызбасы кірістірілген SVG ретінде және nakordoni.eu дереккөз жолы бар дербес figure; көрсеткенде дереккөз жолын сақтаңыз.

Төменде: жоғарыдағы мысал денесі үшін суреттер (шағын автобус, Познань – Варшава, 21 маусым).

Bus catalogue

bus_model осы жалпы көлік сыныптарының бірін қабылдайды (нақты маркаларды емес). Жіберілген кез келген автобус өрісі модельді қайта анықтайды; seats layout бойынша rows-қа айналады. Сол тізім bus-sun-catalog арқылы JSON түрінде қолжетімді.

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, сондай-ақ "images": [] бар POST ауыр сыныптың 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"