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 usare le mappe statiche
Questi argomenti pratici offrono step-by-step indicazioni per personalizzare mappe statiche con sovrapposizioni ed elementi visivi, utilizzando le funzionalità di mappatura di Amazon Location Service. Ogni guida illustra le attività principali, come la regolazione delle dimensioni della mappa, la scelta tra zoom o raggio e l'aggiunta di vari elementi geospaziali come indicatori, poligoni, linee e cerchi di prossimità. Queste guide utilizzano sia i formati compatti che quelli GeoJSON per garantire flessibilità nello stile e nella configurazione.
Che si tratti di ottimizzare le mappe per applicazioni rivolte ai clienti o di eseguire analisi geospaziali, questi argomenti forniscono istruzioni chiare su come personalizzare le mappe statiche in base a requisiti specifici. Seguendo gli esempi dettagliati, imparerai come migliorare le presentazioni delle mappe e gestire in modo efficiente i dati geografici per una varietà di esigenze aziendali.
**Topics**
+ [Come ottenere una mappa statica di una posizione specifica](get-static-map-specific-position.md)
+ [Come ottenere una mappa statica di una dimensione specifica](get-static-map-specific-dimension.md)
+ [Come decidere tra raggio e zoom per una mappa statica](choose-radius-vs-zoom.md)
+ [Come aggiungere una scala per una mappa statica](add-scale-static-map.md)
+ [Come aggiungere un marker a una mappa statica](add-marker-static-map.md)
+ [Come aggiungere una linea a una mappa statica](how-to-add-line-static.md)
+ [Come aggiungere un percorso a una mappa statica](how-to-add-route.md)
+ [Come aggiungere un poligono a una mappa statica](how-to-add-polygon-static.md)
+ [Come impostare la lingua per le mappe statiche](set-language-static-map.md)
+ [Come aggiungere un cerchio di prossimità a una mappa statica](how-to-add-proximity-circle.md)
# Come ottenere una mappa statica di una posizione specifica
In questo argomento, imparerai come recuperare mappe statiche da Amazon Location Service in base a parametri specifici. Imparerai come generare una mappa statica per una posizione centrale, un riquadro di delimitazione e un insieme di posizioni limitate. Gli esempi forniti ti aiuteranno a personalizzare la larghezza, l'altezza e lo stile della mappa.
**Nota**
È necessario passare uno dei due `map` valori o `map@2x` durante la generazione di una mappa statica.
## Ottieni l'immagine della mappa per una posizione centrale
In questo esempio, creerai un'immagine della mappa con una larghezza `1024` e un'altezza di `1024` con le coordinate centrali impostate su`-123.1143,49.2763`, dove `longitude=-123.1143` e e `latitude=49.2763` un livello di zoom di`15`.
------
#### [ Request URL ]
```
https://maps.geo.eu-central-1.amazonaws.com/v2/static/map?style=Satellite&width=1024&height=1024&zoom=15¢er=-123.1156126,49.2767046&key=API_KEY
```
------
#### [ Response image ]
![\[Aerial view of a coastal city with dense urban layout, harbor, and large stadium visible.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/static-center.png)
------
## Ottieni l'immagine della mappa per il riquadro di delimitazione
In questo esempio, genererai un'immagine cartografica del Sud-est asiatico impostando il riquadro di delimitazione per l'area.
Il `bbox` formato è`{southwest_longitude},{southwest_latitude},{northeast_longitude},{northeast_latitude}`.
------
#### [ Request URL ]
```
https://maps.geo.eu-central-1.amazonaws.com/v2/static/map?style=Satellite&width=1024&height=1024&bounding-box=90.00,-21.94,146.25,31.95&key=API_KEY
```
------
#### [ Response image ]
![\[Satellite view of Southeast Asia, showing mainland, islands, and surrounding waters.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/static-bounding-box.png)
------
## Ottieni l'immagine della mappa per le posizioni delimitate
In questo esempio, genererai una mappa che copre diversi luoghi imperdibili di Parigi, ciascuno specificato dalle sue coordinate (longitudine, latitudine). Le posizioni delimitate includono: Torre Eiffel, Museo del Louvre, Cattedrale di Notre-Dame, Champs-Élysées, Arco di Trionfo, Basilica del Sacro Cuore, Giardini del Lussemburgo, Musée d'Orsay, Place de la Concorde e Palais Garnier.
Il formato `{longitude1},{latitude1},{longitude2},{latitude2} ... {longitudeN},{latitudeN}` per le posizioni di delimitazione è.
------
#### [ Request URL ]
```
https://maps.geo.eu-central-1.amazonaws.com/v2/static/map?style=Satellite&width=1024&height=1024&bounded-positions=2.2945,48.8584,2.3376,48.8606,2.3500,48.8529,2.3076,48.8698,2.2950,48.8738,2.3431,48.8867,2.3372,48.8462,2.3266,48.8600,2.3212,48.8656,2.3317,48.8719&key=API_KEY
```
------
#### [ Response image ]
![\[Aerial view of Paris showing dense urban layout, Seine River, and iconic landmarks.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/static-bounding-position.png)
------
# Come ottenere una mappa statica di una dimensione specifica
In questo argomento, imparerai come impostare le dimensioni (altezza e larghezza) per le mappe statiche utilizzando Amazon Location Service. La personalizzazione delle dimensioni di un'immagine della mappa consente di bilanciare prestazioni, qualità visiva e usabilità. I valori massimi per entrambi `width` `height` sono 1400 pixel, mentre i valori minimi sono 64 pixel. La dimensione massima del risultato è 6 MB.
Inoltre, puoi utilizzare i `bounds` parametri `bbox` and `padding` per assicurarti che gli elementi importanti della mappa vicino ai bordi siano completamente visibili e non tagliati.
## Ottieni un'immagine della mappa con altezza e larghezza specifiche
In questo esempio, creerai un'immagine cartografica a bassa e media risoluzione di Helsinki, Finlandia.
------
#### [ Request URL for low-resolution thumbnail ]
```
https://maps.geo.eu-central-1.amazonaws.com/v2/static/map?style=Satellite&width=200&height=200&zoom=11.5¢er=24.9460,60.1690&key=API_KEY
```
------
#### [ Response (Thumbnail 200x200) ]
![\[Aerial view of a coastal city with intricate waterways, islands, and urban development.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/static-specific-dimension-low.png)
------
#### [ Request URL for mid-resolution image ]
```
https://maps.geo.eu-central-1.amazonaws.com/v2/static/map?style=Satellite&width=700&height=700&zoom=13¢er=24.9460,60.1690&key=API_KEY
```
------
#### [ Response image (700x700) ]
![\[Aerial view of a coastal city with dense urban development, harbors, and surrounding waters.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/static-specific-dimension-mid.png)
------
## Ottieni un'immagine della mappa con imbottitura su tutti i lati
In questo esempio, genererai una mappa utilizzando diversi luoghi imperdibili di Helsinki, in Finlandia, con le relative coordinate (longitudine, latitudine), con e senza padding.
------
#### [ Request URL with padding ]
```
https://maps.geo.eu-central-1.amazonaws.com/v2/static/map?style=Satellite&width=1024&height=1024&padding=150&bounded-positions=24.9526,60.1692,24.9850,60.1465,24.9270,60.1725,24.9226,60.1826,24.9509,60.1675,24.9566,60.1685,24.9457,60.1674,24.9397,60.1719,24.9414,60.1715,24.9387,60.1720&key=API_KEY
```
------
#### [ Response image (with padding) ]
![\[Aerial view of a coastal city with dense urban areas, harbors, and surrounding islands.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/static-specific-dimension-padding.png)
------
#### [ Request URL without padding ]
```
https://maps.geo.eu-central-1.amazonaws.com/v2/static/map?style=Satellite&width=1024&height=1024&bounded-positions=24.9526,60.1692,24.9850,60.1465,24.9270,60.1725,24.9226,60.1826,24.9509,60.1675,24.9566,60.1685,24.9457,60.1674,24.9397,60.1719,24.9414,60.1715,24.9387,60.1720&key=API_KEY
```
------
#### [ Response image (without padding) ]
![\[Aerial view of a coastal city with dense urban areas, harbors, and small islands.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/static-specific-dimension-no-padding.png)
------
# Come decidere tra raggio e zoom per una mappa statica
In questo argomento, imparerai come scegliere `zoom` se utilizzare `radius` o generare mappe statiche con Amazon Location Service. Il `radius` parametro offre un controllo più preciso sull'area di copertura, il che lo rende ideale per le applicazioni rivolte ai clienti in cui si conosce l'area di copertura esatta. Il `zoom` parametro è più adatto per l'analisi geospaziale quando si desidera regolare il livello di dettaglio visualizzato.
## Con raggio
In questo esempio, creerai un'immagine cartografica dello Sri Lanka utilizzando il `radius` parametro con una posizione centrale.
------
#### [ Request URL ]
```
https://maps.geo.eu-central-1.amazonaws.com/v2/static/map?style=Satellite&width=700&height=700¢er=80.60596,7.76671&radius=235000&scale-unit=KilometersMiles&key=API_KEY
```
------
#### [ Response image ]
![\[Satellite view of Sri Lanka, showing the teardrop-shaped island nation surrounded by ocean.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/static-radius.png)
------
## Con zoom
In questo esempio, creerai un'immagine cartografica dello Sri Lanka utilizzando il `zoom` parametro con una posizione centrale.
------
#### [ Request URL ]
```
https://maps.geo.eu-central-1.amazonaws.com/v2/static/map?style=Satellite&width=700&height=700&zoom=8¢er=80.60596,7.76671&scale-unit=KilometersMiles&key=API_KEY
```
------
#### [ Response image ]
![\[Satellite view of Sri Lanka, showing the teardrop-shaped island nation surrounded by ocean.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/static-zoom.png)
------
# Come aggiungere una scala per una mappa statica
In questo argomento, imparerai come visualizzare una scala nell'angolo in basso a destra di una mappa statica generata con Amazon Location Service. La bilancia può mostrare una singola unità, ad esempio `Miles` o`Kilometers`, o entrambe le unità, ad esempio `KilometersMiles` o`MilesKilometers`, con un'unità visualizzata in alto e l'altra in basso.
## Aggiungi una scala con una singola unità
In questo esempio, verrà visualizzata una mappa di Helsinki, in Finlandia, con la scala impostata nell'angolo `Kilometers` in basso a destra.
------
#### [ Request URL ]
```
https://maps.geo.eu-central-1.amazonaws.com/v2/static/map?style=Satellite&width=1024&height=1024&zoom=13.5¢er=24.9189564,60.1645772&scale-unit=Kilometers&key=API_KEY
```
------
#### [ Response image ]
![\[Aerial view of a coastal city with dense urban areas, waterways, and islands.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/static-scale-single.png)
------
## Aggiungi la scala con entrambe le unità
In questo esempio, visualizzerai una mappa di Helsinki, Finlandia con entrambi `Kilometers` e `Miles` mostrata sulla scala nell'angolo in basso a destra, con un'unità visualizzata sopra l'altra.
------
#### [ Request URL ]
```
https://maps.geo.eu-central-1.amazonaws.com/v2/static/map?style=Satellite&width=1024&height=1024&zoom=14¢er=24.9189564,60.1645772&scale-unit=KilometersMiles&key=API_KEY
```
------
#### [ Response image ]
![\[Aerial view of a coastal city with dense urban areas, harbors, and islands surrounded by water.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/static-scale-both.png)
------
# Come aggiungere un marker a una mappa statica
In questo argomento, imparerai come aggiungere marker alle mappe statiche generate con Amazon Location Service. Puoi personalizzare l'icona, l'etichetta, la dimensione, il colore e altre opzioni di stile del marker. Ciò consente di evidenziare posizioni specifiche con segnali visivi in linea con lo scopo della mappa.
## Stile dei pennarelli
| Nome | Tipo | Predefinito | Descrizione |
| --- | --- | --- | --- |
| `style` | Stringa | `marker` | Lo stile della geometria Point. Per creare un marker, imposta il valore su `marker` o non includi l'`style`attributo nell'oggetto properties di GeoJSON. |
| `icon` | Stringa | `pin` | Il tipo di icona del marker. I valori disponibili includono: `cp` (cerchio di prossimità)`diamond`,`pin`,`poi`,, `square``triangle`,`bubble`. |
| `label` | Stringa | `` | Il testo da visualizzare in corrispondenza delle coordinate. Per impostare etichette automatiche, utilizza i seguenti valori: `$alpha` (alfabeto latino) o `$num` (numeri arabi). |
| `color` | Colore | Dipende dallo stile | Il colore dell'icona. |
| `outline-color` | Colore | Dipende dallo stile | Il colore del contorno dell'icona. |
| `text-color` | Colore | Dipende dallo stile | Il colore del testo dell'etichetta. |
| `text-outline-color` | Colore | Dipende dallo stile | Il colore del contorno del testo. |
| `outline-width` | Numero intero | `0`(disattivato) | La larghezza del contorno del testo. |
| `size` | Stringa | `medium` | Dimensioni dell'etichetta e dell'icona. Valori disponibili:`small`,`medium`,`large`. |
## Aggiungere un marker a un'immagine della mappa
In questo esempio, posizionerai un indicatore con un'etichetta sull'immagine della mappa di BC Place, Vancouver.
`Geo JSON`:
```
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
-123.11210,
49.2767875
]
},
"properties": {
"color":"#EE4B2B",
"size":"large",
"label":"BC Place, Vancouver",
"text-color":"#0000FF"
}
}
]
}
```
`Compact`:
```
point: -123.11210,49.27678;
label=BC Place, Vancouver;
size=large;
text-color=#0000FF;
color=#EE4B2B
```
------
#### [ Request URL ]
Con l'overlay GeoJSON
```
https://maps.geo.eu-central-1.amazonaws.com/v2/static/map?style=Satellite&width=1024&height=1024&zoom=15&scale-unit=KilometersMiles&geojson-overlay=%7B%22type%22%3A%22FeatureCollection%22,%22features%22%3A%5B%7B%22type%22%3A%22Feature%22,%22properties%22%3A%7B%22color%22%3A%22%23EE4B2B%22,%22size%22%3A%22large%22,%22label%22%3A%22BC%20Place,%20Vancouver%22,%22text-color%22%3A%22%230000FF%22%7D,%22geometry%22%3A%7B%22coordinates%22%3A%5B-123.11210974152168,49.27678753813112%5D,%22type%22%3A%22Point%22%7D%7D%5D%7D&key=API_KEY
```
------
#### [ Response image ]
![\[Aerial view of Vancouver's downtown and harbor, with BC Place stadium marked.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/static-add-marker.png)
------
## Aggiungi più marker a un'immagine della mappa
In questo esempio, aggiungerai degli indicatori per i luoghi imperdibili di Helsinki, in Finlandia, usando le loro coordinate (longitudine, latitudine). Puoi anche applicare il padding per assicurarti che la mappa contenga correttamente tutti i marker.
**Nota**
Il tipo di icona marker disponibile include: `cp` per il cerchio di prossimità,. `diamond, pin, poi, square, triangle, bubble`
`Geo JSON`:
```
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "MultiPoint",
"coordinates": [
[24.9526, 60.1692],
[24.9270, 60.1725],
[24.9226, 60.1826],
[24.9509, 60.1675],
[24.9566, 60.1685],
[24.9457, 60.1674],
[24.9397, 60.1719],
[24.9414, 60.1715],
[24.9387, 60.1720]
]
},
"properties": {
"icon":"diamond",
"label":"$num",
"size":"large",
"text-color":"%23972E2B",
"text-outline-color":"%23FFF",
"text-outline-width":2
}
}
]
}
```
------
#### [ Request URL ]
```
https://maps.geo.eu-central-1.amazonaws.com/v2/static/map?style=Satellite&width=1024&height=1024&padding=150&geojson-overlay=%7B%22type%22%3A%22FeatureCollection%22,%22features%22%3A%5B%7B%22type%22%3A%22Feature%22,%22geometry%22%3A%7B%22type%22%3A%22MultiPoint%22,%22coordinates%22%3A%5B%5B24.9526,60.1692%5D,%5B24.927,60.1725%5D,%5B24.9226,60.1826%5D,%5B24.9509,60.1675%5D,%5B24.9566,60.1685%5D,%5B24.9457,60.1674%5D,%5B24.9397,60.1719%5D,%5B24.9414,60.1715%5D,%5B24.9387,60.172%5D%5D%7D,%22properties%22%3A%7B%22icon%22%3A%22diamond%22,%22label%22%3A%22%24num%22,%22size%22%3A%22large%22,%22text-color%22%3A%22%23972E2B%22,%22text-outline-color%22%3A%22%23FFF%22,%22text-outline-width%22%3A2%7D%7D%5D%7D&key=API_KEY
```
------
#### [ Response image ]
![\[Aerial view of a city with lakes, buildings, roads, and numbered markers indicating points of interest.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/static-add-multi-markers.png)
------
## Cambia il colore del marker in un'immagine della mappa
In questo esempio, utilizzerai marcatori a bolle di diversi colori per rappresentare le città di tutto il mondo. È possibile personalizzare il colore, l'etichetta e altre proprietà del marker per adattarli al contesto della mappa.
`Geo JSON`:
```
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [85.1376, 25.5941]
},
"properties": {
"label": "Patna",
"icon": "bubble",
"color": "#FF5722",
"outline-color": "#D74D3D",
"text-color": "#FFFFFF"
}
},
.....redacted.....
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [2.3522, 48.8566]
},
"properties": {
"label": "Paris, France",
"icon": "bubble",
"color": "#FF9800",
"outline-color": "#D76B0B",
"text-color": "#FFFFFF"
}
}
]
}
```
------
#### [ Request URL ]
```
https://maps.geo.eu-central-1.amazonaws.com/v2/static/map?style=Satellite&width=1400&height=1024&padding=150&geojson-overlay=%7B%22type%22%3A%22FeatureCollection%22,%22features%22%3A%5B%7B%22type%22%3A%22Feature%22,%22geometry%22%3A%7B%22type%22%3A%22Point%22,%22coordinates%22%3A%5B85.1376,25.5941%5D%7D,%22properties%22%3A%7B%22label%22%3A%22Patna%22,%22icon%22%3A%22bubble%22,%22color%22%3A%22%23FF5722%22,%22outline-color%22%3A%22%23D74D3D%22,%22text-color%22%3A%22%23FFFFFF%22%7D%7D,%7B%22type%22%3A%22Feature%22,%22geometry%22%3A%7B%22type%22%3A%22Point%22,%22coordinates%22%3A%5B105.8542,21.0285%5D%7D,%22properties%22%3A%7B%22label%22%3A%22Hanoi,%20Vietnam%22,%22icon%22%3A%22bubble%22,%22color%22%3A%22%232196F3%22,%22outline-color%22%3A%22%231A78C2%22,%22text-color%22%3A%22%23FFFFFF%22%7D%7D,%7B%22type%22%3A%22Feature%22,%22geometry%22%3A%7B%22type%22%3A%22Point%22,%22coordinates%22%3A%5B116.4074,39.9042%5D%7D,%22properties%22%3A%7B%22label%22%3A%22Beijing,%20China%22,%22icon%22%3A%22bubble%22,%22color%22%3A%22%23FF9800%22,%22outline-color%22%3A%22%23D76B0B%22,%22text-color%22%3A%22%23FFFFFF%22%7D%7D,%7B%22type%22%3A%22Feature%22,%22geometry%22%3A%7B%22type%22%3A%22Point%22,%22coordinates%22%3A%5B106.9101,47.918%5D%7D,%22properties%22%3A%7B%22label%22%3A%22Ulaanbaatar,%20Mongolia%22,%22icon%22%3A%22bubble%22,%22color%22%3A%22%239C27B0%22,%22outline-color%22%3A%22%237B1FA2%22,%22text-color%22%3A%22%23FFFFFF%22%7D%7D,%7B%22type%22%3A%22Feature%22,%22geometry%22%3A%7B%22type%22%3A%22Point%22,%22coordinates%22%3A%5B151.2093,-33.8688%5D%7D,%22properties%22%3A%7B%22label%22%3A%22Sydney,%20Australia%22,%22icon%22%3A%22bubble%22,%22color%22%3A%22%234CAF50%22,%22outline-color%22%3A%22%23388E3C%22,%22text-color%22%3A%22%23FFFFFF%22%7D%7D,%7B%22type%22%3A%22Feature%22,%22geometry%22%3A%7B%22type%22%3A%22Point%22,%22coordinates%22%3A%5B174.7633,-41.2865%5D%7D,%22properties%22%3A%7B%22label%22%3A%22Wellington,%20New%20Zealand%22,%22icon%22%3A%22bubble%22,%22color%22%3A%22%23FFC107%22,%22outline-color%22%3A%22%23FFA000%22,%22text-color%22%3A%22%23000000%22%7D%7D%5D%7D&key=API_KEY
```
------
#### [ Response image ]
![\[World map showing locations of major cities across continents with colored labels.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/static-change-marker-color.png)
------
# Come aggiungere una linea a una mappa statica
In questo argomento, imparerai come aggiungere una linea a una mappa statica utilizzando Amazon Location Service. Tratteremo le opzioni di stile supportate, come definire una linea utilizzando GeoJSON e come applicare stili personalizzati come colore, larghezza e contorno. Esploreremo anche come utilizzare diverse unità di misura per proprietà come la larghezza della linea.
## Stile supportato
| Nome | Tipo | Predefinito | Descrizione |
| --- | --- | --- | --- |
| `color` | Colore | dipende dallo stile | Il colore della linea. |
| `width` | Intero/Stringa | 2 | La larghezza della linea. Per ulteriori informazioni, consulta [Come aggiungere una linea a una mappa statica](#how-to-add-line-static). |
| `outline-color` | Colore | dipende dallo stile | Il colore del contorno della linea. |
| `outline-width` | Intero/Stringa | 0 (disattivato) | La larghezza del contorno. Per ulteriori informazioni, consulta [Come aggiungere una linea a una mappa statica](#how-to-add-line-static). |
## Unità supportata
| Unità | Descrizione |
| --- | --- |
| Numero intero, ad esempio `5` | Pixel |
| Stringa senza unità, ad esempio `"5"` | Pixel |
| `"px"` | Pixel |
| `"m"` | Metri |
| `"km"` | Chilometri |
| `"mi"` | Chilometri |
| `"ft"` | Piedi |
| `"yd"` | Iarde |
| `"%"` | La percentuale del valore predefinito per una proprietà specifica, in pixel. Ad esempio, se il valore predefinito per `width` è `2` pixel, allora `200%` è `4` pixel. `%`è un carattere sensibile che deve essere codificato nell'URL della richiesta come`%25`. |
## Aggiungi una riga
In questo esempio, aggiungerai una linea da un luogo di Vancouver a Stanley Park. La linea viene creata utilizzando un formato GeoJSON con coordinate definite.
------
#### [ Request ]
```
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "LineString",
"coordinates": [
[-123.11813, 49.28246],
[-123.11967, 49.28347],
[-123.12108, 49.28439],
[-123.12216, 49.28507],
[-123.12688, 49.28812],
[-123.1292, 49.28964],
[-123.13216, 49.2916],
[-123.13424, 49.29291],
[-123.13649, 49.2944],
[-123.13678, 49.29477],
[-123.13649, 49.29569],
[-123.13657, 49.29649],
[-123.13701, 49.29715],
[-123.13584, 49.29847],
[-123.13579, 49.29935],
[-123.13576, 49.30018],
[-123.13574, 49.30097]
]
},
"properties": {
"name": "To Stanley Park",
"description": "An evening walk to Stanley Park."
}
}
]
}
```
------
#### [ Request URL ]
```
https://maps.geo.eu-central-1.amazonaws.com/v2/static/map?style=Satellite&width=1024&height=1024&padding=200&scale-unit=KilometersMiles&geojson-overlay=%7B%22type%22%3A%22FeatureCollection%22,%22features%22%3A%5B%7B%22type%22%3A%22Feature%22,%22geometry%22%3A%7B%22type%22%3A%22LineString%22,%22coordinates%22%3A%5B%5B-123.11813,49.28246%5D,%5B-123.11967,49.28347%5D,%5B-123.12108,49.28439%5D,%5B-123.12216,49.28507%5D,%5B-123.12688,49.28812%5D,%5B-123.1292,49.28964%5D,%5B-123.13216,49.2916%5D,%5B-123.13424,49.29291%5D,%5B-123.13649,49.2944%5D,%5B-123.13678,49.29477%5D,%5B-123.13649,49.29569%5D,%5B-123.13657,49.29649%5D,%5B-123.13701,49.29715%5D,%5B-123.13584,49.29847%5D,%5B-123.13579,49.29935%5D,%5B-123.13576,49.30018%5D,%5B-123.13574,49.30097%5D%5D%7D,%22properties%22%3A%7B%22name%22%3A%22To%20Stanley%20Park%22,%22description%22%3A%22An%20evening%20walk%20to%20Stanley%20Park.%22%7D%7D%5D%7D&key=API_KEY
```
------
#### [ Response image ]
![\[Aerial view of coastal city with dense urban area, marina, and surrounding forests.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/static-add-line.png)
------
## Aggiungi stile alla linea
In questo esempio, applicherete uno stile alla linea aggiunta nell'esempio precedente. Ciò include la definizione del colore, della larghezza, del colore del contorno e della larghezza del contorno della linea per personalizzare l'aspetto visivo della linea sulla mappa.
------
#### [ Request ]
```
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "LineString",
"coordinates": [
[-123.11813, 49.28246],
[-123.11967, 49.28347],
[-123.12108, 49.28439],
[-123.12216, 49.28507],
[-123.12688, 49.28812],
[-123.1292, 49.28964],
[-123.13216, 49.2916],
[-123.13424, 49.29291],
[-123.13649, 49.2944],
[-123.13678, 49.29477],
[-123.13649, 49.29569],
[-123.13657, 49.29649],
[-123.13701, 49.29715],
[-123.13584, 49.29847],
[-123.13579, 49.29935],
[-123.13576, 49.30018],
[-123.13574, 49.30097]
]
},
"properties": {
"color": "#6d34b3",
"width": "9m",
"outline-color": "#a8b9cc",
"outline-width": "2px"
}
}
]
}
```
------
#### [ Request URL ]
```
https://maps.geo.eu-central-1.amazonaws.com/v2/static/map?style=Satellite&width=1024&height=1024&padding=200&scale-unit=KilometersMiles&geojson-overlay=%7B%22type%22%3A%22FeatureCollection%22,%22features%22%3A%5B%7B%22type%22%3A%22Feature%22,%22geometry%22%3A%22LineString%22,%22coordinates%22%3A%5B%5B-123.11813,49.28246%5D,%5B-123.11967,49.28347%5D,%5B-123.12108,49.28439%5D,%5B-123.12216,49.28507%5D,%5B-123.12688,49.28812%5D,%5B-123.1292,49.28964%5D,%5B-123.13216,49.2916%5D,%5B-123.13424,49.29291%5D,%5B-123.13649,49.2944%5D,%5B-123.13678,49.29477%5D,%5B-123.13649,49.29569%5D,%5B-123.13657,49.29649%5D,%5B-123.13701,49.29715%5D,%5B-123.13584,49.29847%5D,%5B-123.13579,49.29935%5D,%5B-123.13576,49.30018%5D,%5B-123.13574,49.30097%5D%5D%7D,%22properties%22%3A%7B%22color%22%3A%22%236d34b3%22,%22width%22%3A%229m%22,%22outline-color%22%3A%22%23a8b9cc%22,%22outline-width%22%3A%222px%22%7D%7D%5D%7D&key=API_KEY
```
------
#### [ Response image ]
![\[Aerial view of coastal city with dense urban area, marina, and surrounding forests.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/static-add-line-styling.png)
------
# Come aggiungere un percorso a una mappa statica
In questo argomento, imparerai come aggiungere un percorso a una mappa statica utilizzando Amazon Location Service. Eseguirai i passaggi per ottenere un percorso utilizzando l' CalculateRoutes API e poi lo visualizzerai su una mappa statica utilizzando GeoJSON e uno stile personalizzato per punti e linee.
## Passaggi per aggiungere un percorso
1. Ottieni percorsi dall'`CalculateRoutes`API. Rimuovi le coordinate che cadono sulla stessa linea retta per ottimizzarle LineString, evitando che la stringa di query raggiunga il limite.
1. Crea un oggetto GeoJSON basato sul set di coordinate ottimizzato.
1. Prendi il primo e l'ultimo punto LineString e aggiungi le geometrie dei punti per contrassegnare le posizioni iniziale e finale.
1. Personalizza i punti e le LineString etichette in base alle tue esigenze aziendali, regolando proprietà come colore, dimensione ed etichette.
## Aggiungi un percorso utilizzando lo stile compatto
In questo esempio, aggiungerai un percorso con punti di inizio e fine alla linea creata in[Come aggiungere una linea a una mappa statica](how-to-add-line-static.md). Il percorso verrà definito con uno stile personalizzato, inclusi colore, dimensione ed etichette per i punti di inizio e fine.
```
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "LineString",
"coordinates": [
[-123.11813, 49.28246],
[-123.11967, 49.28347],
[-123.12108, 49.28439],
[-123.12216, 49.28507],
[-123.12688, 49.28812],
[-123.1292, 49.28964],
[-123.13216, 49.2916],
[-123.13424, 49.29291],
[-123.13649, 49.2944],
[-123.13678, 49.29477],
[-123.13649, 49.29569],
[-123.13657, 49.29649],
[-123.13701, 49.29715],
[-123.13584, 49.29847],
[-123.13579, 49.29935],
[-123.13576, 49.30018],
[-123.13574, 49.30097]
]
},
"properties": {
"color": "#000000",
"width": "20m",
"outline-color": "#a8b9cc",
"outline-width": "2px"
}
},
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [-123.11813, 49.28246]
},
"properties": {
"label": "Pacific Centre",
"icon": "bubble",
"size": "large",
"color": "#34B3A4",
"outline-color": "#006400",
"text-color": "#FFFFFF"
}
},
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [-123.13574, 49.30097]
},
"properties": {
"label": "Stanley Park",
"icon": "bubble",
"size": "large",
"color": "#B3346D",
"outline-color": "#FF0000",
"text-color": "#FFFFFF"
}
}
]
}
```
------
#### [ Request URL ]
```
https://maps.geo.eu-central-1.amazonaws.com/v2/static/map?style=Satellite&width=1024&height=1024&padding=200&scale-unit=KilometersMiles&geojson-overlay=%7B%22type%22%3A%22FeatureCollection%22,%22features%22%3A%5B%7B%22type%22%3A%22Feature%22,%22geometry%22%3A%7B%22type%22%3A%22LineString%22,%22coordinates%22%3A%5B%5B-123.11813,49.28246%5D,%5B-123.11967,49.28347%5D,%5B-123.12108,49.28439%5D,%5B-123.12216,49.28507%5D,%5B-123.12688,49.28812%5D,%5B-123.1292,49.28964%5D,%5B-123.13216,49.2916%5D,%5B-123.13424,49.29291%5D,%5B-123.13649,49.2944%5D,%5B-123.13678,49.29477%5D,%5B-123.13649,49.29569%5D,%5B-123.13657,49.29649%5D,%5B-123.13701,49.29715%5D,%5B-123.13584,49.29847%5D,%5B-123.13579,49.29935%5D,%5B-123.13576,49.30018%5D,%5B-123.13574,49.30097%5D%5D%7D,%22properties%22%3A%7B%22color%22%3A%22%23000000%22,%22width%22%3A%2220m%22,%22outline-color%22%3A%22%23a8b9cc%22,%22outline-width%22%3A%222px%22%7D%7D,%7B%22type%22%3A%22Feature%22,%22geometry%22%3A%22Point%22,%22coordinates%22%3A%5B-123.11813,49.28246%5D%7D,%22properties%22%3A%7B%22label%22%3A%22Pacific%20Centre%22,%22icon%22%3A%22bubble%22,%22size%22%3A%22large%22,%22color%22%3A%22%2334B3A4%22,%22outline-color%22%3A%22%23006400%22,%22text-color%22%3A%22%23FFFFFF%22%7D%7D,%7B%22type%22%3A%22Feature%22,%22geometry%22%3A%22Point%22,%22coordinates%22%3A%5B-123.13574,49.30097%5D%7D,%22properties%22%3A%7B%22label%22%3A%22Stanley%20park%22,%22icon%22%3A%22bubble%22,%22size%22%3A%22large%22,%22color%22%3A%22%23B3346D%22,%22outline-color%22%3A%22%23FF0000%22,%22text-color%22%3A%22%23FFFFFF%22%7D%7D%5D%7D&key=API_KEY
```
------
#### [ Response image ]
![\[Aerial view of Vancouver with Stanley Park and Pacific Centre marked, showing urban layout and coastline.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/static-add-route-compact.png)
------
# Come aggiungere un poligono a una mappa statica
Gli edifici e i luoghi possono essere evidenziati su una mappa designando un poligono attorno ad essi, ad esempio il Pentagono (situato a Washington, D.C.).
## Aggiungi un singolo poligono
In questo esempio, aggiungi un poligono (un pentagono) per l'edificio del Pentagono sulla mappa.
------
#### [ Geo JSON ]
```
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"coordinates": [
[
[
-77.0579282196337,
38.87264268371487
],
[
-77.05868880963534,
38.87003145971428
],
[
-77.05560979468949,
38.86876862025221
],
[
-77.05305311263672,
38.87059509268525
],
[
-77.0546384387842,
38.872985132206225
],
[
-77.0579282196337,
38.87264268371487
]
]
],
"type": "Polygon"
}
}
]
}
```
------
#### [ Request URL ]
```
https://maps.geo.eu-central-1.amazonaws.com/v2/static/map?style=Satellite&width=600&height=1024&padding=200&scale-unit=KilometersMiles&geojson-overlay=%7B%22type%22%3A%22FeatureCollection%22,%22features%22%3A%5B%7B%22type%22%3A%22Feature%22,%22geometry%22%3A%7B%22coordinates%22%3A%5B%5B%5B-77.0579282196337,38.87264268371487%5D,%5B-77.05868880963534,38.87003145971428%5D,%5B-77.05560979468949,38.86876862025221%5D,%5B-77.05305311263672,38.87059509268525%5D,%5B-77.0546384387842,38.872985132206225%5D,%5B-77.0579282196337,38.87264268371487%5D%5D%5D,%22type%22%3A%22Polygon%22%7D%7D%5D%7D&key=your_API_Key
```
------
#### [ Response image ]
![\[Mappa di esempio che mostra un poligono attorno al Pentagono.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/mapsV2/addPolygonStaticMap.png)
------
## Aggiungi un poligono di stile
In questo esempio, ridisegniamo il poligono mostrato nell'esempio precedente. **Disegniamo il poligono in un colore diverso (\$1E3F70550).** I componenti del colore sono i seguenti.
+ **E3** rappresenta il componente rosso.
+ **F7** rappresenta il componente verde.
+ **05** rappresenta il componente blu.
+ **50** rappresenta il componente alfa (opacità).
------
#### [ Geo JSON ]
```
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"coordinates": [
[
[
-77.0579282196337,
38.87264268371487
],
[
-77.05868880963534,
38.87003145971428
],
[
-77.05560979468949,
38.86876862025221
],
[
-77.05305311263672,
38.87059509268525
],
[
-77.0546384387842,
38.872985132206225
],
[
-77.0579282196337,
38.87264268371487
]
]
],
"type": "Polygon"
},
"properties": {
"color": "#E3F70550"
}
}
]
}
```
------
#### [ Request URL ]
```
https://maps.geo.eu-central-1.amazonaws.com/v2/static/map?style=Satellite&width=1024&height=1024&padding=100&scale-unit=KilometersMiles&geojson-overlay=%7B%22type%22%3A%22FeatureCollection%22,%22features%22%3A%5B%7B%22type%22%3A%22Feature%22,%22geometry%22%3A%7B%22coordinates%22%3A%5B%5B%5B-77.0579282196337,38.87264268371487%5D,%5B-77.05868880963534,38.87003145971428%5D,%5B-77.05560979468949,38.86876862025221%5D,%5B-77.05305311263672,38.87059509268525%5D,%5B-77.0546384387842,38.872985132206225%5D,%5B-77.0579282196337,38.87264268371487%5D%5D%5D,%22type%22%3A%22Polygon%22%7D,%22properties%22%3A%7B%22color%22%3A%22%23E3F70550%22%7D%7D%5D%7D&key=your_API_Key
```
------
#### [ Response image ]
![\[Mappa di esempio che mostra un poligono di colore diverso attorno al Pentagono.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/mapsV2/addPolygonStaticMap-color.png)
------
## Aggiungi più poligoni
In questo esempio, aggiungiamo più poligoni, per evidenziare più parchi di New York City.
------
#### [ Geo JSON ]
```
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"color": "#00800050"
},
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
-73.95824708489555,
40.80055774655358
],
[
-73.9818875523859,
40.76810261850716
],
[
-73.9729556303776,
40.7642422333698
],
[
-73.94916953372382,
40.79699323614054
],
[
-73.95824708489555,
40.80055774655358
]
]
]
}
},
{
"type": "Feature",
"properties": {
"color": "#FF000050"
},
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
-73.94432602794981,
40.80634757577718
],
[
-73.94607200977896,
40.803869579741644
],
[
-73.94301654157768,
40.80263972513214
],
[
-73.94127055974795,
40.805099411561145
],
[
-73.94432602794981,
40.80634757577718
]
]
]
}
},
{
"type": "Feature",
"properties": {
"color": "#0000FF50"
},
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
-73.9947948382843,
40.7691390468232
],
[
-73.99564708262241,
40.76802192177411
],
[
-73.99372953286147,
40.76723992306512
],
[
-73.99289367783732,
40.76835706126087
],
[
-73.9947948382843,
40.7691390468232
]
]
]
}
}
]
}
```
------
#### [ Request URL ]
```
https://maps.geo.eu-central-1.amazonaws.com/v2/static/map?style=Satellite&width=1024&height=1024&padding=100&scale-unit=KilometersMiles&geojson-overlay=%7B%22type%22%3A%22FeatureCollection%22,%22features%22%3A%5B%7B%22type%22%3A%22Feature%22,%22properties%22%3A%7B%22color%22%3A%22%2300800050%22%7D,%22geometry%22%3A%7B%22type%22%3A%22Polygon%22,%22coordinates%22%3A%5B%5B%5B-73.95824708489555,40.80055774655358%5D,%5B-73.9818875523859,40.76810261850716%5D,%5B-73.9729556303776,40.7642422333698%5D,%5B-73.94916953372382,40.79699323614054%5D,%5B-73.95824708489555,40.80055774655358%5D%5D%5D%7D%7D,%7B%22type%22%3A%22Feature%22,%22properties%22%3A%7B%22color%22%3A%22%23FF000050%22%7D,%22geometry%22%3A%7B%22type%22%3A%22Polygon%22,%22coordinates%22%3A%5B%5B%5B-73.94432602794981,40.80634757577718%5D,%5B-73.94607200977896,40.803869579741644%5D,%5B-73.94301654157768,40.80263972513214%5D,%5B-73.94127055974795,40.805099411561145%5D,%5B-73.94432602794981,40.80634757577718%5D%5D%5D%7D%7D,%7B%22type%22%3A%22Feature%22,%22properties%22%3A%7B%22color%22%3A%22%230000FF50%22%7D,%22geometry%22%3A%7B%22type%22%3A%22Polygon%22,%22coordinates%22%3A%5B%5B%5B-73.9947948382843,40.7691390468232%5D,%5B-73.99564708262241,40.76802192177411%5D,%5B-73.99372953286147,40.76723992306512%5D,%5B-73.99289367783732,40.76835706126087%5D,%5B-73.9947948382843,40.7691390468232%5D%5D%5D%7D%7D%5D%7D&key=your_API_Key
```
------
#### [ Response image ]
![\[Mappa di esempio che mostra più poligoni attorno ai parchi di New York.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/mapsV2/addPolygonStaticMap-multiple.png)
------
# Come impostare la lingua per le mappe statiche
È possibile impostare la lingua per una mappa statica, nel caso in cui non si desideri utilizzare la lingua predefinita.
In questo esempio, viene richiesta in inglese una località a Tokyo, che generalmente utilizza come impostazione predefinita il testo giapponese, sovrascrivendo l'impostazione predefinita regionale.
L'esempio mostra l'immagine di risposta a una richiesta in cui viene fornita la lingua e una in cui non viene fornita la lingua. Le etichette corrispondenti riflettono la differenza tra una mappa che mostra la lingua richiesta e una mappa che mostra la lingua predefinita.
------
#### [ Request URL - English set as the language ]
```
https://maps.geo.us-east-1.amazonaws.com/v2/static/map?center=139.4575,35.539&style=Standard&lang=en&height=700&width=700&zoom=14
```
------
#### [ Response image ]
![\[Mappa di esempio che mostra un poligono attorno al Pentagono.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/mapsV2/setLanguageEnglishStaticMap.png)
------
------
#### [ Request URL - default language ]
```
https://maps.geo.us-east-1.amazonaws.com/v2/static/map?center=139.4575,35.539&style=Standard&height=700&width=700&zoom=14
```
------
#### [ Response image ]
![\[Mappa di esempio che mostra un poligono attorno al Pentagono.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/mapsV2/setLanguageDefaultStaticMap.png)
------
# Come aggiungere un cerchio di prossimità a una mappa statica
I cerchi di prossimità offrono informazioni importanti sull'accuratezza di un dispositivo o della posizione dell'utente segnalati o stimati. Mostrando un cerchio attorno al punto segnalato, gli utenti vengono informati che la posizione effettiva potrebbe ricadere ovunque all'interno del cerchio, a causa di vari fattori che influiscono sulla precisione del posizionamento. Questa maggiore chiarezza aiuta a prendere decisioni e migliora la sicurezza della navigazione.
In questo esempio, aggiungi un cerchio di prossimità di 500 metri vicino alla Torre Eiffel a Parigi.
------
#### [ Request ]
```
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
2.298151,
48.855921
]
},
"properties": {
"style": "circle",
"color": "#007BFF50",
"width": "500m"
}
},
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
2.298151,
48.855921
]
},
"properties": {
"icon": "cp",
"color": "#007BFF",
"text-color":"#DC3545",
"text-outline-color":"#007BFF",
"outline-width":"20px",
"label": "You are here",
"size": "large"
}
}
]
}
```
------
#### [ Request URL ]
```
https://maps.geo.eu-central-1.amazonaws.com/v2/static/map@2x?style=Satellite&width=700&height=700&zoom=17¢er=2.2958,48.8570&geojson-overlay=%7B%20%20%22type%22%3A%20%22FeatureCollection%22,%20%20%22features%22%3A%20%5B%20%20%20%20%7B%20%20%20%20%20%20%22type%22%3A%20%22Feature%22,%20%20%20%20%20%20%22geometry%22%3A%20%7B%20%20%20%20%20%20%20%20%22type%22%3A%20%22Point%22,%20%20%20%20%20%20%20%20%22coordinates%22%3A%20%5B%20%20%20%20%20%20%20%20%20%202.298151,%20%20%20%20%20%20%20%20%20%2048.855921%20%20%20%20%20%20%20%20%5D%20%20%20%20%20%20%7D,%20%20%20%20%20%20%22properties%22%3A%20%7B%20%20%20%20%20%20%20%20%22style%22%3A%20%22circle%22,%20%20%20%20%20%20%20%20%22color%22%3A%20%22%23007BFF50%22,%20%20%20%20%20%20%20%20%22width%22%3A%20%22500m%22%20%20%20%20%20%20%7D%20%20%20%20%7D,%20%20%20%20%7B%20%20%20%20%20%20%22type%22%3A%20%22Feature%22,%20%20%20%20%20%20%22geometry%22%3A%20%7B%20%20%20%20%20%20%20%20%22type%22%3A%20%22Point%22,%20%20%20%20%20%20%20%20%22coordinates%22%3A%20%5B%20%20%20%20%20%20%20%20%20%202.298151,%20%20%20%20%20%20%20%20%20%2048.855921%20%20%20%20%20%20%20%20%5D%20%20%20%20%20%20%7D,%20%20%20%20%20%20%22properties%22%3A%20%7B%20%20%20%20%20%20%20%20%22icon%22%3A%20%22cp%22,%20%20%20%20%20%20%20%20%22color%22%3A%20%22%23007BFF%22,%20%20%20%20%20%20%20%20%22text-color%22%3A%22%23DC3545%22,%20%20%20%20%20%20%20%20%22text-outline-color%22%3A%22%23007BFF%22,%20%20%20%20%20%20%20%20%22outline-width%22%3A%2220px%22,%20%20%20%20%20%20%20%20%22label%22%3A%20%22You%20are%20here%22,%20%20%20%20%20%20%20%20%22size%22%3A%20%22large%22%20%20%20%20%20%20%7D%20%20%20%20%7D%20%20%5D%7D&key=your_API_Key
```
------
#### [ Response image ]
![\[Mappa di esempio che mostra un cerchio di prossimità attorno alla Torre Eiffel.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/mapsV2/addPproximityCircleStaticMap.png)
------