This article explains how the IMPARGO Planner URL is built and what each parameter means. It is for developers and dispatchers who want to pre-fill the Planner with route data from other systems.
Table of Content
IMPARGO Knowledge Center
Unleash the full potential of our software with our comprehensive Knowledge Center, offering detailed information on its functionality and features.
This article explains how the IMPARGO Planner URL is built and what each parameter means. It is for developers and dispatchers who want to pre-fill the Planner with route data from other systems.
The base URL for the IMPARGO Planner is:
https://apps.impargo.de/planner?After the question mark (?), add the parameters one after another, separated by an ampersand (&).
Parameters in the URL use URL-encoded characters. The table below shows the most common encodings in Planner URLs.
You can pass these parameters to the Planner in the URL. All parameters are optional unless stated otherwise.
stops[x])Sets the stops of the route. The index x sets the sequence: 0 = start, 1 = first destination, and so on. You can pass either an address or coordinates.
&stops[x]=[Address or Coordinates]
&stops[0]=Gottschedstra%C3%9Fe%2034%2C13357%2CDeutschland%2C52.551400%2C13.370670
&stops[1]=52.537565%2C13.396637via[x])Adds waypoints between two stops. To add more than one waypoint on a leg, separate them with a semicolon.
&via[x]=[Latitude],[Longitude]
&via[0]=49.807393,8.70762departureDate)Sets the start date and time of the route, as a Unix timestamp in milliseconds.
&departureDate=[Timestamp in milliseconds]
&departureDate=1737792000000withTimeManagement)Turns on time management for the route when set to true.
&withTimeManagement=true
timeWindows[x])Sets one or two time windows for each stop. The index x is the stop index.
&timeWindows[x]=[Start 1],[End 1],[Start 2],[End 2]
&timeWindows[0]=10%3A00%2C12%3A00%2C13%3A00%2C15%3A00waitingTimes[x])Sets the waiting time in minutes at each stop. The index x is the stop index.
&waitingTimes[x]=[Minutes]
&waitingTimes[0]=75enableRestStopsRecommendation)Turns on automatic recommendations for driving and rest times when set to true.
&enableRestStopsRecommendation=true
minutesDrivenBeforeRouteStart)Sets how many minutes the driver has already driven before the planned route starts. The Planner uses this to calculate the remaining driving time correctly.
&minutesDrivenBeforeRouteStart=[Number of Minutes]
&minutesDrivenBeforeRouteStart=10
With these parameters you set the routing strategy, vehicle limits and hazardous goods classification.
Note: Premium routing options require a Business or Professional plan with HERE Maps routing enabled.
routingMode)Sets how the route is optimized.
&routingMode=[Value]
&routingMode=fastestconsiderTraffic)When set to true, the route calculation takes current traffic into account.
&considerTraffic=true
maxHeight)Sets the maximum vehicle height in meters. The route avoids places where the clearance is too low.
&maxHeight=[Height in meters]
&maxHeight=4.5maxAxle)Sets the maximum axle weight in tons. The route then uses only roads that allow the vehicle's load.
&maxAxle=[Weight in tons]
&maxAxle=5excludeCountries)Lists the countries the route should avoid, as comma-separated ISO country codes.
&excludeCountries=[CC1],[CC2],...
&excludeCountries=FR,IT,ES
&excludeCountries=
shippedHazardousGoods)Sets the types of hazardous goods on board. The route is adjusted to follow the rules that apply. To pass more than one value, separate them with commas.
&shippedHazardousGoods=[value1],[value2],...
&shippedHazardousGoods=flammable,explosive
&shippedHazardousGoods=
The examples below show how to combine parameters for common cases.
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
https://apps.impargo.de/planner?stops[0]=52.520008,13.404954&stops[1]=48.137154,11.576124&shippedHazardousGoods=flammable,explosive
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
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© IMPARGO 2026, All rights reserved.