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.
|