Workflow/tasks/route_dienstfahrt.md

route_dienstfahrt — Distanz/Fahrzeit über Routing

Zweck: Berechnet die schnellste Kfz-Route zwischen zwei Punkten über das hausinterne Routing und liefert Distanz und Fahrzeit als Kontextvariablen. Optional wird ein angegebener Kilometerwert gegen die berechnete Distanz plausibilisiert (z. B. Reisekostenabrechnung).

Parameter

Name	Pflicht?	Default	Beschreibung
von	ja	—	Startpunkt als Koordinatenpaar "x,y"
nach	ja	—	Zielpunkt als Koordinatenpaar "x,y"
epsg	nein	25833	Koordinatensystem; 25833 = „Ost,Nord", 4326 = „lon,lat" (WGS84)
vergleich_km	nein	—	Angegebener Kilometerwert für die Plausibilisierung
toleranz_prozent	nein	15	Toleranz für die Plausibilisierung (nur mit vergleich_km)
output_var	nein	route	Prefix der Ausgabevariablen

Eingangswerte: Platzhalter in allen Parametern, z. B. {{start_koord}} in <von>.

Ausgangswerte:

• <prefix>_km — Distanz in km (2 Nachkommastellen)
• <prefix>_min — Fahrzeit in Minuten (1 Nachkommastelle)
• <prefix>_plausibel — nur mit vergleich_km: "1" wenn innerhalb der Toleranz, sonst "0"
• <prefix>_abweichung_km — nur mit vergleich_km: Differenz (vergleich − berechnete km)

XML-Beispiel

<task type="route_dienstfahrt" id="km_check">
  <config>
    <von>{{start_koord}}</von>
    <nach>{{ziel_koord}}</nach>
    <epsg>25833</epsg>
    <vergleich_km>{{abgerechnete_km}}</vergleich_km>
    <toleranz_prozent>15</toleranz_prozent>
    <output_var>route</output_var>
  </config>
</task>

Hinweis: <von>/<nach> müssen ein Koordinatenpaar "x,y" sein; andernfalls oder bei nicht erreichbarem Routing endet der Task mit Fehler.