स्थानीय ईंधन मूल्य API Online
यूरोप के किसी भी बिंदु के लिए उपलब्ध सर्वोत्तम fuel दाम, एक तीन-स्तरीय फ़ॉलबैक सीढ़ी से हल किया जाता है ताकि जहाँ भी हमारे पास कोई डेटा हो, वहाँ कोई coordinate कभी खाली न लौटे: जब बिंदु station-level कवरेज के भीतर हो तो निकटतम स्टेशनों के पंप दाम (आज 39 देश; प्रत्येक देश की संख्या सहित सटीक सूची किसी भी खाली fuel-stations उत्तर के coverage ऑब्जेक्ट में वापस आती है, कभी यहाँ लिखी किसी सूची से नहीं), नहीं तो उस प्रशासनिक क्षेत्र का क्षेत्रीय औसत जिसमें बिंदु आता है (आज केवल यूक्रेन — UAH में UA oblast feed), नहीं तो देश का राष्ट्रीय औसत। हर उत्तर में एक `resolution` फ़ील्ड होती है जो उत्तर देने वाले स्तर का नाम बताती है — `station` (डेटा distance_km सहित स्टेशनों की सूची है, हर एक अपनी currency में), `region` (एक oblast-औसत ऑब्जेक्ट, साथ ही `region` — UA-46 जैसा एक ISO 3166-2 कोड, `region_name` और `region_center_dist_km`) या `country` (एक राष्ट्रीय-औसत ऑब्जेक्ट)। region और country स्तर एक जैसी price keys लौटाते हैं: petrol/petrol95plus/petrol92/diesel/lpg + currency + अपडेट तिथि। शाखा `resolution` के आधार पर चुनें, कभी आकार के आधार पर नहीं। यूक्रेन में कहीं भी प्रति-station दाम नहीं हैं, इसलिए UA का कोई बिंदु `region` स्तर पर उत्तर देता है जब oblast का दाम उपलब्ध हो, अन्यथा `country` पर वापस चला जाता है। जब बिंदु हर कवर किए गए देश के बाहर हो (समुद्र के बीच में, यूरोप के बाहर) तो 404। region और country स्तर एक `grades` ऑब्जेक्ट भी रखते हैं जो हर price key को उसके canonical ग्रेड से और उस नाम से जोड़ता है जो उस देश का driver पंप पर इस्तेमाल करेगा (UA `diesel` → ДП, PL `petrol` → Pb95)। बिना coordinates के सादे राष्ट्रीय औसत के लिए `fuel` product का उपयोग करें, विशुद्ध station खोज के लिए `fuel-stations` का, दाम के अनुसार क्रम के लिए `fuel-cheapest` का।
GET https://nakordoni.eu/api/v2/data/fuel-local
— कोटा श्रेणी: cheap
| पैरामीटर | विवरण |
|---|---|
lat | अक्षांश |
lon | देशांतर |
city | शहर का नाम — lat/lon का विकल्प, निर्देशांक में बदला जाता है |
country | ISO-2 देश कोड, शहर को स्पष्ट करता है |
radius_km | स्टेशन स्तर पर खोज त्रिज्या, किमी में (डिफ़ॉल्ट 25, अधिकतम 25; उपनाम: radius)। इसके भीतर कोई स्टेशन न होने पर उत्तर देश स्तर पर चला जाता है — खोज स्वयं कभी विस्तृत नहीं होती। |
fuel_type | स्टेशन स्तर पर वैकल्पिक फ़िल्टर: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng। देश स्तर पर इसे अनदेखा किया जाता है, जहाँ उस देश द्वारा रिपोर्ट किए गए सभी ग्रेड हमेशा लौटाए जाते हैं। स्थानीय पंप नाम भी स्वीकार किए जाते हैं — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — इन्हें `country` के संदर्भ में हल किया जाता है (और निर्देशांक-आधारित उत्पादों में उस देश के अनुसार जिसमें बिंदु आता है), क्योंकि एक ही शब्द हर जगह एक ही ग्रेड नहीं होता: डेनिश, फ़िनिश, फ़्रेंच, ब्रिटिश, बेल्जियन या डच पंप पर “95” का अर्थ E10 है, जबकि पोलिश या जर्मन पंप पर E5। उत्तर में `fuel_type` (मानक), `fuel_type_requested` (जैसा आपने लिखा) और `fuel_type_local` लौटाए जाते हैं। जिस नाम को हम पहचान नहीं पाते, उसे कभी किसी डिफ़ॉल्ट ग्रेड से नहीं बदला जाता — उत्तर खाली आता है और यह बात बताता है। देशवार नामों की पूरी तालिका: /api/v2/data/fuel-grades। |
limit | स्टेशन स्तर पर अधिकतम स्टेशन (डिफ़ॉल्ट 5, अधिकतम 20) |
lang | लेबल और देश के नाम की भाषा (डिफ़ॉल्ट en) |
रिस्पॉन्स फ़ील्ड — रिस्पॉन्स एनवेलप के data ऑब्जेक्ट के भीतर। [] सूची दर्शाता है, यानी data.items[].name हर एलिमेंट का name फ़ील्ड है। जिस फ़ील्ड का मान हमारे पास नहीं है वह null होता है, आता ही नहीं या खाली सूची होती है — प्लेसहोल्डर कभी नहीं।
| फ़ील्ड | विवरण |
|---|---|
data.resolution | Which tier answered: station | region | country. Branch on this, never on the shape. |
data.anchor | The point the answer was resolved for: lat, lng, ppid, radius_km and the fuel_type fields. |
data.country | ISO-2 country the point fell in; region is its ISO 3166-2 code at the region tier. |
data.data | At station tier a list of stations (see fuel-stations). At region and country tier one averages object: petrol, petrol95plus, petrol92, petrol98, diesel, lpg, lpg_eur, currency, updated, trend_petrol, trend_diesel, country_name. |
data.data.region_name | Region tier only: the region's name, with region_center_dist_km — how far its centre sits from your point. |
data.grades | Region and country tier only: each price key mapped to its canonical grade and the local pump name. |
data.labels | Localised UI strings — for rendering, not data. |
curl "https://nakordoni.eu/api/v2/data/fuel-local?lat=50.45&lon=30.52&lang=uk" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
अपडेट किया गया