URL-Struktur für Planner

Die Basis-URL für den IMPARGO Planner lautet:

https://apps.impargo.de/planner?

Nach dem Fragezeichen (?) werden die Parameter in Reihenfolge angehängt und durch ein kaufmännisches Und (&) getrennt.

Die Parameter in der URL verwenden URL-codierte Zeichen. Die folgende Tabelle zeigt die häufigsten Codierungen in Planner-URLs.

Die folgenden Parameter können per URL an den Planner übergeben werden. Alle Parameter sind optional, sofern nicht anders angegeben.

Stopps (stops[x])

Definiert die Routenstopps. Der Index x legt die Reihenfolge fest: 0 = Start, 1 = erstes Ziel usw. Es kann eine Adresse oder Koordinaten übergeben werden.

• Format: &stops[x]=[Adresse oder Koordinaten]
• Beispiel mit Adresse:

&stops[0]=Gottschedstra%C3%9Fe%2034%2C13357%2CDeutschland%2C52.551400%2C13.370670

• Beispiel mit Koordinaten:

&stops[1]=52.537565%2C13.396637

Via-Punkte (via[x])

Fügt Zwischenstopps zwischen den Stopps hinzu. Mehrere Wegpunkte pro Streckenabschnitt können durch ein Semikolon getrennt werden.

• Format: &via[x]=[Breitengrad],[Längengrad]
• Beispiel:

&via[0]=49.807393,8.70762

Abfahrtszeit (departureDate)

Definiert das Startdatum und die Uhrzeit der Route als Unix-Zeitstempel in Millisekunden.

• Format: &departureDate=[Zeitstempel in Millisekunden]
• Beispiel:

&departureDate=1737792000000

Zeitmanagement (withTimeManagement)

Aktiviert das Zeitmanagement für die Route, wenn auf true gesetzt.

• Format: &withTimeManagement=true

Zeitfenster (timeWindows[x])

Definiert ein oder zwei Zeitfenster für jeden Stopp. Der Index x entspricht dem Stopp-Index.

• Format: &timeWindows[x]=[Start 1],[Ende 1],[Start 2],[Ende 2]
• Beispiel:

&timeWindows[0]=10%3A00%2C12%3A00%2C13%3A00%2C15%3A00

Wartezeiten (waitingTimes[x])

Gibt die Wartezeit in Minuten an jedem Stopp an. Der Index x entspricht dem Stopp-Index.

• Format: &waitingTimes[x]=[Minuten]
• Beispiel:

&waitingTimes[0]=75

Lenk- Und Ruhezeiten-Empfehlungen (enableRestStopsRecommendation)

Aktiviert automatische Empfehlungen für Lenk- und Ruhezeiten, wenn auf true gesetzt.

• Format: &enableRestStopsRecommendation=true

Bereits Gefahrene Lenkzeit (minutesDrivenBeforeRouteStart)

Gibt an, wie viele Minuten der Fahrer bereits vor Beginn der geplanten Route gefahren ist. Dies wird verwendet, um die verbleibende Lenkzeit korrekt zu berechnen.

• Format: &minutesDrivenBeforeRouteStart=[Anzahl der Minuten]
• Beispiel:

&minutesDrivenBeforeRouteStart=10

Die folgenden Parameter ermöglichen die Anpassung der Routing-Strategie, der Fahrzeugbeschränkungen und der Gefahrgutklassifizierung.

Hinweis: Premium-Routing-Optionen erfordern einen Business- oder Professional-Plan mit aktiviertem HERE Maps-Routing.

Routing-Modus (routingMode)

Definiert die Optimierungsstrategie für die Routenberechnung.

• Format: &routingMode=[Wert]
• Verfügbare Werte:

• Beispiel:

&routingMode=fastest

Verkehr Berücksichtigen (considerTraffic)

Wenn auf true gesetzt, werden aktuelle Verkehrsverhältnisse in die Routenberechnung einbezogen.

• Format: &considerTraffic=true

Maximale Fahrzeughöhe (maxHeight)

Legt die maximale Fahrzeughöhe in Metern fest. Routen mit unzureichender Durchfahrtshöhe werden vermieden.

• Format: &maxHeight=[Höhe in Metern]
• Beispiel:

&maxHeight=4.5

Maximales Achsgewicht (maxAxle)

Legt das maximale Achsgewicht in Tonnen fest, um die Route auf Straßen zu beschränken, die für das Fahrzeug geeignet sind.

• Format: &maxAxle=[Gewicht in Tonnen]
• Beispiel:

&maxAxle=5

Länder Ausschließen (excludeCountries)

Definiert eine Liste von Ländern, die die Route vermeiden soll, als kommagetrennte ISO-Ländercodes.

• Format: &excludeCountries=[CC1],[CC2],...
• Beispiel:

&excludeCountries=FR,IT,ES

• Um bestehende Ausschlüsse zu löschen, einen leeren Wert übergeben:

&excludeCountries=

Transportierte Gefahrgüter (shippedHazardousGoods)

Gibt die Arten der transportierten Gefahrgüter an. Die Route wird entsprechend den geltenden Vorschriften angepasst. Mehrere Werte können als kommagetrennte Liste übergeben werden.

• Format: &shippedHazardousGoods=[Wert1],[Wert2],...
• Verfügbare Werte:

• Beispiel:

&shippedHazardousGoods=flammable,explosive

• Um die bestehende Auswahl zu löschen, einen leeren Wert übergeben:

&shippedHazardousGoods=

Die folgenden Beispiele zeigen, wie Parameter für gängige Anwendungsfälle kombiniert werden können.

Einfache Route

https://apps.impargo.de/planner?departureDate=1737792000000&enableRestStopsRecommendation=true&minutesDrivenBeforeRouteStart=10&stops[0]=Gottschedstra%C3%9Fe%2034%2C13357%2CDeutschland%2C52.551400%2C13.370670&stops[1]=52.537565%2C13.396637&timeWindows[0]=10%3A00%2C12%3A00%2C13%3A00%2C15%3A00&waitingTimes[0]=75&withTimeManagement=true

Route Mit Gefahrgütern

https://apps.impargo.de/planner?stops[0]=52.520008,13.404954&stops[1]=48.137154,11.576124&shippedHazardousGoods=flammable,explosive

Route Mit Premium-Routing-Optionen

https://apps.impargo.de/planner?stops[0]=Berlin&stops[1]=Hamburg&routingMode=fastest&considerTraffic=true&maxHeight=4.5&maxAxle=5&excludeCountries=FR,IT&shippedHazardousGoods=explosive

Route Mit Zeitfenstern Und Gefahrgütern

https://apps.impargo.de/planner?stops[0]=52.520008,13.404954&stops[1]=48.137154,11.576124&shippedHazardousGoods=corrosive&timeWindows[0]=08:00,17:00&timeWindows[1]=09:00,18:00&withTimeManagement=true