URL Schemes for GO Navigation iOS

Jürgen
Community Managers, Administrators Posts: 7,188 
Community Manager

Community Manager
TomTom GO Navigation implements the x-callback-url protocol, which allow iOS and macOS developers to expose and document API methods they make available to other apps and return useful data.
TomTom GO Navigation URL Scheme actions look like this:
tomtomgo://x-callback-url/[action]?[action parameters]
Actions
/navigate
Plan a route to the specified destination coordinates.
parameters:
∙ destination - The destination point to navigate to. Formatted as a comma separated string of latitude,longitude.
Note: the map for the destination should be downloaded, otherwise the action could not be performed.
Example:
tomtomgo://x-callback-url/navigate?destination=52.371183,4.892504
TomTom GO Navigation URL Scheme actions look like this:
tomtomgo://x-callback-url/[action]?[action parameters]
Actions
/navigate
Plan a route to the specified destination coordinates.
parameters:
∙ destination - The destination point to navigate to. Formatted as a comma separated string of latitude,longitude.
Note: the map for the destination should be downloaded, otherwise the action could not be performed.
Example:
tomtomgo://x-callback-url/navigate?destination=52.371183,4.892504
4
Comments
-
Hi @Jürgen ,
Thank you to you and everybody at TomTom for adding URL Schemes to TomTom GO.
However, there is one other thing. is it possible to add the name of the destination as well as the destination location?
For example, the old format for TomTom Europe was:
com.tomtom.Europe://geo:action=navigateto&lat=48.86870&long=2.78181&name=Disneyland%20Paris
That would lauch TomTom Europe with the destination of 48.86870,2.78181 with a name of "Disneyland Paris" that would appear in the recent Recent Destinations.
0 -
Hi @Jürgen and other TomTom gurus,
I think I've got the Action /navigate sorted, but are there any more parameters than destination? There should hopefully be something like "name" as I would like to add the name of the location to navigate to so that its actual name appears in the Recent Destinations list, rather than an address which can at times be meaningless.
I was hoping that Action /navigate would have parameters such as destination and home. I've tried using symbols such as '?' and '&' but as yet nothing helps.
Using the Disneyland Paris Hotel as an example, I would like to emulate the URL Scheme for the legacy TomTom Europe:com.tomtom.Europe://geo:action=navigateto&lat=48.871206&long=2.781018&name=Disneyland%20Paris%20Hotel
I was hoping that in TomTom GO, I could use something like:tomtomgo://x-callback-url/navigate?destination=48.871206,2.781018&name=Disneyland%20Paris%20Hotel
Is it possible to use a name parameter that appears in the Recent Destinations list? If it is then please give an example.
If it isn't then would you please add it to the URL Scheme for TomTom GO?
Regards,0 -
Thanks for your feedback which I forwarded. Unfortunately this parameter is not supported at the moment.0
-
Hi @Jürgen ,
Thanks for the reply.
Could you ask the team if they would please add support for more parameters like "name" to the /navigate action and allow the value of the name parameter to appear in the Recent Destinations list?
Also, would it be possible for the team to document any methods necessary for dealing with special characters in the name parameter, e.g.:- Diacritical marks aka accent marks
- & (Ampersand) i.e. U+0026
- , (comma)
- () round brackets
- [] Square brackets
- # Hash
- + and - (plus and minus)
Kind Regards,0 -
Thanks to TomTom for adding the url scheme! I just tried it on the current version of TomTom Go and it just works fine.
@Jürgen : @PrivateerUK 's request seems reasonable to me since most navigation apps offer an additional name for the sake of a more readable history of recent destinations in my experience.
My final 2 cents for this thread: Long after this thread started, Apple introduced https://developer.apple.com/ios/universal-links/ , which might be interesting for you in the long term.
If you would be able to define a destination like this: http://tomtom.com/location?lat=50,lon=7 , with universal links, the app would be able to intercept this URL. This is kind of a new alternative to custom URL schemes. In addition, any user who has NOT installed the app, would be "just" opening the web page and would be redirected to TomTom. This would of course not only require a change to the app, but a major change to the website. Advantage: as the name "universal" suggests, you would be able to open this link on any device, no matter which app is installed.
But the most important aspect in my view - I can finally deep link TomTom again.Well done, thanks!
2 -
Thank you to the team for bringing back this feature.
A "name" parameter would be a great addition for sure !1 -
Hi @Jürgen,
Version 2.1 introduced the basic URL Scheme back in early November 2019. We would still like to see a name parameter for a more readable history of recent destinations.
Since 2.1 was released, we've have three more releases: 2.1.1; 2.1.2; and 2.1.3.
Would you please pass this request to the team and ask them to implement it as soon as possible.
Regards,0 -
TomTom GO Navigation implements the x-callback-url protocol, which allow iOS and macOS developers to expose and document API methods they make available to other apps and return useful data.
TomTom GO Navigation URL Scheme actions look like this:
tomtomgo://x-callback-url/[action]?[action parameters]
Actions
/navigate
Plan a route to the specified destination coordinates.
parameters:
∙ destination - The destination point to navigate to. Formatted as a comma separated string of latitude,longitude.
Note: the map for the destination should be downloaded, otherwise the action could not be performed.
Example:
tomtomgo://x-callback-url/navigate?destination=52.371183,4.892504
This is a great improvent enabling us to use L4Cpro
You can create a link in L4Cpro with the following url:
tomtomgo://x-callback-url/navigate?destination=[LATITUDE],[LONGITUDE]
and navigate to a geocache with TomTomGo1 -
Hi everyone,
I wrote a small server and an IOS shortcut to set the TomTom Go navigation using the location on GoogleMap. Oh, you only need to use the shortcut, no need the server. You can see it here with demo: https://github.com/ote77/TomTom-Go-navigation-to-GoogleMap-Location
If you like it please give me a starAnd if there is any problem, please let me know
Terry6 -
@TerryOte This is amazing!! Exactly what I've been wanting to be able to do for years as the TomTom POI database is really poor compared to Google Maps, so I was always finding my destination in Google Maps then manually locating it on the map in TomTom. This will save so much time, thank you for sharing this. I even got the server part running on my own server.
Before I found this, I was trying to do it all in Shortcuts but couldn't work out how to get around the "consent" redirect when expanding the short Google URL. Really curious how your server part achieves this, I can't quite tell from looking at your code.1 -
Does anyone know if an URL scheme is also available for the other versions (like https://play.google.com/store/apps/details?id=com.tomtom.gplay.navapp.nds&hl=en&gl=US) and beta?
Maybe another prefix?0