Avviare l'app Mappe Windows

Informazioni su come avviare l'app Mappe Windows dalla tua app. Questo argomento descrive gli schemi bingmaps:, ms-drive-to:, ms-walk-to:e ms-settings: Uniform Resource Identifier (URI). Usare questi schemi URI per avviare l'app Mappe Windows a mappe, indicazioni stradali e risultati di ricerca specifici o scaricare Mappe Windows mappe offline dall'app Impostazioni.

Tip Per maggiori informazioni sull'avvio dell'app Maps Windows dall'app, scaricare l'esempio di mappa Universal Windows Platform (UWP) dal repo Windows-universal-samples su GitHub.

Introduzione agli URI

Gli schemi URI consentono di aprire le app facendo clic su collegamenti ipertestuali (o a livello di codice, nell'app). Proprio come è possibile avviare un nuovo messaggio di posta elettronica usando mailto: o aprire un Web browser usando http:, è possibile aprire l'app Maps di Windows usando bingmaps:, ms-drive-to:e ms-walk-to:.

• L'URI bingmaps: fornisce mappe per località, risultati di ricerca, indicazioni stradali e traffico.
• L'URI ms-drive-to: fornisce indicazioni stradali turn-by-turn dalla posizione corrente.
• L'URI ms-walk-to: fornisce indicazioni per camminare turn-by-turn dalla posizione corrente.

Ad esempio, l'URI seguente apre l'app Maps Windows e visualizza una mappa centrata su New York City.

<bingmaps:?cp=40.726966~-74.006076>

Ecco una descrizione dello schema URI:

bingmaps:?query

In questo schema URI, la query è una serie di coppie nome/valore del parametro:

¶m1=value1¶m2=value2 …

Per un elenco completo dei parametri disponibili, vedere le informazioni di riferimento sui parametri bingmaps:, ms-drive-to: e ms-walk-to:. Più avanti in questo argomento sono disponibili anche esempi.

Avviare un URI dall'app

Per avviare l'app Maps Windows dall'app, chiamare il metodo LaunchUriAsync con un URI bingmaps:, ms-drive-to:, o ms-walk-to:. Nell'esempio seguente viene avviato lo stesso URI dell'esempio precedente. Per maggiori informazioni sull'avvio di app tramite URI, vedere Avviare l'app predefinita per un URI.

// Center on New York City
var uriNewYork = new Uri(@"bingmaps:?cp=40.726966~-74.006076");

// Launch the Windows Maps app
var launcherOptions = new Windows.System.LauncherOptions();
launcherOptions.TargetApplicationPackageFamilyName = "Microsoft.WindowsMaps_8wekyb3d8bbwe";
var success = await Windows.System.Launcher.LaunchUriAsync(uriNewYork, launcherOptions);

In questo esempio viene usata la classe LauncherOptions per garantire l'avvio dell'app Maps Windows.

Visualizzare posizioni note

Sono disponibili molte opzioni per controllare quale parte della mappa visualizzare. È possibile usare il parametro cp (punto centrale) con i parametri rad (raggio) o lvl (livello di zoom) per visualizzare una posizione e scegliere la vicinanza per ingrandirla. Quando si usa il parametro cp, è anche possibile specificare un hdg (intestazione) e pit (inclinazione) per controllare la direzione da guardare. Un altro metodo consiste nell'usare il parametro bb (rettangolo delimitatore) per fornire le coordinate massime sud, est, nord e ovest dell'area da visualizzare.

Per controllare il tipo di visualizzazione, usare i parametri sty (style) e ss (Streetside). Il parametro sty consente di passare da una strada all'altra. Il parametro ss inserisce la mappa in una visualizzazione Streetside. Per altre info su questi e altri parametri, vedere le informazioni di riferimento sui parametri bingmaps.

Visualizzare i risultati della ricerca

Quando si cercano luoghi usando il parametro q, è consigliabile rendere i termini più specifici possibile e usare i parametri cp, bb o dove per specificare un percorso di ricerca. Se non si specifica un percorso di ricerca e la posizione corrente dell'utente non è disponibile, la ricerca potrebbe non restituire risultati significativi. I risultati della ricerca vengono visualizzati nella visualizzazione mappa più appropriata. Per altre info su questi e altri parametri, vedere le informazioni di riferimento sui parametri bingmaps.

Visualizzare più punti

Usare il parametro raccolta per visualizzare un set personalizzato di punti sulla mappa. Se sono presenti più punti, viene visualizzato un elenco di punti. In una raccolta possono essere presenti fino a 25 punti e sono elencati nell'ordine specificato. La raccolta ha la precedenza sulle richieste di ricerca e indicazioni stradali. Per altre info su questi e altri parametri, vedere le informazioni di riferimento sui parametri bingmaps:.

Visualizzare indicazioni stradali e traffico

È possibile visualizzare le direzioni tra due punti usando il parametro rtp. Questi punti possono essere indirizzi o coordinate di latitudine e longitudine. Usare il parametro trfc per visualizzare le informazioni sul traffico. Per specificare il tipo di indicazioni stradali: guida, camminare o transito, usare il parametro mode. Se la modalità non è specificata, le indicazioni stradali verranno fornite utilizzando la modalità di trasporto preferita dell'utente. Per altre info su questi e altri parametri, vedere le informazioni di riferimento sui parametri bingmaps:.

Visualizzare le direzioni turn-by-turn

Gli schemi ms-drive-to: e ms-walk-to: consentono di avviare direttamente in una visualizzazione turn-by-turn di una route. Questi schemi URI possono fornire indicazioni solo dalla posizione corrente dell'utente. Se è necessario fornire indicazioni tra i punti che non includono la posizione corrente dell'utente, usare lo schema URI bingmaps: come descritto nella sezione precedente. Per altre info su questi schemi URI, vedere le informazioni di riferimento sui parametri ms-drive-to: e ms-walk-to:.

Importante Quando vengono avviati gli schemi URI ms-drive-to: o ms-walk-to: l'app Maps verificherà se il dispositivo ha mai avuto una correzione della posizione GPS. In caso affermativo, l'app Maps procederà con le direzioni turn-by-turn. In caso contrario, l'app visualizzerà la panoramica della route, come descritto in Visualizzare indicazioni stradali e traffico.

Scaricare mappe offline

Lo schema URI ms-settings: consente di avviare direttamente in una determinata pagina nell'app Impostazioni. Anche se lo schema URI ms-settings: non viene avviato nell'app Maps, consente di avviare direttamente la pagina Mappe offline nell'app Impostazioni e visualizza una finestra di dialogo di conferma per scaricare le mappe offline usate dall'app Maps. Lo schema URI accetta un punto specificato da una latitudine e longitudine e determina automaticamente se sono disponibili mappe offline per un'area contenente tale punto. Se latitudine e longitudine superata rientrano in più aree di download, la finestra di dialogo di conferma consentirà all'utente di selezionare le aree da scaricare. Se le mappe offline non sono disponibili per un'area contenente tale punto, la pagina di Maps offline nell'app Impostazioni viene visualizzata con una finestra di dialogo di errore.

bingmaps: parametri di riferimento

La sintassi per ogni parametro in questa tabella viene visualizzata usando il modulo ABNF (Augmented Backus-Naur Form).

ms-drive-to: riferimento ai parametri

L'URI per avviare una richiesta di indicazioni stradali turn-by-turn non deve essere codificato e ha il formato seguente.

Nota Non specificare il punto iniziale in questo schema URI. Si presuppone che il punto iniziale sia sempre la posizione corrente. Se è necessario specificare un punto di partenza diverso dalla posizione corrente, vedere Visualizzare indicazioni stradali e traffico.

ms-walk-to: parametri di riferimento

L'URI per avviare una richiesta di indicazioni stradali a piedi turn-by-turn non deve essere codificato e ha il formato seguente.

Nota Non specificare il punto iniziale in questo schema URI. Si presuppone che il punto iniziale sia sempre la posizione corrente. Se è necessario specificare un punto di partenza diverso dalla posizione corrente, vedere Visualizzare indicazioni stradali e traffico.  

ms-settings: parametri di riferimento

La sintassi per mappe parametri specifici dell'app per lo schema URI ms-settings è definito di seguito. maps-downloadmaps viene specificato insieme all'URI ms-settings: sotto forma di ms-settings:maps-downloadmaps? per indicare la pagina delle impostazioni delle mappe offline.