API למחירי דלק מקומיים Online
מחיר הדלק הטוב ביותר הזמין לכל נקודה שהיא באירופה, נפתר במורד סולם נסיגה בן שלוש רמות כך שקואורדינטה לעולם לא תחזור ריקה במקום שיש לנו בו נתונים כלשהם: מחירי משאבה מהתחנות הקרובות ביותר כאשר הנקודה נמצאת בתוך הכיסוי ברמת התחנה (39 מדינות כיום; הרשימה המדויקת עם המספרים לכל מדינה חוזרת באובייקט coverage של כל תשובת fuel-stations ריקה, ולעולם לא מרשימה כתובה כאן), אחרת — הממוצע האזורי של האזור המנהלי שבו נופלת הנקודה (כיום רק אוקראינה — feed המחוזות (oblast) של UA, ב-UAH), אחרת — הממוצע הארצי של המדינה. כל תשובה נושאת שדה `resolution` שנוקב ברמה שענתה — `station` (הנתונים הם רשימת תחנות עם distance_km, כל אחת במטבע שלה), `region` (אובייקט ממוצע-מחוז אחד, בתוספת `region` — קוד ISO 3166-2 כגון UA-46, `region_name` ו-`region_center_dist_km`) או `country` (אובייקט ממוצע-ארצי אחד). רמות region ו-country מחזירות את אותם מפתחות מחיר: petrol/petrol95plus/petrol92/diesel/lpg + currency + תאריך עדכון. יש להסתעף לפי `resolution`, לעולם לא לפי הצורה. לאוקראינה אין בשום מקום מחירים לפי תחנה, כך שנקודה ב-UA נענית ברמת `region` כאשר יש מחיר למחוז, ואחרת נופלת לרמת `country`. 404 כאשר הנקודה מחוץ לכל מדינה מכוסה (באמצע האוקיינוס, מחוץ לאירופה). רמות region ו-country נושאות גם אובייקט `grades` שממפה כל מפתח מחיר לסוג הקנוני שלו ולשם שנהג באותה מדינה היה משתמש בו במשאבה (UA `diesel` → ДП, PL `petrol` → Pb95). לממוצע ארצי פשוט ללא קואורדינטות יש להשתמש במוצר `fuel`, לחיפוש תחנות טהור ב-`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"
עודכן