Follow

Custom URL calls

Introduction

With the Android Custom URL scheme you can implement a simple integration of your application with Sygic navigation.

Example with Android programming

With your Android application you can start the Sygic navigation and directly open it on a specified address using this snippet.

String lon = "15.06591";
String lat = "47.73341";
String type = "drive";
String str = "com.sygic.aura://coordinate|" + lon + "|" + lat + "|" + type;
startActivity(new Intent(Intent.ACTION_VIEW, Uri.parse(str)));

Example using HTML

This HTML web page example shows 4 hyperlinks to start Sygic navigation for showing the predefined locations and driving to the locations.

  <body>
    SLOVAKIA 48.159673,17.111206
    <a href="com.sygic.aura://coordinate|17.12812|48.15594|show">Sygic show</a>
    <a href="com.sygic.aura://coordinate|17.12812|48.15594|drive">Sygic navigate to</a>
    USA (Illinois) 41.87985,-87.636395
    <a href="com.sygic.aura://coordinate|-87.636395|41.87985|show">Sygic show</a>
    <a href="com.sygic.aura://coordinate|-87.636395|41.87985|drive">Sygic navigate to</a>
  </body>

List of Sygic Custom URL schemes

name URL scheme Example
show map on an address com.sygic.aura/address | country or country ISO code | city | postal | street | house number | type com.sygic.aura://address|SVK|Bratislava|85101|Einsteinova|21|show
drive to an address com.sygic.aura/address | country or country ISO code | city | postal | street | house number | type com.sygic.aura://address|SVK|Bratislava|85101|Einsteinova|21|drive
walk to an address com.sygic.aura/address | country or country ISO code | city | postal | street | house number | type com.sygic.aura://address|SVK|Bratislava|85101|Einsteinova|21|walk
show map on coordinates com.sygic.aura://coordinate | lon | lat | type com.sygic.aura://coordinate|15.06591|47.73341|show
drive to coordinates com.sygic.aura://coordinate | lon | lat | type com.sygic.aura://coordinate|15.06591|47.73341|drive
walk to coordinates com.sygic.aura://coordinate | lon | lat | type com.sygic.aura://coordinate|15.06591|47.73341|walk
loads json itinerary com.sygic.aura://route | file (sif or json) com.sygic.aura://route|myitinerary.sif
opens web page directly in navigation com.sygic.aura://url | webpage com.sygic.aura://url|www.shmu.sk
activate license with product code com.sygic.aura://activate|productCode com.sygic.aura://activate|2637-A356-563C-F156
start navigation and login with username com.sygic.aura://login | username | password com.sygic.aura://login|jsmith@company.com|$js!PsW
update specific map or all maps com.sygic.aura://update | map

com.sygic.aura://update|fra
com.sygic.aura://update|all

Note: the call starts downloading maps immediately
but removes old maps with the application restart.
This means that at the certain moment both maps
are present in your filesystem, so your memory limits
can be hit.

show sygic products' shop com.sygic.aura://mysygic com.sygic.aura://mysygic
show product detail from shop com.sygic.aura://mysygicproduct | productId com.sygic.aura://mysygicproduct|22945
buy a license for a product com.sygic.aura://mysygicbuy | productId com.sygic.aura://mysygicbuy|22945
restore all purchases com.sygic.aura://restore com.sygic.aura://restore
play gps nmea log from Res/gpslogs com.sygic.aura://gpslog | nmeafile com.sygic.aura://gpslog|mytraveltest.nmea
control truck settings
(available since 13.6.0)
com.sygic.aura://truckSettings | parameterstring

where parameterstring is of the form
key1=value1&key2=value2&...
for details, see the table bellow.
com.sygic.aura://truckSettings|rou=car
com.sygic.aura://truckSettings|rou=cmp
com.sygic.aura://truckSettings|mxs=90&rou=tru

com.sygic.aura://truckSettings|mxs=110&len=8000&wid=2450&hei=3450&axw=1200&wei=15000&rou=tru

com.sygic.aura://truckSettings|mxs=100&len=10000&wid=2450&hei=3200&axw=2200&wei=15550&rou=tru

define back button behavior com.sygic.aura://back_button | application identifier com.sygic.aura://back_button|com.android.chrome
overwrite app settings com.sygic.aura://settingsOverwrite | filepath

com.sygic.aura://settingsOverwrite|%2Fsdcard%2Fsettings_overload.ini
com.sygic.aura://settingsOverwrite|%2Fsdcard%2Fmenu_overload.ini

get device code com.sygic.aura://deviceCode

com.sygic.aura://deviceCode

Truck settings parameter string

key description Example
mxs defines maximum speed in km/h mxs=90
wei defines total weight in kilograms wei=15000
axl defines maximum axle weight in kilograms axw=1200
len defines length in milimeters len=7800
wid defines width in milimeters wid=2450
hei defines height in milimeters hei=3450
rou defines routing type, where the possible values are:
car, tru (truck), cmp (camper), van
rou=tru

Supported standard Android Geo URI schemes

Except for the Sygic URL schemes we also support standard Android custom URI schemes for geo functionality.

key description Example
geo lat/lon geo:latitude,longitude geo:48.12345,17.12345
geo lat/lon with zoom geo:latitude,longitude?z=zoom geo:48.12345,17.12345?z=11
geo with marker geo:0,0?q=lat,lng(label) geo:0,0?q=48.12345,17.12345(Treasure)
geo with address geo:0,0?q=my+street+address geo:0,0?q=slovakia,+bratislava,+karadzicova,+14
navigation to lat/lon google.navigation:q= google.navigation:q=Haanova+1%2C+851+04+Bratislava&mode=b&ll=48.12345,17.12345

google.navigation:q=Haanova+1%2C+851+04+Bratislava&mode=w&ll=48.12345,17.12345

google.navigation:q=Haanova+1%2C+851+04+Bratislava&mode=d&ll=48.12345,17.12345

 

Multiple actions in one call

It is possible to chain several actions within a single URL call using the &&& sign.

Example: com.sygic.aura://login|username|password&&&back_button|package

 

License terms

Integrating with the URL scheme is restricted to Personal usage.
For Commercial usage of the URL scheme please contact our sales representatives.

Was this article helpful?
1 out of 1 found this helpful
Have more questions? Submit a request

Comments