API Bus Sun Side Online

Quel côté d'un autocar reçoit le soleil ou l'ombre pendant un trajet, et quels sièges sont les meilleurs pour l'ombre ou pour la vue. Le trajet est parcouru par pas de 5 minutes : position et cap d'après l'itinéraire, position du soleil à cet endroit et à cette heure, puis une estimation par siège pour la disposition de bus choisie. Utilisez un itinéraire de notre registre des lignes autorisées (route_id), deux points (from/to), ou envoyez en POST votre propre itinéraire (arrêts ou polyline) pour obtenir aussi un plan des sièges, une carte du trajet et une chronologie en images. Les résultats sont une estimation à partir de la géométrie et de la position du soleil ; l'ombre réelle dépend aussi des rideaux, des bâtiments, du relief et de la météo.

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

Champs de la réponse — à l’intérieur de l’objet data de l’enveloppe. [] indique une liste : data.items[].name est donc le champ name de chaque élément. Un champ vaut null, est absent ou est une liste vide quand nous n’avons pas de valeur — jamais un espace réservé.

Essayez sans code : le planificateur du côté soleil exécute cette API sur n’importe quel itinéraire ou votre propre trajet et affiche le plan des sièges, la carte, la chronologie, les images et le code de l’appel. Ouvrir le planificateur →

Your route (POST)

Envoyez votre propre trajet sous forme de corps JSON en POST à la même URL. La réponse contient les mêmes champs que GET plus input (comment votre trajet a été lu), images (plan des sièges, carte du trajet et chronologie) et embed_html.

Les arrêts sans géométrie sont reliés par notre routeur routier ; un tronçon impossible à calculer est tracé en ligne droite et compté dans input.legs_straight. Horaires : au moins deux arrêts horodatés, ou route.depart avec route.duration_min ou route.speed_kmh. Un trajet peut durer jusqu'à 72 h.

Un champ erroné ou manquant renvoie HTTP 400 avec error.field égal à son chemin, par exemple route.stops[2].lat ou 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

Chaque image a sa propre URL avec un nom de fichier aléatoire (.png, .webp ou .jpg). Les URL ne nécessitent pas de clé et restent valides 12 heures (expires_at) ; copiez les fichiers si vous en avez besoin plus longtemps. embed_html est un figure autonome avec le plan des sièges en SVG inline et une ligne de crédit nakordoni.eu ; conservez le crédit lorsque vous l'affichez.

Ci-dessous : les images pour l'exemple de corps ci-dessus (minibus, Poznań à Varsovie, 21 juin).

Bus catalogue

bus_model accepte l'une de ces classes de véhicules génériques (pas de marques précises). Tout champ de bus envoyé remplace le modèle ; seats est converti en rows selon le layout. La même liste est disponible en JSON via 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

Avec weather=1 (par défaut ; dans un corps POST "weather": true), la réponse utilise une prévision météo horaire le long du trajet pour les 3 prochains jours (72 h) ; les parties ultérieures du trajet utilisent un ciel dégagé. summary.sun_*_min sont alors pondérés par la prévision, chaque ligne de timeline reçoit wx {code, f, temp, precip}, et weather {used, window_h, covered_pct, sunny_min, cloudy_min, rain_min, max_temp, note_key} indique quelle part du trajet la prévision a couverte. recommend_clear est la réponse par ciel dégagé ; weather_changes_answer vaut true lorsque la prévision change le côté ombragé. Lorsque la prévision est surtout nuageuse ou pluvieuse, recommend.reason_key vaut mostly_cloudy et shade_side vaut any. recommend.tip_key hot_sun_side signifie que le côté ensoleillé est prévu à 28 °C ou plus.

Quota and accuracy

GET, ainsi que POST avec "images": [], comptent pour 1 unité de la classe lourde ; un POST qui produit des images compte pour 2. bus-sun-catalog est un appel peu coûteux. Le même corps POST renvoie la réponse enregistrée pendant 6 heures au maximum (1 heure si une prévision météo a été utilisée).

Le résultat est une estimation à partir de la géométrie du trajet et de la position du soleil. Les rideaux, les vitres teintées, les bâtiments, les arbres, le relief et un trajet modifié nous sont inconnus. Les nuages et la pluie proviennent d'une prévision météo uniquement pour les trajets des 3 prochains jours ; les trajets ultérieurs supposent un ciel dégagé. confidence est plus faible lorsque le soleil est bas, que le trajet est court, que l'itinéraire tourne souvent ou que la prévision est surtout nuageuse.

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"