Deeplinking API
Deeplinking API Developer's Guide

Sharing a Route

Route on a Map

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.

LATITUDE, LONGITUDE
The geocoordinates of a waypoint, in decimal degrees.
TITLE
Title for this particular 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
AVOID
Route segments that should be avoided in the route calculation. This parameter is optional. You can specify multiple values by separating them with a comma character (,). Possible values are:
  • tunnel
  • motorway
  • boatFerry
  • tollroad
  • dirtRoad
  • railFerry
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,My%20Home?m=d&a=tunnel,motorway
  • https://share.here.com/r/s-aWQ9Mjc2dTMzZHYtYWJmY2ZkOTIxZDg5NDM4ZmEyYTkxOTE4MjVlMTRiZ
    mQ7bj1MaWNodGJsaWNrK0tpbm87Yz1jaW5lbWE7cGg9JTJCNDkzMDQ0MDU4MTc5O2xhdD01Mi41MzY1NTtsb
    249MTMuNDA3NjE/s-aWQ9Mjc2dTMzZGItYjQ0MDZiNTQyMDE1NGM3YzlmZTMzZTdiNjhjNDBmNDg7bj1NYXJ
    pZStDaXR5K0FwYXJ0bWVudHM7Yz1ob3RlbDtsYXQ9NTIuNTIyMTQ7bG9uPTEzLjM4MjU0?m=pt
  • https://share.here.com/r/mylocation/s-aWQ9Mjc2dTMzZHYtYWJmY2ZkOTIxZDg5NDM4ZmEyYTkxOT
    E4MjVlMTRiZmQ7bj1MaWNodGJsaWNrK0tpbm87Yz1jaW5lbWE7cGg9JTJCNDkzMDQ0MDU4MTc5O2xhdD01Mi
    41MzY1NTtsb249MTMuNDA3NjE?m=b
iOS:
  • [[UIApplication sharedApplication] openURL:[NSURL URLWithString:@"https://share.here.com/r/52.456115,13.439375/53.0999803,8.8352297"]]
  • [[UIApplication sharedApplication] openURL:[NSURL URLWithString:@"https://share.here.com/r/s-aWQ9Mjc2dTMzZHYtYWJmY2ZkOTIxZDg5NDM4ZmEyYTkxOTE4MjVlMTRiZ
    mQ7bj1MaWNodGJsaWNrK0tpbm87Yz1jaW5lbWE7cGg9JTJCNDkzMDQ0MDU4MTc5O2xhdD01Mi41MzY1NTtsb
    249MTMuNDA3NjE/s-aWQ9Mjc2dTMzZGItYjQ0MDZiNTQyMDE1NGM3YzlmZTMzZTdiNjhjNDBmNDg7bj1NYXJ
    pZStDaXR5K0FwYXJ0bWVudHM7Yz1ob3RlbDtsYXQ9NTIuNTIyMTQ7bG9uPTEzLjM4MjU0"]]
Android:
  • Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse("https://share.here.com/r/52.456115,13.439375/53.0999803,8.8352297"));
    startActivity(intent);
  • Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse("https://share.here.com/r/s-aWQ9Mjc2dTMzZHYtYWJmY2ZkOTIxZDg5NDM4ZmEyYTkxOTE4MjVlMTRiZ
    mQ7bj1MaWNodGJsaWNrK0tpbm87Yz1jaW5lbWE7cGg9JTJCNDkzMDQ0MDU4MTc5O2xhdD01Mi41MzY1NTtsb
    249MTMuNDA3NjE/s-aWQ9Mjc2dTMzZGItYjQ0MDZiNTQyMDE1NGM3YzlmZTMzZTdiNjhjNDBmNDg7bj1NYXJ
    pZStDaXR5K0FwYXJ0bWVudHM7Yz1ob3RlbDtsYXQ9NTIuNTIyMTQ7bG9uPTEzLjM4MjU0"));
    startActivity(intent);