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, καθώς και το 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"