Bus Sun Side API Online

Welche Seite eines Reisebusses auf einer Fahrt Sonne oder Schatten bekommt und welche Sitze am besten für Schatten oder Aussicht sind. Die Fahrt wird in 5-Minuten-Schritten durchlaufen: Position und Fahrtrichtung aus der Route, Sonnenstand an diesem Ort zu dieser Zeit, dann eine Schätzung je Sitz für die gewählte Busanordnung. Nutzen Sie eine Route aus unserem Register lizenzierter Linien (route_id), zwei Punkte (from/to) oder senden Sie per POST Ihre eigene Route (Halte oder eine polyline), um zusätzlich einen Sitzplan, eine Routenkarte und eine Zeitleiste als Bilder zu erhalten. Die Ergebnisse sind eine Schätzung aus Geometrie und Sonnenstand; echter Schatten hängt auch von Vorhängen, Gebäuden, Gelände und Wetter ab.

GET https://nakordoni.eu/api/v2/data/bus-sun-side — Kontingentklasse: heavy

Antwortfelder — innerhalb des data-Objekts im Antwortumschlag. [] steht für eine Liste, data.items[].name ist also das Feld name jedes Elements. Ein Feld ist null, fehlt oder ist eine leere Liste, wenn wir keinen Wert dafür haben — nie ein Platzhalter.

Ohne Code ausprobieren: Der Bus-Sonnenseiten-Planer führt diese API für jede Route oder Ihre eigene Fahrt aus und zeigt Sitzplan, Karte, Zeitleiste, Bilder und den Code für den Aufruf. Planer öffnen →

Your route (POST)

Senden Sie Ihre eigene Route als JSON-Body per POST an dieselbe URL. Die Antwort hat dieselben Felder wie GET plus input (wie Ihre Route gelesen wurde), images (Sitzplan, Routenkarte und Zeitleiste) und embed_html.

Halte ohne Geometrie werden mit unserem Straßenrouter verbunden; ein Abschnitt, der nicht geroutet werden kann, wird als gerade Linie gezeichnet und in input.legs_straight gezählt. Zeiten: mindestens zwei Halte mit Zeit oder route.depart mit route.duration_min oder route.speed_kmh. Eine Fahrt kann bis zu 72 h dauern.

Ein falsches oder fehlendes Feld ergibt HTTP 400, wobei error.field seinen Pfad enthält, zum Beispiel route.stops[2].lat oder 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

Jedes Bild hat eine eigene URL mit zufälligem Dateinamen (.png, .webp oder .jpg). Die URLs brauchen keinen Schlüssel und sind 12 Stunden gültig (expires_at); kopieren Sie die Dateien, wenn Sie sie länger benötigen. embed_html ist ein eigenständiges figure mit dem Sitzplan als Inline-SVG und einer Quellenzeile nakordoni.eu; behalten Sie die Quellenangabe bei der Anzeige bei.

Unten: die Bilder für den Beispiel-Body oben (Kleinbus, Posen nach Warschau, 21. Juni).

Bus catalogue

bus_model akzeptiert eine dieser allgemeinen Fahrzeugklassen (keine konkreten Marken). Jedes gesendete Bus-Feld überschreibt das Modell; seats wird für das layout in rows umgerechnet. Dieselbe Liste ist als JSON über bus-sun-catalog verfügbar.

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

Mit weather=1 (Standard; im POST-Body "weather": true) nutzt die Antwort eine stündliche Wettervorhersage entlang der Fahrt für die nächsten 3 Tage (72 h); spätere Teile der Fahrt verwenden klaren Himmel. summary.sun_*_min werden dann nach der Vorhersage gewichtet, jede timeline-Zeile erhält wx {code, f, temp, precip}, und weather {used, window_h, covered_pct, sunny_min, cloudy_min, rain_min, max_temp, note_key} gibt an, welchen Anteil der Fahrt die Vorhersage abgedeckt hat. recommend_clear ist die Antwort für klaren Himmel; weather_changes_answer ist true, wenn die Vorhersage die Schattenseite ändert. Ist die Vorhersage überwiegend bewölkt oder regnerisch, ist recommend.reason_key mostly_cloudy und shade_side any. recommend.tip_key hot_sun_side bedeutet, dass für die Sonnenseite 28 °C oder mehr vorhergesagt sind.

Quota and accuracy

GET sowie POST mit "images": [] zählen als 1 Einheit der schweren Klasse; ein POST, der Bilder erzeugt, zählt 2. bus-sun-catalog ist ein günstiger Aufruf. Derselbe POST-Body liefert die gespeicherte Antwort bis zu 6 Stunden lang (1 Stunde, wenn eine Wettervorhersage verwendet wurde).

Das Ergebnis ist eine Schätzung aus der Routengeometrie und dem Sonnenstand. Vorhänge, getönte Scheiben, Gebäude, Bäume, Gelände und eine geänderte Route sind uns nicht bekannt. Wolken und Regen stammen nur für Fahrten in den nächsten 3 Tagen aus einer Wettervorhersage; spätere Fahrten nehmen klaren Himmel an. confidence ist niedriger, wenn die Sonne tief steht, die Fahrt kurz ist, die Route oft abbiegt oder die Vorhersage überwiegend bewölkt ist.

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"