API e Bus Sun Side Online

Cila anë e autobusit merr diell ose hije gjatë udhëtimit dhe cilat ndenjëse janë më të mirat për hije ose për pamje. Udhëtimi përshkohet me hapa 5-minutësh: pozicioni dhe drejtimi nga itinerari, pozicioni i diellit në atë vend dhe në atë orë, pastaj një vlerësim për çdo ndenjëse sipas renditjes së zgjedhur të autobusit. Përdorni një itinerar nga regjistri ynë i linjave të licencuara (route_id), dy pika (from/to) ose dërgoni me POST itinerarin tuaj (ndalesa ose një polyline) për të marrë gjithashtu hartën e ndenjëseve, hartën e itinerarit dhe kronologjinë si imazhe. Rezultatet janë një vlerësim nga gjeometria dhe pozicioni i diellit; hija reale varet gjithashtu nga perdet, ndërtesat, terreni dhe moti.

GET https://nakordoni.eu/api/v2/data/bus-sun-side — klasa e kuotës: heavy

Fushat e përgjigjes — brenda objektit data të zarfit të përgjigjes. [] shënon një listë, pra data.items[].name është fusha name e çdo elementi. Një fushë është null, mungon ose është listë bosh kur nuk kemi vlerë — kurrë një vendmbajtëse.

Provojeni pa kod: planifikuesi i anës me diell e ekzekuton këtë API për çdo linjë ose udhëtimin tuaj dhe tregon planin e ndenjëseve, hartën, kronologjinë, imazhet dhe kodin e thirrjes. Hap planifikuesin →

Your route (POST)

Dërgoni itinerarin tuaj si trup JSON me POST në të njëjtin URL. Përgjigjja ka të njëjtat fusha si GET plus input (si u lexua itinerari juaj), images (harta e ndenjëseve, harta e itinerarit dhe kronologjia) dhe embed_html.

Ndalesat pa gjeometri bashkohen me ruterin tonë rrugor; një segment që nuk mund të llogaritet vizatohet si vijë e drejtë dhe numërohet në input.legs_straight. Oraret: të paktën dy ndalesa me orar, ose route.depart me route.duration_min ose route.speed_kmh. Një udhëtim mund të zgjasë deri në 72 h.

Një fushë e gabuar ose që mungon jep HTTP 400 me error.field të vendosur në shtegun e saj, për shembull route.stops[2].lat ose 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

Çdo imazh ka URL-në e vet me një emër skedari të rastësishëm (.png, .webp ose .jpg). URL-të nuk kërkojnë çelës dhe mbeten të vlefshme për 12 orë (expires_at); kopjoni skedarët nëse ju duhen më gjatë. embed_html është një figure i pavarur me hartën e ndenjëseve si SVG inline dhe një rresht burimi nakordoni.eu; ruajeni burimin kur e shfaqni.

Më poshtë: imazhet për trupin shembull më sipër (minibus, Poznań – Varshavë, 21 qershor).

Bus catalogue

bus_model pranon një nga këto klasa të përgjithshme mjetesh (jo marka specifike). Çdo fushë autobusi që dërgoni mbishkruan modelin; seats shndërrohet në rows sipas layout. E njëjta listë është e disponueshme si JSON nga 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

Me weather=1 (parazgjedhje; në trupin POST "weather": true) përgjigjja përdor një parashikim moti për çdo orë përgjatë udhëtimit për 3 ditët e ardhshme (72 h); pjesët e mëvonshme të udhëtimit përdorin qiell të kthjellët. summary.sun_*_min atëherë peshohen sipas parashikimit, çdo rresht i timeline merr wx {code, f, temp, precip}, dhe weather {used, window_h, covered_pct, sunny_min, cloudy_min, rain_min, max_temp, note_key} tregon sa pjesë të udhëtimit mbuloi parashikimi. recommend_clear është përgjigjja me qiell të kthjellët; weather_changes_answer është true kur parashikimi ndryshon anën e hijes. Kur parashikimi është kryesisht me re ose shi, recommend.reason_key është mostly_cloudy dhe shade_side është any. recommend.tip_key hot_sun_side do të thotë se për anën me diell parashikohen 28 °C ose më shumë.

Quota and accuracy

GET, si dhe POST me "images": [], numërohen 1 njësi e klasës së rëndë; një POST që krijon imazhe numërohet 2. bus-sun-catalog është një thirrje e lirë. I njëjti trup POST kthen përgjigjen e ruajtur deri në 6 orë (1 orë kur është përdorur parashikim moti).

Rezultati është një vlerësim nga gjeometria e itinerarit dhe pozicioni i diellit. Perdet, xhamat e errësuar, ndërtesat, pemët, terreni dhe një itinerar i ndryshuar nuk na dihen. Retë dhe shiu vijnë nga një parashikim moti vetëm për udhëtimet në 3 ditët e ardhshme; udhëtimet e mëvonshme supozojnë qiell të kthjellët. confidence është më i ulët kur dielli është i ulët, udhëtimi është i shkurtër, itinerari kthehet shpesh ose parashikimi është kryesisht me re.

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"