Display a vector map

Overview of the tutorial

This tutorial covers the basic use of the Maps SDK for Web to display a basic vector map in a web page.


To start using the latest version of the Maps SDK for Web, you need the following:

We recommend that you have npm and Node.js already installed on your computer to quickly spin up a HTTP server to display the page we will create.

Create a HTML file

Now let us create a basic HTML file to display a map. For this example I created a file named ** my-map.html**.

Next, copy the following script to your my-map.html file.

1<!DOCTYPE html>
2<html class="use-all-space">
3 <head>
4 <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
5 <meta charset="UTF-8" />
6 <title>My Map</title>
7 <meta
8 name="viewport"
9 content="width=device-width,initial-scale=1,maximum-scale=1,user-scalable=no"
10 />
11 <!-- Replace version in the URL with desired library version -->
12 <link
13 rel="stylesheet"
14 type="text/css"
15 href="https://api.tomtom.com/maps-sdk-for-web/cdn/6.x/<version>/maps/maps.css"
16 />
17 <style>
18 #map {
19 width: 100vw;
20 height: 100vh;
21 }
22 </style>
23 </head>
24 <body>
25 <div id="map" class="map"></div>
26 <!-- Replace version in the URL with desired library version -->
27 <script src="https://api.tomtom.com/maps-sdk-for-web/cdn/6.x/<version>/maps/maps-web.min.js"></script>
28 <script>
29 tt.setProductInfo("<your-product-name>", "<your-product-version>")
30 tt.map({
31 key: "<your-tomtom-API-key>",
32 container: "map",
33 })
34 </script>
35 </body>

Let's go over the important lines

First, we import all the necessary assets, in this case the JavaScript SDK and its styles.

1<!-- Replace version in the URL with desired library version -->
2<!-- Include SDK's stylesheet -->
4 rel="stylesheet"
5 type="text/css"
6 href="https://api.tomtom.com/maps-sdk-for-web/cdn/6.x/<version>/maps/maps.css"
8<!-- Include JavaScript SDK -->
9<script src="https://api.tomtom.com/maps-sdk-for-web/cdn/6.x/<version>/maps/maps-web.min.js"></script>

Then we can create our new map.

1// Set product's id and version
2tt.setProductInfo("<your-product-name>", "<your-product-version>")
6// Initialize the TomTom map in the element with an id set to 'map'
8 key: "<your-tomtom-API-Key>",
9 container: "map",

Remember to replace the placeholders with your real data.

Name of your product (e.g., com.company-name.product-name).
The version of your product.
Your TomTom API Key generated earlier.

Version of the library - all versions can be found in the Downloads

Setting the product information is optional, although we encourage you to provide it. This information helps us improve our tools even further. All the data collected this way is kept private. For more information about our privacy policy please see: Privacy And Your Information.

Run a HTTP server

Navigate to the directory containing our example using a terminal.

For example:

~$ cd sdk-example/

Install a light-weight HTTP server (you might need to run this command with admin/root privileges):

npm install -g http-server

Then just simply run the following command:


Note that npm comes bundled with Node.js, so please make sure you have it installed on your machine.

So now it is time to see the results!

Open a browser and type this URL in the address bar: http://localhost:8080/my-map.html. You should be able to see a vector map!