Condividi tramite

Panoramica di mappe e località

Importante

Le API della piattaforma UWP MapControl e Windows Maps (Windows.Services.Maps.*) sono deprecate e potrebbero non essere disponibili nelle versioni future di Windows. Per altre informazioni, vedere Risorse per le funzionalità deprecate.

Importante

Ritiro del servizio Bing Maps per le aziende

I servizi di mappa e MapControl della UWP e nei namespace Windows.Services.Maps si basano su Bing Maps. Bing Maps per le aziende è obsoleto e verrà ritirato; da quel momento in poi MapControl e i servizi non riceveranno più i dati.

Per altre informazioni, vedere il Centro per sviluppatori Bing Maps e la documentazione di Bing Maps.

Importante

L'app Mappe di Windows è deprecata e verrà rimossa da Microsoft Store entro luglio 2025. In questo momento, ci sarà anche un aggiornamento finale dell'app dallo Store che lo rende non funzionale. Se rimuovi l'app prima di luglio 2025, puoi comunque reinstallarla dallo Store, ma lo scorso luglio 2025 non potrai reinstallarla.

Per altre informazioni, vedere Risorse per le funzionalità deprecate - App Mappe.

Questa sezione illustra come visualizzare le mappe, usare i servizi per le mappe, individuare la posizione e configurare un recinto virtuale nella tua app.

MapControl e i servizi per le mappe richiedono una chiave di autenticazione delle mappe denominata MapServiceToken. Per altre informazioni su come ottenere e impostare una chiave di autenticazione delle mappe, vedere Richiedere una chiave di autenticazione per le mappe.

Visualizzare mappe

Puoi visualizzare le mappe in modalità 2D, 3D o Streetside nella tua app usando le API dello spazio dei nomi Windows.UI.Xaml.Controls.Maps. Puoi contrassegnare i punti di interesse sulla mappa usando puntine, immagini, forme o elementi dell'interfaccia utente XAML. Puoi anche sovrapporre le immagini in riquadri o sostituire completamente le immagini della mappa.

Argomento Descrizione
Richiedere una chiave di autenticazione per le mappe Prima di poter usare il controllo MapControl e i servizi per le mappe nello spazio dei nomi Windows.Services.Maps, la tua app deve essere autenticata. Per eseguire l'autenticazione della tua app, devi specificare una chiave di autenticazione per le mappe. Questo articolo descrive come richiedere una chiave di autenticazione per le mappe al centro per sviluppatori di Bing Mappe e aggiungerla alla tua app.
Mostrare mappe con visualizzazioni 2D, 3D e Streetside Con la classe MapControl puoi visualizzare mappe personalizzabili nella tua app. Questo argomento contiene anche un'introduzione alle visualizzazioni aeree 3D e Streetside.
Visualizzare punti di interesse su una mappa Puoi aggiungere punti di interesse a una mappa mediante puntine, immagini, forme ed elementi dell'interfaccia utente XAML.
Sovrapporre immagini in riquadri su una mappa Puoi sovrapporre immagini in riquadri personalizzati o di terze parti su una mappa usando le origini dei riquadri. Queste origini consentono di sovrapporre informazioni speciali, ad esempio dati meteo, dati sulla popolazione o dati sismici oppure, in alternativa, sostituire completamente la mappa predefinita.

Accedere ai servizi per le mappe

Puoi aggiungere alla tua app itinerari, indicazioni stradali e funzionalità di geocodifica usando le API dello spazio dei nomi Windows.Services.Maps.

Argomento Descrizione
Richiedere una chiave di autenticazione per le mappe Prima di poter usare il controllo MapControl e i servizi per le mappe nello spazio dei nomi Windows.Services.Maps, la tua app deve essere autenticata. Per eseguire l'autenticazione della tua app, devi specificare una chiave di autenticazione per le mappe. Questo articolo descrive come richiedere una chiave di autenticazione per le mappe al centro per sviluppatori di Bing Mappe e aggiungerla alla tua app.
Visualizzare punti di interesse su una mappa Puoi aggiungere punti di interesse a una mappa mediante puntine, immagini, forme ed elementi dell'interfaccia utente XAML.
Visualizzare itinerari e indicazioni stradali Puoi richiedere itinerari e indicazioni stradali e visualizzarli nella tua app.
Eseguire la geocodifica e la geocodifica inversa Converti indirizzi in posizioni geografiche (geocodifica) e posizioni geografiche in indirizzi (geocodifica inversa) chiamando i metodi della classe MapLocationFinder nello spazio dei nomi Windows.Services.Maps.
Trovare e scaricare i pacchetti di mappe per l'uso offline In passato la tua app doveva indirizzare gli utenti all'app Impostazioni per scaricare le mappe offline. Oggi puoi usare le classi dello spazio dei nomi Windows.Services.Maps.OfflineMaps per trovare pacchetti scaricati in una determinata area (in base a una classe Geopoint, GeoboundingBox e così via).
Puoi anche controllare e restare in ascolto dello stato scaricato dei pacchetti di mappe e avviare un download senza che l'utente debba uscire dalla tua app.
Troverai esempi in proposito sia nel contenuto di riferimento che nell'esempio di mappa UWP (Universal Windows Platform).

Ottenere la posizione dell'utente

Per ottenere la posizione corrente dell'utente e ricevere una notifica in caso di modifica della posizione nella tua app, usa le API dello spazio dei nomi Windows.Devices.Geolocation. Questi membri delle API vengono usati frequentemente anche nei parametri delle API per le mappe. Le API dello spazio dei nomi Windows.Devices.Geolocation.Geofencing permettono all'app di ricevere una notifica quando l'utente entra o esce da un recinto virtuale, ovvero un'area geografica predefinita.

Argomento Descrizione
Richiedere una chiave di autenticazione per le mappe Prima di poter usare il controllo MapControl e i servizi per le mappe nello spazio dei nomi Windows.Services.Maps, la tua app deve essere autenticata. Per eseguire l'autenticazione della tua app, devi specificare una chiave di autenticazione per le mappe. Questo articolo descrive come richiedere una chiave di autenticazione per le mappe al centro per sviluppatori di Bing Mappe e aggiungerla alla tua app.
Linee guida di progettazione per le app in grado di riconoscere la posizione Linee guida sulle prestazioni per le app che richiedono l'accesso alla posizione di un utente.
Ottenere la posizione dell'utente Ottenere l'accesso alla posizione dell'utente e quindi recuperarla.
Linee guida per l'uso del monitoraggio delle visite Scopri come usare la potente funzionalità di rilevamento delle visite per un monitoraggio più pratico della posizione.
Linee guida di progettazione del geofencing Linee guida sulle prestazioni per app che usano la funzionalità di geofencing.
Configurare un recinto virtuale Configura un recinto virtuale nella tua app e impara a gestire le notifiche in primo piano e sullo sfondo.