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 **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 + **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 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 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. # Personalizza mappe statiche **Nota** Le mappe statiche supportano solo lo stile Satellite. Per ulteriori informazioni, consulta [AWS stili e caratteristiche delle mappe](map-styles.md). Questa sezione fornisce una panoramica su come personalizzare le mappe statiche generate utilizzando Amazon Location Service. Tratta varie funzionalità, come la regolazione della posizione, delle dimensioni, della lingua, della scala, delle sovrapposizioni e dell'attribuzione della mappa, consentendoti di personalizzare la mappa in base alle tue esigenze specifiche. 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*. ## Position La posizione consente di definire il centro e i confini della mappa. È possibile controllare la messa a fuoco della mappa impostando le coordinate centrali, un riquadro di delimitazione o utilizzando un livello di zoom per determinare l'area da visualizzare. Per scoprire come funziona, consulta[Come ottenere una mappa statica di una posizione specifica](get-static-map-specific-position.md). + `Center`: definisce il punto centrale della mappa utilizzando le coordinate di longitudine e latitudine. + `Radius`: specifica il raggio (distanza dal centro) che verrà visualizzato sulla mappa statica. + `Bounding Box`: Definisce un'area rettangolare della mappa, impostata fornendo le coordinate degli angoli superiore sinistro e inferiore destro. + `Zoom`: controlla il livello di zoom della mappa. Livelli di zoom più alti mostrano maggiori dettagli in un'area più piccola, mentre livelli di zoom inferiori mostrano meno dettagli su un'area più ampia. ## Dimensioni e qualità È possibile personalizzare le dimensioni e la qualità visiva della mappa statica definendone le dimensioni (altezza e larghezza) e aggiungendo un'imbottitura per una migliore presentazione dei marker e di altri elementi. Per sapere come funziona, consulta. [Come ottenere una mappa statica di una dimensione specifica](get-static-map-specific-dimension.md) + `Height and Width`: specifica la dimensione dell'immagine statica della mappa definendone l'altezza e la larghezza in pixel. + `Padding`: aggiunge ulteriore spazio attorno ai bordi della mappa, permettendo una migliore visualizzazione quando si posizionano indicatori, linee o forme. ## Dimensionare La scala consente di controllare la scala della mappa e definisce le unità (chilometri, miglia) per misurare le distanze. Ciò è utile per rappresentare accuratamente le relazioni tra dimensioni e distanza della mappa. Per sapere come funziona, vedi[Come aggiungere una scala per una mappa statica](add-scale-static-map.md). + `Scale Unit`: definisce le unità per la barra di scala della mappa (ad esempio, chilometri o miglia), permettendo agli utenti di misurare con precisione le distanze sulla mappa. ## Sovrapposizione Puoi aggiungere marcatori, linee per mostrare percorsi, poligoni per mostrare aree e altro ancora. Per scoprire come funziona, consulta[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) o. [Come aggiungere un percorso a una mappa statica](how-to-add-route.md) # Sovrapposizione sulla mappa statica Questa sezione spiega come sovrapporre informazioni aggiuntive su mappe statiche utilizzando Amazon Location Service. Puoi personalizzare le tue mappe statiche aggiungendo varie caratteristiche geografiche, come punti, linee e poligoni, per migliorare la rappresentazione visiva della mappa. Amazon Location Service supporta diversi formati, tra cui GeoJSON e un formato di overlay compatto, per fornire modi flessibili ed efficienti per aggiungere sovrapposizioni. 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*. ## Con GeoJSON GeoJSON è un formato versatile che consente di sovrapporre dati personalizzati su mappe statiche. Definendo caratteristiche geografiche come punti, linee e poligoni, puoi migliorare la rappresentazione visiva delle tue mappe, fornendo un contesto prezioso per gli utenti. GeoJSON è ampiamente supportato e offre flessibilità per quanto riguarda lo stile e la personalizzazione delle sovrapposizioni di mappe, rendendolo un formato ideale per visualizzare regioni, tracciare percorsi o mostrare relazioni spaziali. Con Amazon Location Service, puoi sfruttare GeoJSON per aggiungere funzionalità dinamiche basate sulla posizione direttamente sulle tue mappe statiche. Ciò ti consente di creare sovrapposizioni altamente personalizzabili che possono essere personalizzate per soddisfare le tue esigenze aziendali specifiche. GeoJSON supporta diversi tipi di geometria, `Point` tra cui `LineString``Polygon`, `MultiPolygon` e consente di visualizzare un'ampia gamma di funzionalità, da marker e percorsi a rappresentazioni di aree complesse. ## Colori Quando si progettano le funzionalità di GeoJSON, si ha la flessibilità nella definizione dei colori. È possibile specificare i colori utilizzando diversi formati, come valori esadecimali (come \$1ff0000 per il rosso) o con trasparenza alfa (come \$1ff000080 per il rosso semitrasparente). Ciò garantisce che le sovrapposizioni possano essere visivamente coerenti con lo stile della mappa. Se non viene specificato alcun colore, verrà applicato il colore predefinito per lo stile di mappa selezionato. ## Ordine di disegno Le sovrapposizioni personalizzate vengono disegnate in un ordine specifico per mantenere la chiarezza ed evitare il disordine visivo. In Amazon Location Service, le funzionalità di sovrapposizione come poligoni, linee e punti verranno visualizzate sopra la mappa di base, ma sotto le etichette della mappa. L'ordine di disegno dà priorità prima ai poligoni, seguiti dalle linee e poi dai punti o dai marcatori. ## Unità di misura Per proprietà come `width` e`outline-width`, puoi utilizzare diverse unità di misura per specificare le dimensioni, tra cui pixel (px), metri (m), chilometri (km), miglia (mi) e percentuali (%). L'unità percentuale regola la proprietà rispetto a un valore predefinito, offrendo maggiore flessibilità nello stile delle sovrapposizioni. ## Tipi di geometria Amazon Location Service supporta diversi tipi di geometria GeoJSON, ad esempio,, `Point` e`LineString`. `Polygon` `MultiPolygon` Ogni tipo di geometria può essere stilizzato e regolato utilizzando l'oggetto delle proprietà in GeoJSON, che consente un'ampia personalizzazione di marker, percorsi e aree sulla mappa. ## Con rivestimento compatto **Nota** La sovrapposizione compatta supporta i seguenti tipi di geometria: punto, linea e poligono. Non supporta`multiPoint`, o. `multiLine` `multiPolgyon` L'opzione di sovrapposizione compatta consente di visualizzare in modo efficiente più geometrie su una mappa statica utilizzando un singolo parametro di interrogazione. Questo approccio semplificato semplifica il formato della richiesta e riduce le dimensioni della richiesta, facilitando la trasmissione dei dati di sovrapposizione. I clienti possono inserire vari tipi di geometria e le proprietà di stile corrispondenti in un unico parametro di query e Amazon Location Service si occuperà di tutto il lavoro analizzando e renderizzando l'overlay come specificato. Durante l'utilizzo del formato di sovrapposizione compatto, tieni presente che esistono dei limiti alla dimensione dell'URL della richiesta. Sebbene Amazon Location Service ottimizzi la query, assicurati che la tua richiesta rimanga entro limiti ragionevoli, specialmente quando si tratta di più geometrie e delle proprietà associate. ## Formato Il formato di sovrapposizione compatto è strutturato come segue: `geometry_type:geometry;property_1=value_1;property_2=value_2|geometry_type:geometry;property_1=value_1...` Ogni tipo di geometria è definito insieme alle relative proprietà di stile. Più geometrie sono separate da un operatore di tubo (\$1) e le proprietà per ogni geometria sono separate mediante un punto e virgola. ## Tipi di geometria supportati Amazon Location Service supporta diversi tipi di geometria, tra cui `Point``MultiPoint`,, `LineString``Polygon`, e`MultiPolygon`. Questi tipi di geometria possono essere combinati e modellati all'interno dello stesso parametro di query utilizzando il formato di sovrapposizione compatto. ## Proprietà di stile Ogni geometria può essere personalizzata utilizzando varie proprietà di stile, come colore, colore del contorno, dimensione e altro. Queste proprietà consentono di controllare l'aspetto di ogni geometria sulla mappa, assicurando che la sovrapposizione sia in linea con i requisiti aziendali.