Creating a website button for POIs

Print 

You can publish a POI set by creating an 'Add to TomTom' button. The button allows you to send POI sets to your users' TomTom devices via TomTom HOME. When the button is clicked, the user is redirected to the addto.tomtom website which checks if TomTom HOME is installed. If yes, the POI set is sent to TomTom HOME. If HOME is not installed, the user is asked to install it. HOME receives the information and asks the user if they want to install the POI set.

This is the 'Add to TomTom' button:

add-to-my-tomtom  

Note: All non-alphanumeric characters in the URL parameters of the HTML button code (see below) must be URL-escaped. This means that you need to replace all non-alphanumeric characters with the hexadecimal encoding for the value of that character. For example, "http://www.yourdomain.com" becomes "http%3A%2F%2Fwww.yourdomain.com". There are websites and tools available that can help you do this.

Follow the instructions below to place an 'Add to TomTom' button on your website.

Adding a POI set download button

To add a button to your website, copy and paste the code below into your web page and adapt the parameters accordingly. The image for the button is downloaded from a TomTom server.

<a href="http://addto.tomtom.com/api/home/v2/content?action=install&apikey=yourAPIKey&uri=http%3A//www.YourDomain.com/YourXMLfile.xml&source=http%3A//www.tomtom.com"><img src="http://addto.tomtom.com/api/images/addtotomtom-button.gif" alt="Add-To-TomTom" border="0"/></a>

Parameter

Description

action (required)

The action to be applied to the POI set. Currently, the only action available is install.

apikey (required)

A valid API key is required to use the 'Add to TomTom' buttons. You can get an API key by emailing add2TTsupport@tomtom.com

uri (required)

The URI pointing to the XML file that you created for your POI set.

source (optional)

The URL pointing to the original page where the button is placed. This is used to go back to the page when the installation of the POI set is finished.

attribution (optional)

The name of the address supplier.

logo (optional)

A URL pointing to the logo image of the address supplier.

Click here to see code examples for POI website buttons.