> For the complete documentation index, see [llms.txt](https://docs.mapbox.com/mapbox-gl-js/ja/llms.txt)

# Display map scale

This example uses [`Map.addControl`](https://docs.mapbox.com/mapbox-gl-js/ja/api/map/#map#addcontrol) to add a [`ScaleControl`](https://docs.mapbox.com/mapbox-gl-js/ja/api/markers/#scalecontrol) to the map, displaying the real-world distance represented by the map's current zoom level.

When instantiating `ScaleControl`, there are two optional parameters:

-   `maxWidth`: sets the maximum width in pixels to use to display the scale bar.
-   `unit`: sets the unit of measurement. Options include - `imperial`, `metric` and `nautical`.

> Example code:

**JavaScript**

```html
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Display map scale</title>
<meta name="viewport" content="initial-scale=1,maximum-scale=1,user-scalable=no">
<link href="https://api.mapbox.com/mapbox-gl-js/v3.29.0/mapbox-gl.css" rel="stylesheet">
<script src="https://api.mapbox.com/mapbox-gl-js/v3.29.0/mapbox-gl.js"></script>
<style>
body { margin: 0; padding: 0; }
#map { position: absolute; top: 0; bottom: 0; width: 100%; }
</style>
</head>
<body>
<div id="map"></div>
<script>
    const map = new mapboxgl.Map({
        // TO MAKE THE MAP APPEAR YOU MUST
        // ADD YOUR ACCESS TOKEN FROM
        // https://account.mapbox.com
        accessToken: 'YOUR_MAPBOX_ACCESS_TOKEN',
        container: 'map', // container ID
        // Choose from Mapbox's core styles, or make your own style with Mapbox Studio
        style: 'mapbox://styles/mapbox/standard', // style URL
        center: [-74.5, 40], // starting position
        zoom: 9 // starting zoom
    });

    // Creates a new scale control to measure the map
    const scale = new mapboxgl.ScaleControl({
        maxWidth: 120, // the max pixel width of the scale bar to be rendered on the map (default is 100 pixels)
        unit: 'imperial' // The type of measurement displayed, options are: 'imperial', 'metric', 'nautical' (default it metric)
    });

    // Adds the new scale control to the map
    map.addControl(scale);
</script>

</body>
</html>
```

**React**

```jsx
import React, { useEffect, useRef } from 'react';
import * as mapboxgl from 'mapbox-gl/esm';
import 'mapbox-gl/dist/mapbox-gl.css';

const MapboxExample = () => {
  const mapContainerRef = useRef();
  const mapRef = useRef();

  useEffect(() => {
    mapRef.current = new mapboxgl.Map({
      // TO MAKE THE MAP APPEAR YOU MUST
      // ADD YOUR ACCESS TOKEN FROM
      // https://account.mapbox.com
      accessToken: 'YOUR_MAPBOX_ACCESS_TOKEN',
      container: mapContainerRef.current,
      style: 'mapbox://styles/mapbox/standard',
      center: [-74.5, 40],
      zoom: 9
    });

    // Creates a new scale control to measure the map
    const scale = new mapboxgl.ScaleControl({
      maxWidth: 120, // the max pixel width of the scale bar to be rendered on the map (default is 100 pixels)
      unit: 'imperial' // The type of measurement displayed, options are: 'imperial', 'metric', 'nautical' (default it metric)
    });

    mapRef.current.addControl(scale);

    return () => {
      mapRef.current.remove();
    };
  }, []);

  return <div ref={mapContainerRef} id="map" style={{ height: '100%' }} />;
};

export default MapboxExample;
```