IMPARGO Knowledge Center

Unleash the full potential of our software with our comprehensive Knowledge Center, offering detailed information on its functionality and features.

  • PLANNER: Truck, Toll & Tour Calculation
  • ORDERS: Order Management
  • ORDERS: Offer Management
  • FLEET: Execute With The DriverApp
  • DISPATCH: The Dispatch Board for Trucks
  • DRIVERAPP: Order Execution & Truck Navigation for Drivers
  • Managing Master Data
  • Analytics
  • Help Center
  • Integrations

Pre-fill the Planner with URL parameters

1. Basic URL Structure

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 (&).

 


2. Encoding Format

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

EncodingCharacter
%2CComma ( , )
%3AColon ( : )
%2520Space
%25C3%259Fß

 


3. Parameter Explanation

You can pass these parameters to the Planner in the URL. All parameters are optional unless stated otherwise.

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

  • 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 waypoints between two stops. To add more than one waypoint on a leg, separate them with a semicolon.

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

 

&via[0]=49.807393,8.70762

Departure Time (departureDate)

Sets 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)

Turns on time management for the route when set to true.

  • Format: &withTimeManagement=true

 


Time Windows (timeWindows[x])

Sets one or two time windows for each stop. The index x is 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 is the stop index.

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

 

&waitingTimes[0]=75

Rest Stop Recommendations (enableRestStopsRecommendation)

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

  • Format: &enableRestStopsRecommendation=true

 


Minutes Driven Before Route Start (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.

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

 

&minutesDrivenBeforeRouteStart=10

 


4. Routing Options

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.

Routing Mode (routingMode)

Sets how the route is optimized.

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

 

ValueDescription
fastestFastest route by time (default)
shortestShortest route by distance
costOptimizedCost-optimized routing
avoidTollsAvoids toll roads

 

  • Example:

 

&routingMode=fastest

Consider Traffic (considerTraffic)

When set to true, the route calculation takes current traffic into account.

  • Format: &considerTraffic=true

 


Maximum Vehicle Height (maxHeight)

Sets the maximum vehicle height in meters. The route avoids places where the clearance is too low.

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

 

&maxHeight=4.5

Maximum Axle Weight (maxAxle)

Sets the maximum axle weight in tons. The route then uses only roads that allow the vehicle's load.

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

 

&maxAxle=5

Exclude Countries (excludeCountries)

Lists the countries the route should avoid, as 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)

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.

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

 

ValueDescription
explosiveExplosive materials
gasGases
flammableFlammable liquids
combustibleCombustible materials
organicOrganic peroxides
poisonPoisonous substances
radioActiveRadioactive materials
corrosiveCorrosive substances
harmfulToWaterWater-polluting substances
otherOther hazardous materials

 

  • Example:

 

&shippedHazardousGoods=flammable,explosive
  • To clear existing selection, pass an empty value:

 

&shippedHazardousGoods=


 



5. Example URLs

The examples below show how to combine parameters for common 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

Share Orders & Offers with Partners

ORDERS: Order Management


Impargo-logo

Digitalize your transport business overnight.

© IMPARGO 2026, All rights reserved.