How to add and customize a location marker


In this tutorial you will learn how to add a TomTom map with a marker to your website.

  • You can display your company location and show your clients where they can find you.
  • You can add the address and image to the marker in order to make it more personalized.


To start using the TomTom Maps SDK for Web, you need the following:

  • API Key - If you don't have an API key visit a How to get a TomTom API key site and create one.
  • Coordinates
    How to find your company location coordinates?
    The simplest way to obtain these coordinates is to go to api_explorer. First, click Fuzzy Search and then click the Try it out button. Let us assume your company address is: '100 Century Center Ct 210, San Jose, CA 95112, USA'. You have to place it in a query field and clear other pre-populated fields. Then scroll down and press the Execute button. Please take into account that you should not use special HTML characters (like '$','?',&','#') in the address. In the Response you can find the section and there you can see that the very first item from the list of items matched your query. Look at the property following the address fields. There you can see the data you need:

Displaying a map

The following minimal HTML structure contains the JavaScript code to initialize and display a TomTom map:

1<!DOCTYPE html>
3 <head>
4 <title>My map</title>
5 <!-- Replace version in the URL with desired library version -->
6 <link
7 rel="stylesheet"
8 type="text/css"
9 href="<version>/maps/maps.css"
10 />
11 <script src="<version>/maps/maps-web.min.js"></script>
12 <style>
13 #map {
14 height: 500px
15 width: 500px;
16 }
17 </style>
18 </head>
19 <body>
20 <div id="map"></div>
21 <script>
22 var map ={
23 container: "map",
24 key: "<your-api-key>",
25 })
26 </script>
27 </body>

To run this example locally, create an index.html file. Then you can copy the preceding HTML code and paste it into the file you have just created. Replace ‘<your-api-key>‘ with the API Key you obtained before (in the Prerequisites section).

Then run the index.html file in your browser. Now you should see a map.

Displaying the company on the map

Now, let us place your company on the map.
Define a variable and set your company's coordinates (lon/lan) in an array:

var speedyPizzaCoordinates = [-121.91595, 37.36729]

Now add coordinates to the map initialization to focus it on your company:

1var map ={
2 container: "map",
3 key: "<your-api-key>",
4 center: speedyPizzaCoordinates,
5 zoom: 15,

Create a marker variable and add it to the map:

var marker = new tt.Marker().setLngLat(speedyPizzaCoordinates).addTo(map)

Define a pop-up connected with your marker. Additionally, make it open/visible to the user:

1var popupOffsets = {
2 top: [0, 0],
3 bottom: [0, -70],
4 "bottom-right": [0, -70],
5 "bottom-left": [0, -70],
6 left: [25, -35],
7 right: [-25, -35],
10var popup = new tt.Popup({ offset: popupOffsets }).setHTML(
11 "your company name, your company address"

You should see the map with your company name and address in the pop-up. To separate the first line from the second line, use a <br /> tag. You can also bold your company name to make the whole pop-up clearer:

1var popup = new tt.Popup({ offset: popupOffsets }).setHTML(
2 "<b>Speedy's pizza</b><br/>100 Century Center Ct 210, San Jose, CA 95112, USA"

Now you have your company location on the map!


Optionally, you can do some more customization to make it look better. So far, you used a default marker. Let us assume that you want to have a custom marker icon on the map for a pizza restaurant. First, create an img folder in your project. Then, add the image you want to use as the marker to this folder. Here you can find the custom marker used for this tutorial: pizza marker. Now you can go back to index.html. Before you defined the marker in this way:

var marker = new tt.Marker().setLngLat(speedyPizzaCoordinates).addTo(map)

Now, you need to create a div element and set the style. Indicate it in the marker options. Assuming that your image is named 'pizza_marker.png', your new code will look like this:

1#marker {
2 background-image: url("img/pizza_marker.png");
3 background-size: cover;
4 width: 50px;
5 height: 70px;
1var element = document.createElement("div") = "marker"
4var marker = new tt.Marker({ element: element })
5 .setLngLat(speedyPizzaCoordinates)
6 .addTo(map)

If you run your map now, you should see that your marker uses your image instead of the default one. Depending on your image, you may want the icon placed centrally on the location, or you may want to have it shifted so it will point at your company. The same applies to the pop-up. You may want to move it up a bit if you do not want to cover your company logo. If you want to solve these issues you should adjust the anchor and offset properties.

Now you need to add some content to your pop-up. Right now it looks like this:

1var popup = new tt.Popup({ offset: popupOffsets }).setHTML(
2 "<b>Speedy's pizza</b><br/>100 Century Center Ct 210, San Jose, CA 95112, USA"

Let's start by adding an image to your pop-up so the customer can see your company's logo/photo. Add the image you want to use to the img folder which is located next to the sdk folder (the same way you previously did it with the marker image). Let us assume that you want to see in your pop-up:

  • your company's name
  • advertising text below it
  • your company's address
  • the image aligned to the right side

See the following code:

1var customPopup =
2 '<p style="display:inline">' +
3 '<img src="img/pizza_oven_illustration.png" alt="pizza oven" style="width:50%;float:right;padding-top:10px">' +
4 '<div style="width:50%; height:100%; padding-top:10px"><span style="font:14px Gotham">Speedy&#39;s pizza</span></br>' +
5 '<div style="font:9px Gotham"><span style="color:grey">In 30 minutes at your place!</span><div><br/>' +
6 '<span style="font:10px Gotham">100 Century Center Ct 210, San Jose, CA 95112<br/>USA</span></br>' +
7 "</div></p>"
9var popup = new tt.Popup({ offset: popupOffsets }).setHTML(customPopup)

As you can see, you can put all HTML code and styling to the customPopup variable. Feel free to change the code and experiment a bit until you achieve the appearance you like the most! Now you need to add the map to your website.

You can find all the source code here on GitHub.


In this tutorial you learned:

  • how to put your company location on the map
  • how to make a default marker and customized marker and put it on the map
  • how to make a default pop-up and customized pop-up with text and image and add it to the map
  • how to embed the map and put it to your page