Integrácia TollCalc do vlastných aplikácií

TollCalc možno integrovať do vlastného softvéru alebo AI pracovných postupov tromi spôsobmi:

REST-API

Úplnú API dokumentáciu (OpenAPI 3.0) nájdete na:

tollcalc.eu/en/api.html

Rýchly štart

curl -X POST https://app.tollcalc.eu/api/calculate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer VÁŠ_API_TOKEN" \
  -d '{
    "origin": "Munich, Germany",
    "destination": "Vienna, Austria",
    "vehicle": {
      "weight": 40,
      "axles": 5,
      "emission_class": "euro6",
      "co2_class": "class_1"
    }
  }'

Parametre

Autentifikácia

API tokeny získate po registrácii na app.tollcalc.eu. Bez tokenu je možných 10 bezplatných požiadaviek na reláciu.

MCP – Integrácia do AI asistentov

TollCalc podporuje Model Context Protocol (MCP) a možno ho priamo integrovať do AI nástrojov ako Claude Desktop, Cursor alebo iných asistentov kompatibilných s MCP.

Endpoint

POST https://app.tollcalc.eu/mcp

Dostupný nástroj

Konfigurácia v Claude Desktop

Pridajte do konfigurácie Claude Desktop (claude_desktop_config.json):

Možnosť A – OAuth (odporúčané): Uveďte len URL, token nie je potrebný.

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

Možnosť B – API kľúč (pre automatizáciu): Token uložte manuálne, napr. pre server-to-server integrácie.

{
  "mcpServers": {
    "tollcalc": {
      "url": "https://app.tollcalc.eu/mcp",
      "headers": {
        "Authorization": "Bearer VÁŠ_API_TOKEN"
      }
    }
  }
}

Bez konfigurácie je k dispozícii 10 bezplatných požiadaviek na reláciu MCP (= na konverzáciu) – žiadny účet nie je potrebný. Po 10 požiadavkách otvorí Claude Desktop automaticky prihlásenie v prehliadači (OAuth 2.0). Po prihlásení platí zakúpená kvóta. API tokeny pre možnosť B získate na app.tollcalc.eu.

Príklad volania cez MCP

Po nastavení sa môžete asistenta spýtať priamo:

„Koľko stojí mýto pre 40-tonový kamión z Mníchova do Viedne?"

Asistent zavolá nástroj calculate_toll a vráti štruktúrovanú odpoveď.

Úrovne detailov

Nástroj calculate_toll podporuje tri úrovne detailov cez parameter detail:

Polia odpovede

Všetky úrovne detailov obsahujú nasledujúce polia:

S detail=detailed obsahuje countries dodatočne segments (segmenty s road, type, km, toll_eur). S detail=full pribúdajú súradnice, source_url, matched_geofence a geometria.

Server Card

Popis MCP (Server Card) je dostupný na:

GET https://app.tollcalc.eu/.well-known/mcp-server

Python balík tollcalc

Python balík tollcalc obaľuje REST-API a umožňuje použitie z Python skriptov alebo Jupyter Notebookov.

Inštalácia

pip install tollcalc

Použitie

from tollcalc import TollCalc

client = TollCalc(api_key="VÁŠ_API_TOKEN")

result = client.calculate(
    origin="Munich, Germany",
    destination="Vienna, Austria",
    weight=40,
    axles=5,
    emission_class="euro6",
    co2_class="class_1",
)

print(f"Celkové mýto: {result.total_toll_eur:.2f} EUR")
print(f"Vzdialenosť:  {result.total_distance_km:.1f} km")

for country in result.countries:
    print(f"  {country.country_name}: {country.toll_eur:.2f} EUR ({country.toll_km:.0f} mýtnych km)")

Súradnice ako vstup

result = client.calculate(
    origin="48.1374;11.5755",    # Mníchov (lat;lon)
    destination="48.2082;16.3738",  # Viedeň
    weight=40,
    axles=5,
)

Dokumentácia balíka

Úplnú dokumentáciu a ďalšie príklady nájdete na PyPI: pypi.org/project/tollcalc

Ceny a kvóty

Všetky tarify a aktuálne ceny: tollcalc.eu/de/#pricing

Pri otázkach k integrácii sa obráťte na support@tollcalc.eu.