Truck Toll Cost API Online
Truck toll cost for a route across Europe. Send the route line as coordinates (for example the geometry from truck-route or from your own router), or just waypoints and we route them with our truck routing. Set the vehicle (axles, gross weight, Euro emission class, CO2 emission class) and get the total in EUR or your currency, a per-country breakdown (tolled km, effective EUR per km, cost, the vehicle class priced, whether a class fallback was used, date of the tariff), motorway concession sections, tunnels and bridges with their own truck tolls (for example Calafat-Vidin) as separate items, and the tolled km in total. Per-km HGV tolls and HGV vignettes (DE, AT, PL, CZ, SK, HU, BG, RO, CH, BE, NL, DK, SE, SI and more) are priced from official tariff tables. Euro and CO2 class specific rates are used where an official tariff for that class is on file; otherwise the default class rate is used and class_fallback is true. In France and Spain, a motorway stretch between two toll stations on the route is priced from the entry/exit tariff of the motorway operator for the vehicle class (France: class 3 for 2 axles, class 4 for 3 or more axles; Spain: Pesados 1 for 2 or 3 axles, Pesados 2 for 4 or more axles) and shown as a motorway_section item; the other tolled km of the country use the per-km average. The French, Italian and Spanish tariffs do not depend on the Euro or CO2 class, so class_fallback is false there. Estimates are net of VAT.
POST https://nakordoni.eu/api/v2/data/toll-cost
— מחלקת מכסה: route
| פרמטר | תיאור |
|---|---|
coordinates | (גוף JSON, זה או waypoints) קו המסלול כ-[[lon, lat], ...] — סדר GeoJSON, נקודות במרחק של עד ~1 ק"מ זו מזו (גאומטריית מסלול מפוענחת), עד 50,000 נקודות ו-6000 ק"מ. הוא מותאם לגרף הכבישים שלנו ומתומחר כפי שנשלח. |
waypoints | (גוף JSON, זה או coordinates) 2 עד 7 נקודות כ-[lon, lat] או {lat, lon}: מוצא, עד 5 נקודות ביניים, יעד. אנו מחשבים את המסלול המהיר ביותר למשאית זו ומתמחרים אותו. איסורי תנועה מתוארכים אינם משנים מסלול זה; לתוכנית שמתחשבת בהם קראו ל-truck-route ושלחו את הגאומטריה שלו כ-coordinates. |
vehicle | (גוף JSON) {axles: 2-12 (default 5), gross_weight_t: 3.5-60 (default 40), euro: 0-6 (default 6), co2_class: 1-5 (default none)}. |
date | (גוף JSON) תאריך הנסיעה YYYY-MM-DD בטווח של שנה מהיום (ברירת מחדל היום). נעשה שימוש בתעריפים התקפים בתאריך זה; עם waypoints המסלול מחושב ליום זה. |
currency | (גוף JSON) קוד ISO 4217 עבור total (ברירת מחדל EUR), למשל PLN, CZK, HUF, RON, BGN, CHF, SEK, DKK. כל הפריטים נשארים ב-EUR. |
שדות התשובה — בתוך אובייקט data שבמעטפת התשובה. [] מסמן רשימה, ולכן data.items[].name הוא שדה name של כל פריט. שדה יהיה null, ייעדר או יחזור כרשימה ריקה כשאין לנו ערך עבורו — לעולם לא ערך ממלא מקום.
| שדה | תיאור |
|---|---|
data.total_eur | Total toll cost in EUR (net of VAT): per-country tolls plus every priced item. |
data.total | The total in currency (fx_eur_to_currency is the rate used; null for EUR). |
data.complete | false when a country or item on the line could not be priced (named in not_priced / items with cost_eur null) — then the total is a lower bound. |
data.toll_km | Tolled kilometres in total (countries plus concession sections). |
data.distance_km | Length of the priced line. |
data.by_country[] | cc, toll_km, scheme (per_km | toll_road | vignette | not_tolled), rate_eur_km (effective EUR per tolled km; null for vignettes), cost_eur, vehicle_class (tariff class priced), class_fallback (true = no tariff for the asked Euro / CO2 class, the default class rate was used), source_date (date the tariff is valid from), period (vignettes), class_note (for example: tariff not class-dependent). A country on the line with no tolled road gets cost_eur 0 and scheme not_tolled. |
data.items[] | Separately charged parts: type (concession | motorway_section | bridge | tunnel), name, cc, cost_eur, basis; concessions and motorway sections add toll_km (a motorway section is not counted again in its country row), crossings add lat / lon. motorway_section name = operator or road and the entry and exit stations. A cost_eur of 0 means no separate toll (included in the national charge). |
data.not_priced[] | Countries with tolled kilometres but no truck rate on file yet. |
data.class_fallback | true when any country used a fallback class. |
data.vehicle | The vehicle priced (defaults filled in): axles, gross_weight_t, euro, co2_class. |
data.date | Tariff date used. input is coordinates or waypoints. |
data.disclaimers[] | What the estimate covers and what it does not. |
error.code | bad_request (send exactly one of coordinates or waypoints), bad_coordinates, coordinates_too_sparse (two points more than 1.5 km apart), coordinates_not_matched, bad_waypoints (2 to 7 points), bad_vehicle, bad_date, bad_currency, payload_too_large (2 MB); with reason no_route (no truck route between the waypoints for this vehicle on this date), route_too_long (6000 km), route_refused / occupied_ua (line into Russia, Kaliningrad or the occupied territory of Ukraine). |
curl -X POST "https://nakordoni.eu/api/v2/data/toll-cost" \
-H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX" \
-H "Content-Type: application/json" \
-d '{
"waypoints": [
[
16.9252,
52.4064
],
[
14.4378,
50.0755
]
],
"vehicle": {
"axles": 5,
"gross_weight_t": 40,
"euro": 6
},
"currency": "EUR"
}'
עודכן