बस सन साइड 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.duration_min या route.speed_kmh के साथ route.depart। एक यात्रा 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 को layout के अनुसार rows में बदला जाता है। यही सूची bus-sun-catalog से JSON के रूप में उपलब्ध है।

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"