Planner URL Structure

The base URL for the IMPARGO Planner is:

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

After the question mark (?), parameters are appended in sequence and separated by an ampersand (&).

Parameters in the URL use URL-encoded characters. The table below shows the most common encodings used in planner URLs.

The following parameters can be passed to the planner via URL. All parameters are optional unless stated otherwise.

Stops (stops[x])

Defines the route stops. The index x sets the sequence: 0 = start, 1 = first destination, and so on. You can pass either an address or coordinates.

• Format: &stops[x]=[Address or Coordinates]
• Example with address:

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

• Example with coordinates:

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

Via Points (via[x])

Adds intermediate waypoints between stops. Multiple waypoints per leg can be separated by a semicolon.

• Format: &via[x]=[Latitude],[Longitude]
• Example:

&via[0]=49.807393,8.70762

Departure Time (departureDate)

Defines the start date and time of the route as a Unix timestamp in milliseconds.

• Format: &departureDate=[Timestamp in milliseconds]
• Example:

&departureDate=1737792000000

Time Management (withTimeManagement)

Activates time management for the route when set to true.

• Format: &withTimeManagement=true

Time Windows (timeWindows[x])

Defines one or two time windows for each stop. The index x corresponds to the stop index.

• Format: &timeWindows[x]=[Start 1],[End 1],[Start 2],[End 2]
• Example:

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

Waiting Times (waitingTimes[x])

Sets the waiting time in minutes at each stop. The index x corresponds to the stop index.

• Format: &waitingTimes[x]=[Minutes]
• Example:

&waitingTimes[0]=75

Rest Stop Recommendations (enableRestStopsRecommendation)

Activates automatic recommendations for driving and rest times when set to true.

• Format: &enableRestStopsRecommendation=true

Minutes Driven Before Route Start (minutesDrivenBeforeRouteStart)

Specifies how many minutes the driver has already driven before starting the planned route. This is used to calculate remaining driving time correctly.

• Format: &minutesDrivenBeforeRouteStart=[Number of Minutes]
• Example:

&minutesDrivenBeforeRouteStart=10

The following parameters allow you to customize the routing strategy, vehicle constraints, and hazardous goods classification.

Note: Premium routing options require a Business or Professional plan with HERE Maps routing enabled.

Routing Mode (routingMode)

Defines the optimization strategy used to calculate the route.

• Format: &routingMode=[Value]
• Available values:

• Example:

&routingMode=fastest

Consider Traffic (considerTraffic)

When set to true, current traffic conditions are factored into route calculation.

• Format: &considerTraffic=true

Maximum Vehicle Height (maxHeight)

Sets the maximum vehicle height in meters. Routes with insufficient clearance are avoided.

• Format: &maxHeight=[Height in meters]
• Example:

&maxHeight=4.5

Maximum Axle Weight (maxAxle)

Sets the maximum axle weight in tons to restrict routes to roads that allow the vehicle's load.

• Format: &maxAxle=[Weight in tons]
• Example:

&maxAxle=5

Exclude Countries (excludeCountries)

Defines a list of countries the route should avoid, using comma-separated ISO country codes.

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

&excludeCountries=FR,IT,ES

• To clear existing exclusions, pass an empty value:

&excludeCountries=

Shipped Hazardous Goods (shippedHazardousGoods)

Specifies the types of hazardous goods being transported. The route is adjusted to comply with applicable restrictions. Multiple values can be passed as a comma-separated list.

• Format: &shippedHazardousGoods=[value1],[value2],...
• Available values:

• Example:

&shippedHazardousGoods=flammable,explosive

• To clear existing selection, pass an empty value:

&shippedHazardousGoods=

The examples below show how parameters can be combined for common use cases.

Basic 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 With Hazardous Goods

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

Route With Premium Routing Options

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 With Time Windows And Hazardous Goods

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