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.
| 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:.
| 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.
| 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 |
Style |
sty = "sty=" ("a" / "r"/"3d") Esempio: sty=a |
Definisce lo stile della mappa. I valori validi per questo parametro sono:
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 |
Pitch |
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
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
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 È anche accettabile specificare una route incompleta. Ad esempio, è possibile definire solo l'inizio di una route con Se viene specificata solo la fine di un itinerario, come con 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:
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 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. |
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per