GuidesAPI Reference
Guides

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 HERE WeGo Pro documentation>. If opened on a non-entitled devices, a car route will be shown instead.
https://share.here.com/r/{LATITUDE,LONGITUDE}/{LATITUDE,LONGITUDE}
https://share.here.com/r/{LATITUDE,LONGITUDE,TITLE}/{LATITUDE,LONGITUDE,TITLE}?m={MODE}&a={AVOID}
https://share.here.com/r/{WAYPOINT}/{WAYPOINT}?m={MODE}&a={AVOID}

Examples:

https://share.here.com/r/52.456115,13.439375/53.0999803,8.8352297
https://share.here.com/r/52.456115,13.439375,Berlin/53.0999803,8.8352297,Bremen?m=d&a=tunnel,motorway

HERE WeGo Pro

Important: This functionality requires a HERE WeGo Pro license. See HERE WeGo Pro documentation>.

Vehicle dimensions

Vehicle dimensions can be specified the same way as documented in 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://share.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 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://share.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 Share Settings

The following share link opens HERE WeGo with a route from Berlin to Bremen with truck tunnel category set to b.

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