GuidesAPI ReferenceChangelog
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.

HERE supports up to one hundred waypoints, 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 app that the user's current location should be used when possible.

  • MODE: Routing Mode. Specifies which routing mode to use 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 non-entitled devices, a car route is 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 requirements

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

Vehicle dimensions

Specify vehicle dimensions 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

Specify hazardous materials 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

Specify query truck parameters and set the tunnel category 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

Truck, Trailer & Axle Configurations

Specify truck parameters truck type, trailer count, axle count, weight per axle and axle group weights the same way as documented in Share Settings.

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

https://share.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://share.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://share.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

Waypoint types

While defining route waypoints, you can specify waypoint types. If not specified, the default waypoint type is considered as a stopover point.
Origin and destination are always considered as stopover type.

The waypoint definition format is as follows:
LATITUDE,LONGITUDE,TITLE,WAYPOINT_TYPE

Where WAYPOINT_TYPE can be as:

  • s - stopover point

  • p - pass-through point

  • Example 1: LATITUDE,LONGITUDE,TITLE,WAYPOINT_TYPE (e.g., 52.456115,13.439375, Berlin,s) - title and waypoint type defined as stopover type.

  • Example 2: LATITUDE,LONGITUDE,,WAYPOINT_TYPE (e.g., 52.456115,13.439375,,p) - no title defined, only waypoint type defined as pass-through type.

  • Example 3: LATITUDE,LONGITUDE,,WAYPOINT_TYPE (e.g., 52.456115,13.439375,,,) - no title and no waypoint type defined. This will consider as stopover waypoint.

  • Example 4: LATITUDE,LONGITUDE (e.g., 52.456115,13.439375) - no title and no waypoint type defined. This will consider as stopover waypoint.

The following share link opens HERE WeGo with a route from Berlin to Bremen with Celle defined as a stopover point and 52.64280,9.20669 as a pass-through point.

https://share.here.com/r/52.456115,13.439375,Berlin/52.62515,10.08621,Celle,s/52.64280,9.20669,,p/53.0999803,8.8352297?m=d"

Updated 27 days ago

Did this page help you?