Scale control display

This tutorial shows how to display a scale control on the map.

The measurement units for the scale control can be defined in the configuration object with options such as “metric,” “imperial,” or “nautical.” The default unit is set to “metric.”

  1. Add options to the map to load the scale control to the map. The scaleControl shows a distance scale.

  2. Include the following code in your JavaScript file (Example: app.js).

  3. Replace YOUR_MAPTILER_API_KEY_HERE with your actual MapTiler API key.

  4. Change the control position to display the control on the bottom-left corner of the map. By default, the control is showing on the bottom-right corner of the map if true. You can specify a corner position ("top-left", "top-right", "bottom-left", "bottom-right") to change the control position.

     const map = new maptilersdk.Map({
         container: 'map', // container id
         style: maptilersdk.MapStyle.STREETS,
         center: [-71.0131, 42.3585], // starting position [lng, lat]
         zoom: 9.25, // starting zoom
         scaleControl: "bottom-left" // add the scaleControl to the bottom-left corner of the map

Learn more

Check out the How to change the map labels language based on visitor’s location to learn how to get the country based on visitor’s location. This would allow you to change the control units depending on the country.

The scaleControl units (“metric”, “imperial” or “nautical”) can be set in the config object config.unit (default: “metric”)

For example:

Visit the MapTiler SDK JS API reference to know all the scaleControl options. Like changing the display distance units

Related examples

An extension of MapLibre GL JS