API לדלק הזול ביותר בקרבת מקום Online
תחנות הדלק הזולות ביותר סביב נקודה או עיר, מדורגות לפי מחיר עבור סוג הדלק שנבחר (במקרה של שוויון מנצחת התחנה הקרובה יותר). הכיסוי ברמת התחנה משתרע על פני 39 מדינות באירופה והוא נמדד (MEASURED), לא קבוע מראש: כל תשובה ריקה מחזירה את רשימת המדינות העדכנית עם מספר התחנות לכל מדינה באובייקט coverage, בהיקף הסוג שביקשתם, כך שכדאי לקרוא את זה ולא רשימה כלשהי הכתובה בתיאור הזה. הדירוג נעשה לכל סוג דלק בנפרד בתוך אזור חיפוש אחד, והמחירים נושאים את המטבע של כל תחנה בנפרד (PLN בפולין, EUR בשאר המקומות). כאשר אף תחנה לא תואמת, התשובה כוללת אובייקט coverage במקום רשימה ריקה שקטה: station_countries ו-station_counts הנמדדים מהאינדקס החי (בהיקף של `grade` כאשר צוין fuel_type), sparse_coverage עבור מדינות עם 25 תחנות מתומחרות או פחות, measured_at, ו-fuel_type_note שמפריד בין שתי הסיבות לכך שתשובה יכולה להיות ריקה — שם סוג שלא הצלחנו לזהות, לעומת סוג שאנחנו מזהים אך לא מתמחרים באותה מדינה.
GET https://nakordoni.eu/api/v2/data/fuel-cheapest
— מחלקת מכסה: 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.stations[] | The same station objects as fuel-stations (grades nested under prices, one entry per physical station), ranked cheapest first for the chosen grade — closest wins a tie, and a station without a quote for that grade ranks last. |
data.anchor | The point searched and the resolved grade: lat, lng, radius_km, fuel_type, fuel_type_requested, fuel_type_local, fuel_type_country. |
data.count | Stations returned; data.total_found is how many matched inside the radius before limit was applied. |
data.coverage | Only when nothing matched — grade, station_countries + station_counts measured from the live index (scoped to that grade), sparse_coverage, measured_at, and fuel_type_note for both an unplaceable grade name and a recognised grade we do not price in this country. |
curl "https://nakordoni.eu/api/v2/data/fuel-cheapest?city=Munich&country=DE&radius_km=25" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
עודכן