GuidesAPI Reference
Guides
  1. HERE Deeplinking API Developer Guide
  2. HERE Deeplinking API tutorials

How to share a route

To share a route, specify two or more waypoints along the route, and separate them by slashes (/). The first waypoint in the URL is the departure location, and the last waypoint is the destination.

Up to one hundred waypoints are supported but depending on waypoint titles and device specific limitations, a soft limit of 50 waypoints should be considered.

Common parameters

  • LATITUDE, LONGITUDE: The geocoordinates of a waypoint, in decimal degrees.
  • TITLE: Title of the location. The title must be URL-encoded. This parameter is optional.
  • WAYPOINT: You can also use a place sharing ID or the mylocation keyword as any waypoint. The mylocation keyword indicates to the receiving application that the user's current location should be used when possible.
  • MODE: Routing Mode. Specifies what routing mode should be used for the route calculation. This parameter is optional. Possible values are:
    • d – shows a driving route
    • w – shows a walking route
    • pt – shows a public transport route
    • b – shows a bike route
    • cs – shows a car sharing route
    • t – shows a taxi route
    • tr – shows a truck route. Important: This functionality requires a HERE WeGo Pro license. See the HERE WeGo Pro documentation. If opened on a non-entitled devices, a car route will be shown instead.

Examples:

This opens the app in the route overview screen, with a route from the first location to the second, using the default transport mode (car)

https://wego.here.com/r/{LATITUDE,LONGITUDE}/{LATITUDE,LONGITUDE}

This opens the app in the route overview screen, with a route from the first location to the second, using the specified mode. The list of stops will additionally display the given title for each stop

https://wego.here.com/r/{LATITUDE,LONGITUDE,TITLE}/{LATITUDE,LONGITUDE,TITLE}?m={MODE}

This opens the app in guidance, with a route starting from the first waypoint, stopping at the second and eventually reaching the third

https://wego.here.com/g/{WAYPOINT}/{WAYPOINT}/{WAYPOINT}

Route planning versus guidance

Share URLs that use /r/ will open the app in the route overview screen. Replacing that with /g/ will cause the app to open directly in guidance

Examples:

https://wego.here.com/r/mylocation/53.0999803,8.8352297
https://wego.here.com/g/52.456115,13.439375,Berlin/53.0999803,8.8352297,Bremen?m=d

HERE WeGo Pro

Important: This functionality requires a HERE WeGo Pro license. See the HERE WeGo Pro documentation for more information.

Vehicle dimensions

Vehicle dimensions can be specified the same way as documented in How to share settings.

The following share link opens HERE WeGo with a route from Berlin to Bremen with truck dimensions set to height of 350cm, length of 820cm, width of 195cm and a total weight of 4890kg.

https://wego.here.com/r/52.456115,13.439375,Berlin/53.0999803,8.8352297,Bremen?m=tr&vdh=350&vdl=820&vdw=195&vw=4890

Hazardous materials

Hazardous materials can be specified the same way as documented in How to share settings.

The following share link opens HERE WeGo with a route from Berlin to Bremen with truck hazardous materials set to explosive, gas, flammable, organic, corrosive.

https://wego.here.com/r/52.456115,13.439375,Berlin/53.0999803,8.8352297,Bremen?m=tr&hmr=explosive,gas,flammable,organic,corrosive

Tunnel category

Hazardous materials can be specified the same way as documented in How to share settings. The following share link opens HERE WeGo with a route from Berlin to Bremen with truck tunnel category set to b.

https://wego.here.com/r/52.456115,13.439375,Berlin/53.0999803,8.8352297,Bremen?m=tr&tcr=b

Truck, Trailer & Axle Configurations

Truck params truck type, trailer count, axle count, weight per axle and axle group weights can be specified the same way as documented in How to share settings.

The following share link opens HERE WeGo with a route from Berlin to Bremen with truck type 'TruckType.tractor' (semi-trailers).

https://wego.here.com/r/52.456115,13.439375,Berlin/53.0999803,8.8352297,Bremen?m=tr&trt=tractor

The following share link opens HERE WeGo with a route from Berlin to Bremen with truck type set to 'TruckType.straight', Trailer count of 2, axle count of 4 and weight per axle of 128kg.

https://wego.here.com/r/52.456115,13.439375,Berlin/53.0999803,8.8352297,Bremen?m=tr&trt=straight&trlc=2&axc=4&wpax=128

The following share link opens HERE WeGo with a route from Berlin to Bremen with truck type set to 'TruckType.straight', trailer count of 2, axle count of 4, axle group weights specified as single axle 1890kg, tandem axle 2790kg, triple axle 3690kg, quad axle 4790kg, quint axle 5890kg.

https://wego.here.com/r/52.456115,13.439375,Berlin/53.0999803,8.8352297,Bremen?m=tr&trt=straight&trlc=2&axc=4&axgwsn=1890&axgwtan=2790&axgwtri=3690&axgwqd=4790&axgwqt=5890

Updated 15 hours ago