

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

# Pannello Geomap
<a name="v9-panels-geomap"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 9.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 10.x di Grafana, vedere. [Funzionamento nella versione 10 di Grafana](using-grafana-v10.md)  
Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md)

La visualizzazione del pannello Geomap consente di visualizzare e personalizzare la mappa del mondo utilizzando dati geospaziali. Puoi configurare vari stili di sovrapposizione e impostazioni di visualizzazione della mappa per concentrarti facilmente sulle importanti caratteristiche dei dati basate sulla posizione.

## Vista mappa
<a name="v9-panels-geomap-view"></a>

La visualizzazione della mappa controlla la visualizzazione iniziale della mappa quando viene caricata la dashboard.

**Vista iniziale**

La vista iniziale configura il modo in cui il GeoMap pannello viene renderizzato quando il pannello viene caricato per la prima volta.
+ La **visualizzazione** imposta il centro della mappa quando il pannello viene caricato per la prima volta.
  + **Adatta ai dati** si adatta alla visualizzazione della mappa in base alle estensioni dei dati dei livelli della mappa e si aggiorna quando i dati cambiano.
    + L'opzione **Data** consente di selezionare l'estensione in base ai dati di «Tutti i livelli», un singolo «Livello» o «Ultimo valore» di un livello selezionato.
    + Il **livello** può essere selezionato se si adattano i dati da un singolo «Livello» o dall' «Ultimo valore» di un livello.
    + Il **riempimento** imposta il riempimento in percentuale relativa oltre all'estensione dei dati (non disponibile solo se si considera «Ultimo valore»).
    + **Max Zoom** imposta il livello di zoom massimo durante l'adattamento dei dati.
  + **Coordinates** imposta la visualizzazione della mappa in base a:
    + **Latitudine**
    + **Longitudine**
  + Sono disponibili anche viste predefinite, tra cui:
    + **(0°, 0°)**
    + **Nord America**
    + **Sud America**
    + **Europa**
    + **Africa**
    + **Asia occidentale**
    + **Asia meridionale**
    + **Sud-est asiatico**
    + **Asia orientale**
    + **Australia**
    + **Oceania**
+ **Zoom** imposta il livello di zoom iniziale.

## Livelli della mappa
<a name="v9-panels-geomap-layers"></a>

La visualizzazione Geomap supporta la visualizzazione di più livelli. Ogni livello determina il modo in cui vengono visualizzati i dati geospaziali sulla parte superiore della mappa di base.

**Tipi**

Nella visualizzazione Geomap sono disponibili tre tipi di layer cartografici tra cui scegliere.
+ [Layer di marker](#v9-panels-geomap-markers)esegue il rendering di un marker in ogni punto dati.
+ [Livello di mappa termica](#v9-panels-geomap-heatmap)visualizza una mappa termica dei dati.
+ [Strato GeoJSON](#v9-panels-geomap-geojson)esegue il rendering di dati statici da un file GeoJSON.

Esistono anche cinque tipi di layer attualmente in versione alfa.
+ [Livello notte/giorno (alfa)](#v9-panels-geomap-nightday)esegue il rendering di una regione notturna o diurna.
+ L'**icona all'ultimo punto (alfa)** esegue il rendering di un'icona nell'ultimo punto dati.
+ **Dynamic GeoJSON (alpha) definisce** lo stile di un file GeoJSON in base ai risultati delle query.
+ **Route (alpha)** esegue il rendering dei punti dati come percorso.
+ [Livello di foto (Alpha)](#v9-panels-geomap-photos)esegue il rendering di una foto in ogni punto dati.

**Controlli di livello**

I controlli dei livelli consentono di creare livelli, cambiarne il nome, riordinare ed eliminare i livelli.
+ **Aggiungi livello** crea un livello di dati aggiuntivo e configurabile per la visualizzazione Geomap. Quando aggiungi un livello, ti viene richiesto di selezionare un tipo di livello. È possibile modificare il tipo di livello in qualsiasi momento durante la configurazione del pannello. Consultate la precedente sezione **Tipi di livello** per i dettagli su ciascun tipo di livello.
+ I controlli dei livelli consentono di rinominare, eliminare e riordinare i livelli del pannello.
  + **Modifica il nome del livello** (icona a forma di matita) rinomina il livello.
  + **Trash Bin** elimina il livello.
  + **Reorder** (sei punti/maniglia) consente di modificare l'ordine dei livelli. I dati sui livelli superiori verranno visualizzati sopra i dati sui livelli inferiori. Il pannello aggiornerà l'ordine dei livelli durante il trascinamento per semplificare la scelta di un ordine dei livelli.

Puoi aggiungere più livelli di dati a un singolo pannello Geomap per creare visualizzazioni ricche e dettagliate.

**Location (Ubicazione)**

Il pannello Geomap necessita di una fonte di dati geografici. Questi dati provengono da una query del database e sono disponibili quattro opzioni di mappatura per i dati.
+ Ricerca **automaticamente** i dati sulla posizione. Utilizzate questa opzione quando la ricerca si basa su uno dei seguenti nomi per i campi dati.
  + geohash: «geohash»
  + latitudine: «latitudine», «lat»
  + longitudine: «longitudine», «lng», «lon»
  + lookup: «cerca»
+ **Coords** specifica che la tua query contiene dati di coordinate. Ti verrà richiesto di selezionare i campi di dati numerici per latitudine e longitudine dalla query del database.
+ **Geohash specifica che la tua query contiene dati geohash**. Ti verrà richiesto di selezionare un campo di dati di tipo stringa per il geohash dalla query del database.
+ La **ricerca** specifica che la query contiene i dati del nome della posizione che devono essere mappati su un valore. Ti verrà richiesto di selezionare il campo di ricerca dalla query del database e da un dizionario geografico. Il gazetteer è la directory utilizzata per mappare i dati richiesti su un punto geografico.

## Layer di marker
<a name="v9-panels-geomap-markers"></a>

Il livello marker consente di visualizzare i punti dati sotto forma di marker di diverse forme, ad esempio cerchi, quadrati, triangoli, stelle e altro.

I marker hanno molte opzioni di personalizzazione.
+ **Marker Color configura il colore** del marker. L'impostazione predefinita `Single color` mantiene tutti i punti di un unico colore. Esiste un'opzione alternativa per avere più colori a seconda dei valori dei punti dati e della soglia impostata nella `Thresholds` sezione.
+ **Marker Size** configura la dimensione del marker. L'impostazione predefinita è `Fixed size` che rende tutte le dimensioni dei marker uguali indipendentemente dai punti dati. Tuttavia, esiste anche un'opzione per ridimensionare i cerchi in base ai punti dati corrispondenti. `Min`e la dimensione del `Max` marker deve essere impostata in modo tale che il livello Marker possa scalare all'interno di questo intervallo.
+ **Marker Shape** consente di scegliere la forma, l'icona o l'elemento grafico per contribuire a fornire un contesto visivo aggiuntivo ai dati. Scegli tra le risorse incluse in Grafana, come forme semplici o la libreria Unicon. Puoi anche specificare un URL contenente una risorsa di immagini. L'immagine deve essere una grafica vettoriale scalabile (SVG).
+ **L'opacità di riempimento configura la trasparenza** di ogni marker.

## Livello di mappa termica
<a name="v9-panels-geomap-heatmap"></a>

Il livello di mappa termica raggruppa vari punti dati per visualizzare posizioni con densità diverse. Per aggiungere un livello di mappa termica:

Fai clic sul menu a discesa sotto Data Layer e scegli. `Heatmap`

Analogamente`Markers`, ti vengono richieste le opzioni per determinare quali punti dati visualizzare e come desideri visualizzarli.
+ **I valori di peso** configurano l'intensità dei cluster della mappa termica. `Fixed value`mantiene un valore di peso costante in tutti i punti dati. Questo valore deve essere compreso tra 0 e 1. Analogamente a Markers, esiste un'opzione alternativa nel menu a discesa per ridimensionare automaticamente i valori di peso in base ai valori dei dati.
+ **Radius** configura la dimensione dei cluster di mappe termiche.
+ **Blur** configura la quantità di sfocatura su ogni cluster.

## Strato GeoJSON
<a name="v9-panels-geomap-geojson"></a>

Il livello GeoJSON consente di selezionare e caricare un file GeoJSON statico dal filesystem.
+ **GeoJSON** URL offre una scelta di file GeoJSON forniti con Grafana.
+ **Lo stile predefinito** controlla gli stili da applicare quando nessuna delle regole precedenti corrisponde.
  + **Il colore** configura il colore dello stile predefinito
  + **L'opacità configura l'opacità** predefinita
+ **Le regole di stile** applicano gli stili in base alle proprietà delle caratteristiche
  + La **regola** consente di selezionare una *caratteristica*, una *condizione* e un *valore* dal file GeoJSON per definire una regola. L'icona del cestino può essere utilizzata per eliminare la regola corrente.
  + **Il colore** configura il colore dello stile per la regola corrente
  + **L'opacità** configura il livello di trasparenza per la regola corrente
+ **Aggiungi regola di stile crea regole** di stile aggiuntive.

## Strato CARTO
<a name="v9-panels-geomap-carto"></a>

Un livello CARTO proviene dalle mappe di base [CARTO Raster](https://carto.com/about-us/).

**Opzioni**
+ **Tema**

   Scegli un tema, un tema **chiaro**, un tema **scuro** o un tema **automatico**.
+ **Mostra etichette** mostra i dettagli del Paese nella parte superiore della mappa.
+ **Opacità** da 0 (trasparente) a 1 (opaco)

## Strato di piastrelle XYZ
<a name="v9-panels-geomap-xyz"></a>

Il tile layer XYZ è una mappa di un tile layer generico.

**Nota**  
Per ulteriori informazioni sui tile layer generici, vedere [Tiled Web Maps](https://en.wikipedia.org/wiki/Tiled_web_map) e [List of Open Street Map Tile](https://wiki.openstreetmap.org/wiki/Tile_servers) Servers.

**Opzioni**
+ **Modello di URL**
**Nota**  
Imposta un URL di tile server valido, con \$1z\$1/\$1x\$1/\$1y\$1 ad esempio:`https://tile.openstreetmap.org/{z}/{x}/{y}.png`.
+ L'**attribuzione** imposta la stringa di riferimento per il layer, se visualizzata nei controlli della [mappa](#v9-panels-geomap-controls)
+ **Opacità** da 0 (trasparente) a 1 (opaco)

## Apri il livello Street Map
<a name="v9-panels-geomap-osm"></a>

Una mappa tratta da [Open Street Map](https://www.openstreetmap.org/about), un database mondiale geografico collaborativo e gratuito.

**Opzioni**
+ **Opacità** da 0 (trasparente) a 1 (opaco)

## Livello ArcGIS
<a name="v9-panels-geomap-arcgis"></a>

[Un layer [ArcGIS è](https://services.arcgisonline.com/arcgis/rest/services) un layer proveniente da un ESRI ArcGIS.](https://www.esri.com/en-us/about/about-esri/overview) MapServer

**Opzioni**
+ **Istanza del server** da selezionare tra i seguenti tipi di mappa.
  + Mappa stradale mondiale
  + Immagini del mondo
  + Mondo fisico
  + Topografico
  + Topografica USA
  + Oceano mondiale
  + Personalizzato MapServer (vedi [XYZ](#v9-panels-geomap-xyz) per la formattazione)
    + Modello di URL
    + Attribuzione
+ **Opacità** da 0 (trasparente) a 1 (opaco)

## Livello notte/giorno (alfa)
<a name="v9-panels-geomap-nightday"></a>

Il livello Notte/Giorno mostra le regioni diurne e notturne in base all'intervallo di tempo corrente.

**Nota**  
Per ulteriori informazioni, [consultate Estensioni per OpenLayers - DayNight](https://viglino.github.io/ol-ext/examples/layer/map.daynight.html).

**Opzioni**
+ **Mostra** alterna la sorgente temporale dall'intervallo temporale del pannello
+ **Colore della regione notturna: seleziona il colore** per la regione notturna
+ **Display sun** alterna l'icona del sole
+ **Opacità** da 0 (trasparente) a 1 (opaco)

## Livello di foto (Alpha)
<a name="v9-panels-geomap-photos"></a>

Il livello Foto esegue il rendering di una foto in ogni punto dati.

**Nota**  
Per ulteriori informazioni, [consultate Estensioni per OpenLayers - Image Photo Style](http://viglino.github.io/ol-ext/examples/style/map.style.photo.html).

**Opzioni**
+ **Campo di origine dell'immagine**

  Seleziona un campo stringa contenente dati di immagine in uno dei seguenti formati:
  + **Immagine URLs**
  + Immagine binaria **codificata Base64** () `data:image/png;base64,…`
+ **Tipo**

   seleziona lo stile della cornice attorno alle immagini
  + **Square**
  + **Circle** (Cerchio)
  + **Ancorato**
  + **Folio**
+ Attiva l'opzione **Ritaglia** se le immagini vengono ritagliate per adattarle
+ **Shadow**: attiva un riquadro (ombra) dietro le immagini
+ **Bordo**: imposta la dimensione del bordo attorno alle immagini
+ **Colore del bordo** imposta il colore del bordo attorno alle immagini
+ **Raggio**: imposta la dimensione complessiva delle immagini in pixel

## Controlli della mappa
<a name="v9-panels-geomap-controls"></a>

L'interfaccia dei controlli della mappa contiene le seguenti opzioni per le informazioni sulla mappa e le sovrapposizioni degli strumenti.

**Zoom**

Questa sezione descrive ciascuno dei controlli dello zoom.

*Mostra il controllo dello zoom*

Visualizza i controlli dello zoom nell'angolo superiore sinistro.

*Zoom con rotella del mouse*

Attiva o disattiva utilizzando la rotellina del mouse per ingrandire o ridurre.

**Mostra attribuzione**

Visualizza l'attribuzione per i layer della mappa di base sulla mappa.

**Mostra scala**

Visualizza le informazioni sulla scala nell'angolo inferiore sinistro.

**Nota**  
Visualizza le unità in [m]/[km].

**Mostra gli strumenti di misura**

Visualizza gli strumenti di misura nell'angolo superiore destro. Le misurazioni vengono visualizzate solo quando questo controllo è aperto.
+ **Fare clic** per iniziare a misurare
+ **Continua a fare clic** per continuare la misurazione
+ **Fate doppio clic** per terminare la misurazione

**Nota**  
Quando si modifica il tipo o le unità di misura, la misurazione precedente viene rimossa dalla mappa.  
Se il controllo viene chiuso e poi riaperto, viene visualizzata la misurazione più recente.  
Una misurazione può essere modificata facendo clic su di essa e trascinandola.

*Lunghezza*

Calcola la lunghezza sferica di una geometria. Questa lunghezza è la somma delle grandi distanze circolari tra le coordinate. Per le geometrie costituite da più parti, la lunghezza è la somma della lunghezza di ogni parte. Si presume che le geometrie siano in 'EPSG:3857'.

È possibile scegliere le seguenti unità per le misurazioni della lunghezza:
+ **Metrico (m/km)**
+ **Piedi (ft)**
+ **Miglia (mi)**
+ **Miglia nautiche (nmi)**

*Area*

Ottieni l'area sferica di una geometria. Quest'area viene calcolata supponendo che i bordi del poligono siano segmenti di grandi cerchi su una sfera. Si presume che le geometrie siano in 'EPSG:3857'.

È possibile scegliere le seguenti unità per la misurazione dell'area:
+ **Metri quadrati (m²)**
+ **Chilometri quadrati (km²)**
+ **Piedi quadrati (ft²)**
+ **Miglia quadrate (mi²)**
+ **Acri (acri)**
+ **Ettaro (ha)**

**Mostra debug**

Visualizza le informazioni di debug nell'angolo superiore destro della mappa. Ciò può essere utile per eseguire il debug o la convalida di un'origine dati.
+ **Zoom** mostra il livello di zoom corrente della mappa.
+ **Centro** mostra la **longitudine** e la **latitudine** correnti del centro della mappa.

**Tooltip**
+ **Nessuno visualizza le descrizioni dei** comandi solo quando si fa clic su un punto dati.
+ **Details** visualizza le descrizioni dei comandi quando un puntatore passa sopra un punto dati.