Condividi tramite


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>

una mappa centrata sulla città di New York.

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.

Sample URI Risultati
bingmaps:? Apre l'app Maps.
bingmaps:?cp=40.726966~-74.006076 Visualizza una mappa centrata su New York City.
bingmaps:?cp=40.726966~-74.006076&lvl=10 Visualizza una mappa centrata su New York City con un livello di zoom pari a 10.
bingmaps:?bb=39.719_-74.52~41.71_-73.5 Visualizza una mappa di New York City, ovvero l'area specificata nell'argomento bb.
bingmaps:?bb=39.719_-74.52~41.71_-73.5&cp=47~-122 Visualizza una mappa di New York City, ovvero l'area specificata nell'argomento del riquadro di delimitazione. Il punto centrale per Seattle specificato nell'argomento cp viene ignorato perché viene specificato bb.
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace&lvl=16 Visualizza una mappa con un punto denominato Caesars Palace (a Las Vegas) e imposta il livello di zoom su 16.
bingmaps:?collection=point.40.726966_-74.006076_Some%255FBusiness Visualizza una mappa con un punto denominato Some_Business (a Las Vegas).
bingmaps:?cp=40.726966~-74.006076&trfc=1&sty=a Visualizza una mappa di New York con il traffico sullo stile della mappa aerea.
bingmaps:?cp=47.6204~-122.3491&sty=3d Visualizza una visualizzazione 3D dello Space Needle.
bingmaps:?cp=47.6204~-122.3491&sty=3d&rad=200&pit=75&hdg=165 Visualizza una visualizzazione 3D dello Space Needle con un raggio di 200 m, un'inclinazione di 75 gradi e un'intestazione di 165 gradi.
bingmaps:?cp=47.6204~-122.3491&ss=1 Visualizza una visualizzazione Streetside dello Space Needle.

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.

Sample URI Risultati
bingmaps:?q=1600%20Pennsylvania%20Ave,%20Washington,%20DC Visualizza una mappa e cerca l'indirizzo della Casa Bianca a Washington, D.C.
bingmaps:?q=coffee&where=Seattle Cerca caffè a Seattle.
bingmaps:?cp=40.726966~-74.006076&where=New%20York Cerca New York vicino al punto centrale specificato.
bingmaps:?bb=39.719_-74.52~41.71_-73.5&q=pizza Cerca pizzerie nel rettangolo di selezione specificato ,ovvero a New York City.

 

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

Sample URI Risultati
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace Cerca Cesare's Palace a Las Vegas e visualizza i risultati su una mappa nella migliore visualizzazione mappa.
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace&lvl=16 Visualizza una puntina denominata Caesars Palace a Las Vegas e zoom al livello 16.
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace~point.36.113126_-115.175188_The%20Bellagio&lvl=16&cp=36.114902~-115.176669 Visualizza una puntina denominata Caesars Palace e una puntina denominata The Bellagio a Las Vegas e zoom al livello 16.
bingmaps:?collection=point.40.726966_-74.006076_Fake%255FBusiness%255Fwith%255FUnderscore Visualizza New York con una puntina denominata Fake_Business_with_Underscore.
bingmaps:?collection=name. Hotel%20List~point.36.116584_-115.176753_Caesars%20Palace~point.36.113126_-115.175188_The%20Bellagio&lvl=16&cp=36.114902~-115.176669 Visualizza una lista denominata Hotel List e due puntine da disegno per Caesars Palace e The Bellagio a Las Vegas e zoom al livello 16.

 

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

un esempio di indicazioni stradali

Sample URI Risultati
bingmaps:?rtp=pos.44.9160_-110.4158~pos.45.0475_-109.4187 Visualizza una mappa con indicazioni da punto a punto. Poiché la modalità non è specificata, le indicazioni stradali verranno fornite utilizzando la modalità di trasporto preferita dell'utente.
bingmaps:?cp=43.0332~-87.9167&trfc=1 Visualizza una mappa centrata su Milwaukee, WI con traffico.
bingmaps:?rtp=adr. One Microsoft Way, Redmond, WA 98052~pos.39.0731_-108.7238 Visualizza una mappa con indicazioni stradali dall'indirizzo specificato alla posizione specificata.
bingmaps:?rtp=adr.1%20Microsoft%20Way,%20Redmond,%20WA,%2098052~pos.36.1223_-111.9495_Grand%20Canyon%20northern%20rim Visualizza le indicazioni stradali da 1 Microsoft Way, Redmond, WA, 98052 al margine settentrionale del Grand Canyon.
bingmaps:?rtp=adr.Davenport, CA~adr.Yosemite Village Visualizza una mappa con indicazioni stradali per la guida dal luogo specificato alla posizione di riferimento specificata.
bingmaps:?rtp=adr. Mountain%20View,%20CA~adr. San%20Francisco%20International%20Airport,%20CA&mode=d Visualizza le indicazioni stradali da Mountain View, CA all'aeroporto internazionale di San Francisco, CA.
bingmaps:?rtp=adr.Mountain%20View,%20CA~adr.San%20Francisco%20International%20Airport,%20CA&mode=w Visualizza le indicazioni stradali per andare a piedi da Mountain View, CA all'aeroporto internazionale di San Francisco, CA.
bingmaps:?rtp=adr.Mountain%20View,%20CA~adr.San%20Francisco%20International%20Airport,%20CA&mode=t Visualizza le indicazioni per andare con mezzi pubblici da Mountain View, CA all'aeroporto internazionale di San Francisco, CA.

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.

esempio di direzioni turn-by-turn

Sample URI Risultati
ms-drive-to:?destination.latitude=47.680504&destination.longitude=-122.328262&destination.name=Green Lake Visualizza una mappa con indicazioni stradali turn-by-turn fino a Green Lake dalla posizione corrente.
ms-walk-to:?destination.latitude=47.680504&destination.longitude=-122.328262&destination.name=Green Lake Visualizza una mappa con indicazioni stradali turn-by-turn per andare a piedi fino a Green Lake dalla posizione corrente.

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.

Sample URI Risultati
ms-settings:maps-downloadmaps?latlong=47.6,-122.3 Apre l'app Impostazioni alla pagina Mappe offline con una finestra di dialogo di conferma visualizzata per scaricare le mappe per l'area contenente il punto di latitudine-longitudine specificato.

bingmaps: parametri di riferimento

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

Parametro Definizione Definizione ABNF ed esempio Dettagli

cp

Punto centrale

cp = "cp=" cpval

cpval = degreeslat "~" degreeslon

degreeslat = ["-"] 1*3DIGIT ["." 1*7DIGIT]

degreeslon = ["-"] 1*2DIGIT ["." 1*7DIGIT]

Esempio:

cp=40.726966~-74.006076

Entrambi i valori devono essere espressi in gradi decimali e separati da una tilde (~).

I valori longitudine validi sono compresi tra -180 e +180 inclusi.

I valori latitudine validi sono compresi tra -90 e +90 inclusi.

bb

Rettangolo di selezione

bb = "bb=" southlatitude "_" westlongitude "~" northlatitude "_" eastlongitude

southlatitude = degreeslat

northlatitude = degreeslat

westlongitude = degreeslon

eastlongitude = degreeslon

degreeslat = ["-"] 13DIGIT ["." 17DIGIT]

degreeslon = ["-"] 12DIGIT ["." 17DIGIT]

Esempio:

bb=39.719_-74.52~41.71_-73.5

Area rettangolare che specifica il rettangolo di selezione espresso in gradi decimali, utilizzando una tilde (~) per separare l'angolo inferiore sinistro dall'angolo superiore destro. Latitudine e longitudine per ognuna sono separate con un trattino basso (_).

I valori longitudine validi sono compresi tra -180 e +180 inclusi.

I valori latitudine validi sono compresi tra -90 e +90 inclusi.

I parametri cp e lvl vengono ignorati quando viene fornito un rettangolo di selezione.

where

Ufficio

where = "where=" whereval

whereval = 1*( ALPHA / DIGIT / "-" / "." / "_" / pct-encoded / "!" / "$" / "'" / "(" / ")" / "*" / "+" / "," / ";" / ":" / "@" / "/" / "?")

Esempio:

where=1600%20Pennsylvania%20Ave,%20Washington,%20DC

Cercare un termine specifico per una località, un punto di riferimento o un luogo specifico.

q

Termine query

q = "q="

whereval

Esempio:

q=mexican%20restaurants

Cerca il termine per attività commerciali locali o categorie di aziende.

lvl

Livello di zoom

lvl = "lvl=" 12DIGIT ["." 12DIGIT]

Esempio:

lvl=10.50

Definisce il livello di zoom di visualizzazione della mappa. I valori validi sono compresi tra 1 e 20, dove 1 viene eseguito lo zoom indietro.

sty

Stile

sty = "sty=" ("a" / "r"/"3d")

Esempio:

sty=a

Definisce lo stile della mappa. I valori validi per questo parametro sono:

  • a: visualizzare una vista aerea della mappa.
  • r: visualizzare una visualizzazione strada della mappa.
  • 3d: visualizzare una visualizzazione 3D della mappa. Usare in combinazione con il parametro cp e facoltativamente con il parametro rad.

In Windows 10, gli stili di visualizzazione aerea e visualizzazione 3D sono gli stessi.

Nota L'omissione del parametro sty produce gli stessi risultati di sty=r.
 

rad

Radius

rad = "rad=" 1*8DIGIT

Esempio:

rad=1000

Area circolare che specifica la visualizzazione mappa desiderata. Il valore del raggio viene misurato in metri.

pit

Beccheggio

pit = "pit=" pitch

Esempio:

pit=60

Indica l'angolo in cui viene visualizzata la mappa, dove 90 sta guardando l'orizzonte (massimo) e 0 sta guardando dritto (minimo).

I valori di inclinazione validi sono compresi tra 0 e 90 inclusi.

hdg

Intestazione

hdg = "hdg=" heading

Esempio:

hdg=180

Indica la direzione in cui la mappa è in gradi, dove 0 o 360 = Nord, 90 = Est, 180 = Sud e 270 = Ovest.

ss

Streetside

ss = "ss=" BIT

Esempio:

ss=1

Indica che le immagini a livello stradale vengono visualizzate quando ss=1. L'omissione del parametro ss produce lo stesso risultato di ss=0. Usare insieme al parametro cp per specificare la posizione della visualizzazione a livello stradale.

Nota Le immagini a livello di strada non sono disponibili in tutte le aree.
 

trfc

Traffico

trfc = "trfc=" BIT

Esempio:

trfc=1

Specifica se le informazioni sul traffico sono incluse nella mappa. L'omissione del parametro trfc produce gli stessi risultati di trfc=0.

Nota I dati del traffico non sono disponibili in tutte le aree.
 

rtp

Itinerario

rtp = "rtp=" (waypoint "~" [waypoint]) / ("~" waypoint)

waypoint = ("pos." point ) / ("adr." whereval)

point = "point". pointval ["_" title]

pointval = degreeslat "" degreeslon

degreeslat = ["-"] 13DIGIT ["." 17DIGIT]

degreeslon = ["-"] 12DIGIT ["." 17DIGIT]

title = whereval

whereval = 1( ALPHA / DIGIT / "-" / "." / "_" / pct-encoded / "!" / "$" / "'" / "(" / ")" / "" / "+" / "," / ";" / ":" / "@" / "/" / "?")

Esempi:

rtp=adr.Mountain%20View,%20CA~adr.SFO

rtp=adr.One%20Microsoft%20Way,%20Redmond,%20WA~pos.45.23423_-122.1232_My%20Picnic%20Spot

Definisce l'inizio e la fine di un percorso da disegnare sulla mappa, separati da una tilde (~). Ognuno dei punti di percorso viene definito da una posizione usando latitudine, longitudine e titolo facoltativo o un identificatore di indirizzo.

Una route completa contiene esattamente due punti di direzione. Ad esempio, una route con due punti di direzione è definita da rtp="A"~"B".

È anche accettabile specificare una route incompleta. Ad esempio, è possibile definire solo l'inizio di una route con rtp="A"~. In questo caso, l'input delle direzioni viene visualizzato con il punto di direzione specificato nel campo Da e il campo A ha lo stato attivo.

Se viene specificata solo la fine di un itinerario, come con rtp=~"B", il pannello delle direzioni viene visualizzato con il punto di direzione specificato nel campo A. Se è disponibile una posizione corrente accurata, la posizione corrente viene prepopolato nel campo Da con lo stato attivo.

Non viene tracciata alcuna linea di itinerario quando viene specificato un itinerario incompleto.

Usare insieme al parametro mode per specificare la modalità di trasporto (guida, transito o a piedi). Se la modalità non è specificata, le indicazioni stradali verranno fornite utilizzando la modalità di trasporto preferita dell'utente.

Nota Un titolo può essere usato per una posizione se la posizione è specificata dal valore del parametro pos. Anziché visualizzare la latitudine e la longitudine, verrà visualizzato il titolo.
 

mode

Modalità di trasporto

mode = "mode=" ("d" / "t" / "w")

Esempio:

mode=d

Definisce la modalità di trasporto. I valori validi per questo parametro sono:

  • d: Visualizza la panoramica dell'itinerario per indicazioni stradali
  • t: Visualizza la panoramica degli itinerari per le indicazioni stradali
  • w: Visualizza la panoramica dell'itinerario per indicazioni stradali a piedi

Usare in combinazione con il parametro rtp per le indicazioni stradali per i trasporti. Se la modalità non è specificata, le indicazioni stradali verranno fornite utilizzando la modalità di trasporto preferita dell'utente. Una modalità può essere fornita senza parametro di route per immettere l'input delle direzioni per tale modalità dalla posizione corrente.

collection

Raccolta

collection = "collection="(name"~"/)point["~"point]

name = "name." whereval

whereval = 1( ALPHA / DIGIT / "-" / "." / "_" / pct-encoded / "!" / "$" / "'" / "(" / ")" / "" / "+" / "," / ";" / ":" / "@" / "/" / "?")

point = "point". pointval ["_" title]

pointval = degreeslat "" degreeslon

degreeslat = ["-"] 13DIGIT ["." 17DIGIT]

degreeslon = ["-"] 12DIGIT ["." 17DIGIT]

title = whereval

Esempio:

collection=name.My%20Trip%20Stops~point.36.116584_-115.176753_Las%20Vegas~point.37.8268_-122.4798_Golden%20Gate%20Bridge

Raccolta di punti da aggiungere alla mappa e all'elenco. La raccolta di punti può essere denominata usando il parametro name. Un punto viene specificato usando latitudine, longitudine e un titolo facoltativo.

Nome separato e più punti con tilde (~).

Se l'elemento specificato contiene una tilde, assicurarsi che la tilde sia codificata come %7E. Se non sono accompagnati da parametri Punto centrale e Livello zoom, la raccolta fornirà la migliore visualizzazione mappa.

Importante Se l'elemento specificato contiene un trattino basso, assicurarsi che il trattino basso sia con codifica doppia come %255F.

 

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.

 

Parametro Definizione Esempio Dettagli
destination.latitude Destination latitude Esempio: destination.latitude=47.6451413797194 Latitudine della destinazione. I valori latitudine validi sono compresi tra -90 e +90 inclusi.
destination.longitude Destination longitude Esempio: destination.longitude=-122.141964733601 Longitudine della destinazione. I valori longitudine validi sono compresi tra -180 e +180 inclusi.
destination.name Nome della destinazione Esempio: destination.name=Redmond, WA Nome della destinazione. Non è necessario codificare il valore destination.name.

 

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.  

Parametro Definizione Esempio Dettagli
destination.latitude Destination latitude Esempio: destination.latitude=47.6451413797194 Latitudine della destinazione. I valori latitudine validi sono compresi tra -90 e +90 inclusi.
destination.longitude Destination longitude Esempio: destination.longitude=-122.141964733601 Longitudine della destinazione. I valori longitudine validi sono compresi tra -180 e +180 inclusi.
destination.name Nome della destinazione Esempio: destination.name=Redmond, WA Nome della destinazione. Non è necessario codificare il valore destination.name.

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. 

Parametro Definizione Esempio Dettagli
latlong Punto che definisce l'area della mappa offline. Esempio: latlong=47.6,-122.3 Il punto geografico viene specificato da una latitudine e una longitudine separate da virgole. I valori latitudine validi sono compresi tra -90 e +90 inclusi. I valori longitudine validi sono compresi tra -180 e +180 inclusi.