

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à.

# Mappe statiche
<a name="static-maps"></a>

**Nota**  
Le mappe statiche supportano solo gli stili Standard e Satellite. Per ulteriori informazioni, consulta [AWS stili e caratteristiche delle mappe](map-styles.md).

Le mappe statiche offrono una rappresentazione pre-renderizzata dei dati geografici con la possibilità di sovrapporre indicatori (o puntini), percorsi e aree poligonali, in base alle esigenze dell'applicazione. La mappa statica consente di generare immagini cartografiche statiche (non interattive) basate su parametri e input di dati personalizzabili. Personalizzando sovrapposizioni, forme o applicando stili personalizzati, Static Map consente di creare visualizzazioni di mappe che soddisfano esigenze specifiche, migliorando l'esperienza dell'utente finale e comunicando efficacemente le informazioni geografiche. Il server personalizza le immagini delle mappe richieste e le consegna al client come file JPEG. È possibile richiedere e generare in modo programmatico immagini di mappe personalizzate in base alle proprie esigenze specifiche.

L'*GetStaticMap API* genera un'immagine statica di una mappa in base a parametri specifici come coordinate centrali, riquadri di delimitazione o sovrapposizioni. L'API consente la personalizzazione delle caratteristiche e dello stile della mappa, consentendone l'uso in applicazioni Web o mobili senza funzionalità di mappe interattive.

Per ulteriori informazioni, consulta il *riferimento [GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)all'API di Amazon Location Service*.

Per esempio richieste, risposte, cURL e comandi CLI per questa API, vedi [Come usare](https://docs.aws.amazon.com/location/latest/developerguide/static-maps-how-to.html) le mappe statiche.

## Casi di utilizzo comune
<a name="static-maps-use-cases"></a>
+ **Mappe integrate in applicazioni Web o mobili:** le immagini delle mappe statiche possono essere incorporate in modo efficiente in siti Web o applicazioni mobili per fornire visualizzazioni di posizioni, percorsi o punti di interesse con mappe non interattive, riducendo i tempi di caricamento e l'utilizzo dei dati. Gli esempi includono i motori di ricerca (come Yahoo) che mostrano immagini di mappe con risultati di ricerca per. POIs
+ **Dettagli sulla posizione nelle e-mail:** è possibile utilizzare immagini cartografiche statiche per condividere informazioni sulla posizione via e-mail per aiutare gli utenti finali a comprendere il contesto dell'e-mail. Ad esempio, le app per la consegna di cibo o il ride-sharing utilizzano immagini di mappe statiche per visualizzare i punti di ritiro/riconsegna, i percorsi o le aree circostanti nelle e-mail post-viaggio o di consegna contenenti fattura e riepilogo.
+ **Materiali di marketing e documenti stampati:** è possibile incorporare immagini di mappe statiche personalizzate in brochure, volantini o altri materiali stampati, fornendo rappresentazioni visivamente accattivanti delle informazioni geografiche pertinenti al contenuto.

## Comprendi la richiesta
<a name="static-maps-understanding-request"></a>

La richiesta include parametri URI opzionali, come `BoundedPositions``BoundingBox`, e`Center`, tra gli altri, per definire l'area visibile e le sovrapposizioni della mappa. I parametri `Height` `Width` sono necessari per definire la dimensione dell'immagine. Per ulteriori informazioni, consultare [Personalizza mappe statiche](customizing-static-maps.md) e [Sovrapposizione sulla mappa statica](overlaying-static-map.md).
+ `BoundedPositions`: Coordinate da includere nell'immagine.
+ `BoundingBox`: Coordinate che definiscono i bordi sud-ovest e nord-est della mappa.
+ `Height`: specifica l'altezza dell'immagine.
+ `Width`: specifica la larghezza dell'immagine.
+ `GeoJsonOverlay`: Un oggetto GeoJSON valido per aggiungere sovrapposizioni.

## Comprendi la risposta
<a name="static-maps-understanding-response"></a>

La risposta contiene intestazioni come `CacheControl` `ContentType``ETag`, e e restituisce la mappa statica come blob binario in formato JPEG o PNG. Le intestazioni forniscono metadati come il controllo della cache, il tipo di contenuto e la versione per le immagini statiche.
+ `CacheControl`: specifica le configurazioni di memorizzazione nella cache per l'immagine della mappa.
+ `ContentType`: indica il formato dell'immagine della mappa (JPEG o PNG).
+ `ETag`: un identificatore per la versione dell'immagine statica della mappa.
+ `Blob`: rappresenta l'immagine della mappa in formato JPEG o PNG.