Condividi tramite


Introduzione a Azure Maps Power BI Visual per iniziare

Questo articolo illustra come usare l'oggetto visivo Microsoft Azure Maps Power BI.

SI APPLICA A:Segno di spunta verde. Servizio Power BI per consumatoriSegno di spunta verde. Servizio Power BI per designer e sviluppatori Segno di spunta verde. Power BI Desktop X che indica no. richiede una licenza Pro o Premium

Note

Questo oggetto visivo può essere creato e visualizzato sia in Power BI Desktop che nel Power BI service. I passaggi e le illustrazioni di questo articolo provengono da Power BI Desktop.

L'elemento visivo Azure Maps Power BI offre un ricco insieme di visualizzazioni per i dati spaziali su una mappa. Si stima che oltre l'80% dei dati aziendali abbia un contesto di posizione. L'oggetto visivo Azure Maps Power BI può essere usato per ottenere informazioni dettagliate sul modo in cui questo contesto di posizione è correlato ai dati aziendali e influenza i dati aziendali.

Uno screenshot di Power BI Desktop con l'elemento visivo di Azure Maps in Power BI che visualizza dati aziendali.

Note

Power BI assicura che nessuna informazione personale venga inviata a Azure Maps. Inoltre, gli indirizzi IP vengono troncati nei log di diagnostica Power BI.

Cosa viene inviato a Azure?

L'elemento visivo Azure Maps Power BI si connette al servizio cloud ospitato in Azure per recuperare i dati sulla posizione, come le immagini della mappa e le coordinate utilizzate per creare la visualizzazione della mappa.

  • I dettagli sull'area su cui si concentra la mappa vengono inviati a Azure per recuperare le immagini necessarie per eseguire il rendering dell'area di disegno mappa (nota anche come tessere mappa).
  • I dati nel bucket Location possono essere inviati a Azure per recuperare le coordinate della mappa (un processo denominato geocodifica).
  • I dati di telemetria possono essere raccolti per l'integrità dell'oggetto visivo (ad esempio report di arresto anomalo), se l'opzione di telemetria in Power BI è abilitata.

Oltre agli scenari descritti in precedenza, non vengono inviati altri dati sovrapposti sulla mappa ai server Azure Maps. Tutto il rendering dei dati avviene localmente all'interno del client.

Suggerimento

Se si usano gli endpoint dell'API Azure Maps Geographic, potrebbe essere necessario aggiornare il firewall per consentire l'accesso alla piattaforma Azure Maps usando o tutti gli URL seguenti:

  • https://atlas.microsoft.com
  • https://us.atlas.microsoft.com
  • https://eu.atlas.microsoft.com
  • 'https://kr.atlas.microsoft.com'
  • https://br.atlas.microsoft.com

Importante

Lo strumento di selezione all'interno dell'oggetto visivo Azure Maps Power BI si basa sui dati TomTom, di conseguenza i dati utente potrebbero non rimanere sempre entro il limite geografico dell'utente.

Per altre informazioni sulla privacy e sui termini di utilizzo relativi all'elemento visivo Azure Maps Power BI, vedere Microsoft Azure Informazioni legali.

Utilizzare la visualizzazione Azure Maps Power BI

Dopo aver abilitato l'oggetto visivo Azure Maps Power BI, selezionare l'icona Azure Maps nel riquadro Visualizations.

A screenshot del pulsante visivo Azure Maps nel riquadro Visualizzazioni di Power BI.

Power BI crea un'area di disegno visiva Azure Maps vuota.

Screenshot di Power BI Desktop con l'oggetto visivo di Mappe di Azure caricato nello stato iniziale.

Per caricare l'oggetto visivo Azure Maps, seguire questa procedura:

  1. L'esecuzione di una delle due azioni seguenti nel riquadro Fields fornisce i dati minimi necessari per caricare l'oggetto visivo Azure Maps:

    1. Trascinare i campi dati contenenti informazioni sulle coordinate di latitudine e longitudine nei bucket Latitudine e/o Longitudine .
    2. Trascinare i campi dati contenenti dati geospaziali nel bucket Posizione .

    Screenshot dell'oggetto visivo di Mappe di Azure che mostra i punti come indicatori di icone rotonde sulla mappa dopo che sono stati forniti i campi di latitudine e longitudine.

  2. Per colorare i dati in base alla categorizzazione, trascinare un campo categorico nel bucket Legenda del riquadro Campi . In questo esempio viene usata la colonna BussinessName .

    Uno screenshot della visualizzazione di Azure Maps che mostra i punti come icone arrotondate e colorate sulla mappa dopo che il campo legenda è stato fornito.

  3. Per ridimensionare i dati relativamente, trascinare una misura nel bucket Dimensioni del riquadro Campi . In questo esempio viene usata la colonna Avg Weekly Sales .

    Uno screenshot del visual di Azure Maps che mostra i punti come marcatori icona arrotondati, colorati e scalati sulla mappa per rappresentare il campo delle dimensioni.

    Note

    A differenza degli altri screenshot in questa sezione, questo screenshot illustra Geocoding in Azure Maps Power BI Visual, usando campi di coordinate (lat/lon) anziché fornire un indirizzo fisico.

  4. Usare le opzioni nel riquadro Formato per personalizzare la modalità di rendering dei dati. L'immagine seguente è la stessa mappa illustrata in precedenza, ma con l'opzione di trasparenza del riempimento dei livelli marcatori impostata su 25%, raggio più piccolo e bordo nero.

    Uno screenshot della rappresentazione visiva su Azure Maps che visualizza punti come icone tonde sulla mappa con uno stile personalizzato.

  5. È anche possibile visualizzare o nascondere le etichette nel riquadro Formato . Le due immagini seguenti mostrano le mappe con l'impostazione Etichette attivata e disattivata:

    Uno screenshot dell'oggetto visivo Azure Maps che visualizza una mappa con l'impostazione 'visualizza etichette' attivata nella sezione stile del riquadro del formato in Power BI.

    Uno screenshot dell'oggetto visivo Azure Maps che visualizza una mappa con l'impostazione

  6. È anche possibile mostrare o nascondere i confini di paesi/aree geografiche, regioni e province, nonché edifici e dettagli stradali nel riquadro Formato. Le due immagini seguenti mostrano le mappe con le impostazioni di Confini di paese/area geografica attivate e disattivate:

    Screenshot dell'oggetto visivo di Mappe di Azure che mostra una mappa con l'impostazione dei confini paese/area geografica attivata nella sezione stile del riquadro del formato in Power BI.

    Screenshot dell'oggetto visivo di Mappe di Azure che mostra una mappa con l'impostazione dei confini paese/area geografica disattivata nella sezione stile del riquadro del formato in Power BI.

Contenitori del riquadro Campi

I bucket di dati seguenti sono disponibili nel riquadro Fields dell'oggetto visivo Azure Maps.

Campo Descrizione
Location Utilizzati per immettere dati geografici facilmente comprensibili, ad esempio paese/area geografica, stato e città.
Latitude Campo utilizzato per specificare il valore latitudine dei punti dati. I valori latitudine devono essere compresi tra -90 e 90 in formato decimale.
Longitudine Campo utilizzato per specificare il valore longitudine dei punti dati. I valori longitudine devono essere compresi tra -180 e 180 in formato decimale.
Legenda Campo utilizzato per classificare i dati e assegnare un colore univoco per i punti dati in ogni categoria. Quando questo bucket viene riempito, viene visualizzata una sezione Colori dati nel riquadro Formato che consente di aggiustare i colori.
Dimensione Misura utilizzata per il dimensionamento relativo dei punti dati sulla mappa.
Descrizioni comando Altri campi dati da visualizzare nelle descrizioni comando quando ci si passa sopra con il puntatore del mouse.

Impostazioni mappa

La sezione Impostazioni mappa del riquadro Formato fornisce opzioni per personalizzare la modalità di visualizzazione e reazione della mappa agli aggiornamenti.

La sezione Impostazioni mappa è suddivisa in tre sottosezioni: stile, visualizzazione e controlli.

Style

Nella sezione Stile sono disponibili le impostazioni seguenti:

Impostazione Descrizione
Style Stile della mappa. L'elenco a discesa contiene spazio vuoto accessibile,scuro in scala di grigi, chiaro in scala di grigi, contrasto elevato scuro, contrasto elevato chiaro, notte, strada, strada rilievo ombreggiato, satellite e etichette stradali satellitari.
Etichette Interruttore che consente di visualizzare o nascondere le etichette della mappa. Per ulteriori informazioni, consultare la voce numero cinque della sezione precedente intitolata Usare l'oggetto visivo Azure Maps Power BI.
Confini paese/area geografica Interruttore che controlla la visibilità dei confini di paese/area geografica.
Confini di stato o provincia Interruttore che controlla la visibilità dei bordi per le divisioni amministrative di primo livello, ad esempio i confini dello stato o della provincia.
Confini della contea Interruttore che controlla la visibilità dei bordi per le divisioni amministrative di secondo livello, ad esempio i confini della contea.
Edifici Interruttore che controlla la visibilità dei footprint degli edifici
Dettagli della strada Interruttore che regola il livello di dettaglio per le strade visibili. La disattivazione ridurrà il numero di strade visualizzate sulla mappa.

La disponibilità degli interruttori precedenti dipende dallo stile selezionato. Di seguito è riportata una tabella che mostra le opzioni supportate per diversi stili:

Gli stili della mappa Etichette Confini paese/area geografica Confini di stato o provincia Confini della contea Edifici Dettagli della strada
spazio vuoto e spazio accessibile
grigio scuro
chiaro in scala di grigi
scuro a contrasto elevato
luce a contrasto elevato
Notte
strada
strada a rilievo ombreggiato
satellite
etichette stradali satellitari

Se un'opzione non è supportata dallo stile attualmente selezionato, non avrà alcun effetto finché non si sceglie uno stile che lo supporta.

Visualizzazione

Le impostazioni seguenti disponibili nella sezione Visualizza consentono all'utente di specificare le informazioni di visualizzazione mappa predefinite quando l'impostazione Zoom automatico è impostata su Disattivato.

Impostazione Descrizione
Zoom automatico Esegue automaticamente lo zoom della mappa sui dati caricati tramite il riquadro Campi dell'oggetto visivo. Man mano che i dati cambiano, la mappa ne aggiorna la posizione di conseguenza. Quando lo zoom automatico è impostato su Disattivato, le impostazioni rimanenti di questa sezione diventano attive che consentono all'utente di definire la visualizzazione mappa predefinita.
Includi livello di riferimento Include i dati del livello di riferimento quando la mappa esegue automaticamente lo zoom. Questa opzione è disponibile solo quando lo zoom automatico è impostato su .
Zoom Livello di zoom predefinito della mappa. Può essere un numero compreso tra 0 e 22.
Latitudine centrale Latitudine predefinita del centro della mappa.
Longitudine centrale Longitudine predefinita del centro della mappa.
Intestazione L’orientamento predefinito della mappa in gradi, dove 0 è corrisponde a nord, 90 a est, 180 a sud e 270 a ovest. Può essere qualsiasi numero compreso tra 0 e 360.
Passo L’inclinazione predefinita della mappa in gradi tra 0 e 60, dove 0 corrisponde a osservare direttamente la mappa dall'alto verso il basso.

Controlli

Nella sezione Controlli sono disponibili le impostazioni seguenti:

Impostazione Descrizione
Panoramica mondo Consente all'utente di eseguire la panoramica della mappa in orizzontale all'infinito.
Selezione stili Aggiunge un pulsante alla mappa che consente ai lettori del report di modificare lo stile della mappa.
Navigazione Aggiunge pulsanti alla mappa come un altro metodo per consentire ai lettori del report di ingrandire, ruotare e modificare il passo della mappa. Per informazioni dettagliate su tutti i diversi modi in cui gli utenti possono esplorare la mappa, vedere questo documento.
Selezione Aggiunge un pulsante che consente all'utente di scegliere tra modalità diverse per selezionare i dati sulla mappa; cerchio, rettangolo, poligono (lazo) o tempo per spostamento fisico o distanza. Per completare il disegno di un poligono; selezionare il primo punto oppure fare doppio clic sull'ultimo punto sulla mappa oppure premere il tasto c.
Impostazioni cultura di geocodifica Il valore predefinito, Auto, si riferisce al sistema di indirizzi occidentale. L'unica opzione, JA, si riferisce al sistema di indirizzi giapponese. Nel sistema di indirizzi occidentale si inizia con i dettagli dell'indirizzo e quindi si passa alle categorie più ampie, ad esempio città, stato e codice postale. Nel sistema di indirizzi giapponese, le categorie più ampie vengono elencate per prime e terminano con i dettagli dell'indirizzo.

Considerazioni e limitazioni

L'oggetto visivo Azure Maps Power BI è disponibile nei servizi e nelle applicazioni seguenti:

Servizio/App Disponibilità
Power BI Desktop
Power BI service (app.powerbi.com)
Power BI applicazioni per dispositivi mobili
Power BI pubblica sul Web
Power BI Embedded
Servizio Power BI incorporamento (PowerBI.com)
Power BI esportazione NO
sottoscrizioni Power BI NO

Limitazione di Power BI Embedded

L'elemento visivo di Mappe di Azure non è supportato nello scenario di creazione del report Embed for your customers quando si usa un token di embedding generato dall'API Genera token di embedding per la creazione di report in gruppo.

Dove è disponibile Azure Maps Visual per Power BI?

Attualmente, Azure Maps è attualmente disponibile in tutti i paesi e le aree geografiche, ad eccezione di:

  • Cina
  • Corea
  • Azure Government (GCC + GCC High)

Per informazioni dettagliate sulla copertura dei diversi servizi di Azure Maps che alimentano questo oggetto visivo, vedere Informazioni sulla copertura geografica.

Quali web browser sono supportati dall'oggetto visivo Azure Maps Power BI?

Per un elenco dei browser supportati, vedere browser supportati Azure Maps Web SDK.

Quanti punti dati è possibile visualizzare?

Questo oggetto visivo supporta fino a 30.000 punti dati.

In questo oggetto visivo è possibile usare indirizzi o altre stringhe di posizione?

Sì, gli indirizzi e altre stringhe di posizione possono essere usati nell'oggetto visivo Azure Maps Power BI. Per altre informazioni sugli indirizzi e altre stringhe di posizione, vedere Il campo location nell'articolo Geocoding in Azure Maps Power BI Visual.

Perché vedo l'errore "Opzione tenant non abilitata" in Power BI Desktop anche se ho questa opzione abilitata?

Aggiornare l'app desktop Power BI almeno alla versione di maggio 2025 per risolvere questo problema.

Passaggi successivi

Scopri di più sull'oggetto visivo Azure Maps Power BI:

Personalizzare l'oggetto visivo: