Files
Workflow/tasks/route_dienstfahrt.md

40 lines
1.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# `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**
```xml
<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.