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-ը, ինչպես նաև "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"