უახლოესი ყველაზე იაფი საწვავის API Online
ყველაზე იაფი ბენზინგასამართი სადგურები მითითებული წერტილის ან ქალაქის მიმდებარედ, არჩეული საწვავის ტიპისთვის ფასის მიხედვით დალაგებული (თანაბარი ფასის შემთხვევაში იმარჯვებს უფრო ახლოს მდებარე). სადგურის დონეზე დაფარვა მოიცავს ევროპის 39 ქვეყანას და არის გაზომილი, და არა ფიქსირებული: ყოველი ცარიელი პასუხი აბრუნებს ქვეყნების მიმდინარე სიას, თითოეული ქვეყნის სადგურების რაოდენობით, coverage ობიექტში, მოთხოვნილი მარკის ფარგლებში — ამიტომ სწორედ ეს წაიკითხეთ და არა ამ აღწერაში ჩაწერილი სია. დალაგება ხდება საწვავის თითოეული ტიპისთვის ცალკე, ერთი საძიებო არეალის ფარგლებში, ხოლო ფასები მოცემულია თითოეული სადგურის საკუთარ ვალუტაში (PLN პოლონეთში, EUR სხვაგან). როცა ვერცერთი სადგური ვერ მოიძებნება, პასუხი შეიცავს coverage ობიექტს ცარიელი სიის ნაცვლად: station_countries და station_counts, გაზომილი აქტიური ინდექსიდან (fuel_type-ის მითითების შემთხვევაში — `grade`-ის ფარგლებში), 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"
განახლდა