ადგილობრივი საწვავის ფასების API Online
საუკეთესო ხელმისაწვდომი ფასი საწვავზე ევროპის ნებისმიერი წერტილისთვის, გამოთვლილი სამსაფეხურიანი დაცემის სისტემით ისე, რომ კოორდინატმა არასდროს დააბრუნოს ცარიელი პასუხი, თუ საერთოდ გვაქვს რაიმე მონაცემი: სვეტის ფასები უახლოესი სადგურებიდან, როცა წერტილი სადგურის დონის დაფარვის ფარგლებშია (დღეისთვის 39 ქვეყანა; ზუსტი სია, თითოეული ქვეყნის რაოდენობებით, ბრუნდება ნებისმიერი ცარიელი fuel-stations პასუხის coverage ობიექტში და არასდროს — აქ ჩაწერილი სიით), წინააღმდეგ შემთხვევაში — რეგიონული საშუალო ფასი იმ ადმინისტრაციული რეგიონისთვის, სადაც წერტილი ხვდება (დღეისთვის მხოლოდ უკრაინა — UA-ს ოლქების feed, 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"
განახლდა