

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Come aggiungere il controllo sulla mappa
<a name="how-to-add-control-on-map"></a>

Amazon Location Service ti consente di aggiungere più controlli alla mappa, tra cui controlli di navigazione, geolocalizzazione, schermo intero, scala e attribuzione.
+ **Controllo della navigazione**: contiene pulsanti di zoom e una bussola.
+ **Controllo della geolocalizzazione**: fornisce un pulsante che utilizza l'API di geolocalizzazione del browser per localizzare l'utente sulla mappa.
+ **Controllo a schermo intero**: contiene un pulsante per attivare e disattivare la modalità a schermo intero.
+ **Controllo della scala**: mostra il rapporto tra una distanza sulla mappa e la distanza corrispondente sul terreno.
+ **Controllo dell'attribuzione**: presenta le informazioni sull'attribuzione della mappa. Per impostazione predefinita, il controllo dell'attribuzione viene ampliato (indipendentemente dalla larghezza della mappa).

Puoi aggiungere i controlli in qualsiasi angolo della mappa: in alto a sinistra, in basso a sinistra, in basso a destra o in alto a destra.

## Aggiungere i controlli della mappa
<a name="add-map-controls"></a>

Nel seguente esempio, aggiungerai i controlli della mappa elencati sopra.

### Esempio di codice di controllo della mappa
<a name="web-code-example"></a>

------
#### [ index.html ]

```
<!DOCTYPE html>
<html lang="en">
    <head>
        <title>Map Controls</title>
        <meta property="og:description" content="Initialize a map in an HTML element with MapLibre GL JS." />
        <meta charset='utf-8'>
        <meta name="viewport" content="width=device-width, initial-scale=1">
        <link rel='stylesheet' href='https://unpkg.com/maplibre-gl@5.x/dist/maplibre-gl.css' />
        <link rel='stylesheet' href='style.css' />
        <script src='https://unpkg.com/maplibre-gl@5.x/dist/maplibre-gl.js'></script>
    </head>
    <body>
        <!-- Map container -->
        <div id="map"></div>
        <script>
            const apiKey = "<API_KEY>";
            const mapStyle = "Standard"; // e.g., Standard, Monochrome, Hybrid, Satellite
            const awsRegion = "eu-central-1"; // e.g., us-east-2, us-east-1, us-west-2, etc.
            const styleUrl = `https://maps.geo.${awsRegion}.amazonaws.com/v2/styles/${mapStyle}/descriptor?key=${apiKey}`;

            const map = new maplibregl.Map({
                container: 'map', // container id
                style: styleUrl, // style URL
                center: [-123.13203602550998, 49.28726257639254], // starting position [lng, lat]
                zoom: 10, // starting zoom
                attributionControl: false, // hide default attributionControl in bottom left
            });

            // Adding controls to the map
            map.addControl(new maplibregl.NavigationControl()); // Zoom and rotation controls
            map.addControl(new maplibregl.FullscreenControl()); // Fullscreen control
            map.addControl(new maplibregl.GeolocateControl()); // Geolocation control
            map.addControl(new maplibregl.AttributionControl(), 'bottom-left'); // Attribution in bottom-left
            map.addControl(new maplibregl.ScaleControl(), 'bottom-right'); // Scale control in bottom-right
        </script>
    </body>
</html>
```

------
#### [ style.css ]

```
body { margin: 0; padding: 0; }
html, body, #map { height: 100%; }
```

------

## Suggerimenti per gli sviluppatori
<a name="developer-tips"></a>

### Opzioni di controllo della navigazione
<a name="navigationcontrol-options"></a>

```
new maplibregl.NavigationControl({ 
    showCompass: true, // show or hide compass (default: true)
    showZoom: true // show or hide zoom controls (default: true)
});
```

### Opzioni di controllo geolocalizzate
<a name="geolocatecontrol-options"></a>

```
new maplibregl.GeolocateControl({ 
    positionOptions: { enableHighAccuracy: true }, // default: false
    trackUserLocation: true // default: false
});
```

### Opzioni di controllo dell'attribuzione
<a name="attributioncontrol-options"></a>

```
new maplibregl.AttributionControl({
    compact: true, // compact (collapsed) mode (default: false)
});
```

### Opzioni di controllo della scala
<a name="scalecontrol-options"></a>

```
new maplibregl.ScaleControl({ 
    maxWidth: 100, // width of the scale (default: 50)
    unit: 'imperial' // imperial or metric (default: metric)
});
```

### Opzioni di controllo a schermo intero
<a name="fullscreencontrol-options"></a>

```
map.addControl(new maplibregl.FullscreenControl({
    container: document.querySelector('body') // container for fullscreen mode
}));
```