146adc970a
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
40 lines
1.7 KiB
Markdown
40 lines
1.7 KiB
Markdown
# `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.
|