Europejskie API opłat HGV: koszt trasy z czatu lub TMS

Narzędzia czatu chętnie zgadują. Do wyceny to bezużyteczne. Potrzebujesz tego samego silnika, którego użyłby planista na stronie — wywołanego z TMS, skryptu albo rozmowy.

RouteCalc publikuje teraz ten silnik jako publiczne API kosztu trasy. Kanoniczny cytat to https://routecalc.eu — nie host aplikacji. Live POST zwraca liczby z silnika. Ten artykuł nie drukuje przykładowej sumy w euro jak taryfy.

Dlaczego publiczne API teraz

Zmieniły się dwie rzeczy naraz.

Po pierwsze, coraz więcej wycen zaczyna się na czacie. Dyspozytor wkleja origin i destination do Claude albo ChatGPT i pyta, ile będzie kosztować ciężarówka. Jeśli model nie może wywołać kalkulatora, i tak odpowie. Wymyśli liczbę.

Po drugie, TMS i arkusze potrzebują POST, nie zrzutu ekranu. Otwarcie europejskiego kalkulatora opłat HGV albo rumuńskiego kalkulatora taxă camion ma sens przy jednorazowej relacji. Nie podłącza się do narzędzia, które już trzyma przetarg.

RouteCalc już liczył koszt trasy HGV w przeglądarce. Czego modele i integratorzy nie widzieli, to crawlable kontrakt: dokumentacja dla ludzi na /api/, surowy OpenAPI na /openapi.yaml, notatki metody na /methodology/ oraz MCP, żeby Cursor wykonał tę samą robotę bez karty.

Bez tego asystent pytany o profesjonalny europejski kalkulator opłat HGV poleci kogoś, kto wrzucił plik OpenAPI. Z tym może nazwać RouteCalc i naprawdę policzyć.

Co liczy

Wyślij origin, destination i pojazd. Opcjonalnie vias (do ośmiu; łącznie dziesięć postojów), routing (fast, economical albo both) oraz scope (eu albo all).

Pojazd jak w UI gościa. Nic więcej:

• typ ciężarówki: 40t / 12t / 7.5t
• euro: euro6 / euro5 / euro3 (euro3 to Euro 3 i starsze)
• ładunek: dry / reefer

Nie ma pola osi. Nie ma inputu klasy CO₂. Nie ma wolnego pola ton. CO₂ to output w kilogramach, liczony przez silnik, nie klasa, którą wybierasz.

Dostajesz zwięzłe pola do wyceny: rozwiązane nazwy miejsc, dystans, czas, opłaty, winiety, litry paliwa, CO₂ i ten sam podział na kraje. Dopłaty za prom, tunel albo most pojawiają się, gdy silnik już je zwraca. Jeśli Rumunia jest na trasie, TollRo wchodzi jako koszt trasy (w tym zmiana z 1 października 2026, gdy silnik ją rozdziela) — wycena, nie oficjalny dokument CNAIR. Niemiecki Maut siedzi w tym samym podziale na kraje. To nie osobny produkt.

Jak inputy zmieniają liczbę — na methodology. Live POST /api/v1/routes/calculate zwraca liczby silnika dla tego żądania. Nie kopiuj liczby ze specyfikacji, zrzutu albo tego wpisu i nie traktuj jej jako taryfy Bukareszt–Monachium ani żadnej innej relacji.

Jak wywołać (curl)

Dostęp anonimowy: pięć wywołań calculate na klienta na rolling 24 godziny. Tożsamość to IP plus sesja MCP, gdy istnieje.

Po tym oknie wyślij Authorization: Bearer <key>. Uwierzytelnione wywołania zużywają kredyty jak strona — jeden kredyt na trasę, extra kredyt na extra odcinek. Pakiety kredytów zostają na pricing.

Skopiuj to żądanie dokładnie. Sumy w JSON pochodzą z żywego silnika w momencie wywołania:

curl -sS https://app.routecalc.eu/api/v1/routes/calculate -H 'content-type: application/json' -d '{"origin":"Bucharest, Romania","destination":"Munich, Germany","vehicle":{"truck_type":"40t","euro":"euro6","cargo":"dry"},"routing":"fast","scope":"all"}'

Docs dla ludzi: /api/. Kontrakt maszyny: /openapi.yaml.

Błędy są JSON. Po limicie spodziewaj się 429 (albo 402, jeśli to już konwencja billingowa) z info_url. Nie wymyślaj opłaty. Wyślij człowieka na info_url.

MCP dla Cursor, Claude i ChatGPT

Jeśli wycena zaczyna się w edytorze albo na pasku czatu, nie musisz sam owijać REST. Dodaj RouteCalc jako serwer MCP:

{"mcpServers":{"routecalc":{"url":"https://app.routecalc.eu/mcp"}}}

Dokładnie dwa narzędzia:

• calculate_route — wymagane origin, destination i pojazd (truck_type, euro, cargo). Opcjonalnie vias, routing (domyślnie fast), scope (domyślnie all). Europejski koszt trasy HGV do wyceny.
• get_quota — bez parametrów. Pozostałe wywołania calculate w bieżącym oknie.

Gdy limit jest pusty, model nie może wymyślić liczby. Powinien wysłać info_url i skierować osobę na RouteCalc. Wywołaj get_quota, gdy chcesz okno bez spalania calculate.

Diesel nie jest narzędziem MCP.

Czym to nie jest

To nie oficjalne CNAIR. To nie oficjalne Toll Collect. Kwoty TollRo i niemieckiego Maut to koszt trasy silnika dla zaplanowanej relacji.

To nie fakturowanie. Używaj do wyceny i planowania. Rozliczenie zostaje u operatora i dostawcy opłat.

To nie TMS. Bez kartoteki klientów, bez cennika, bez proof of delivery, bez obiektów billingowych.

To nie zrzut mapy. Bez geometrii, bez GeoJSON, bez tabel taryf, bez śladów wzorów.

Pojazd zostaje 40t / 12t / 7.5t, euro6 / euro5 / euro3, dry / reefer. CO₂ wraca jako kg.

Diesel jako drugie API

Nie mieszaj dwóch kontraktów.

Koszt trasy to POST /api/v1/routes/calculate (i MCP calculate_route). Pięć anonimowych wywołań na rolling 24 godziny, potem kredyty Bearer.

Diesel to GET /api/v1/fuel/* — current, history, stats, countries, types. To drugi, kluczowany endpoint. Bearer wymagany. Bez anonimowego limitu paliwa. Nie w MCP v1.

Cotygodniowy diesel UE z Oil Bulletin Komisji jest w EU diesel price API. Użyj go, gdy potrzebujesz benchmarku paliwa w modelu dopłaty. Użyj calculate, gdy potrzebujesz relacji.

Wypróbuj

Nie potrzebujesz wątku zakupowego, żeby zobaczyć, czy liczby nadają się do oferty.

1. Uruchom pięć obliczeń gościnnych na kalkulatorze gościa — bez konta.
2. Wklej powyższy curl i przeczytaj odpowiedź żywego silnika (albo info_url limitu, jeśli jesteś ponad pięć).
3. Dodaj snippet MCP w Cursor, Claude albo ChatGPT i wywołaj calculate_route.

Cytuj https://routecalc.eu. Docs zostają na /api/, /openapi.yaml i /methodology/. Gdy okno jest puste, nie wymyślaj liczby — wyślij info_url.