Lancer l’application Cartes Windows

Article
01/17/2024

Découvrez comment lancer l’application Cartes Windows à partir de votre application. Cette rubrique décrit les schémas bingmaps:, ms-drive-to:, ms-walk-to:, et ms-settings: Uniform Resource Identifier (URI). Utilisez ces schémas d’URI pour lancer l’application Cartes Windows à des mappages, des instructions et des résultats de recherche spécifiques ou pour télécharger Cartes Windows cartes hors connexion à partir de l’application Paramètres.

Conseil Pour en savoir plus sur le lancement de l’application Cartes Windows à partir de votre application, téléchargez l’exemple de mappage plateforme Windows universelle (UWP) à partir du référentiel Windows-universal-samples sur GitHub.

Présentation des URI

Les schémas d’URI vous permettent d’ouvrir des applications en cliquant sur des liens hypertexte (ou programmatiquement dans votre application). Tout comme vous pouvez démarrer un nouvel e-mail à l’aide de mailto: ou ouvrir un navigateur web à l’aide de http:, vous pouvez ouvrir l’application Cartes Windows à l’aide de bingmaps:, ms-drive-to:, et ms-walk-to:.

L’URI bingmaps: fournit des cartes pour les emplacements, les résultats de la recherche, les itinéraires et le trafic.
L’URI ms-drive-to: fournit des itinéraires voiture étape par étape à partir de votre emplacement actuel.
L’URI ms-walk-to fournit des itinéraires piéton étape par étape à partir de votre emplacement actuel.

Par exemple, l’URI suivant ouvre l’application Cartes Windows et affiche une carte centrée sur New York City.

<bingmaps:?cp=40.726966~-74.006076>

une carte centrée sur la ville de New York.

Voici une description du schéma d’URI :

bingmaps:?query

Dans ce schéma d’URI, la requête est une série de paires nom/valeur de paramètre :

¶m1=value1¶m2=value2 …

Pour obtenir la liste complète des paramètres disponibles, consultez la référence de paramètre bingmaps:, ms-drive-to: et ms-walk-to:. Il existe également des exemples plus loin dans cette rubrique.

Lancer un URI à partir de votre application

Pour lancer l’application Cartes Windows à partir de votre application, appelez la méthode LaunchUriAsync avec un URI bingmaps:, ms-drive-to:, ou ms-walk-to:. L’exemple suivant lance le même URI que celui de l’exemple précédent. Pour plus d’informations sur les applications de lancement via URI, voir Lancer l’application par défaut pour 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);

Dans cet exemple, la classe Lanceur Options est utilisée pour vous assurer que l’application Cartes Windows est lancée.

Afficher les emplacements connus

Il existe de nombreuses options pour contrôler la partie de la carte à afficher. Vous pouvez utiliser le paramètre cp (point central) avec les paramètres rad (rayon) ou lvl (niveau de zoom) pour afficher un emplacement et choisir la distance à laquelle effectuer un zoom. Lorsque vous utilisez le paramètre cp, vous pouvez également spécifier unhdg (en-tête) et un pit (pitch) pour contrôler la direction à regarder. Une autre méthode consiste à utiliser le paramètre bb (rectangle englobant) pour fournir les coordonnées sud, est, nord et ouest maximales de la zone que vous souhaitez afficher.

Pour contrôler le type de vue, utilisez les paramètres sty (style) et ss (Streetside). Le paramètre sty vous permet de basculer entre les vues routières et aériennes. Le paramètre ss place la carte dans une vue Streetside. Pour plus d’informations sur ces paramètres et d’autres paramètres, consultez les bingmaps : référence de paramètre.

URI d’exemple	Résultats
bingmaps:?	Ouvre l’application Cartes.
bingmaps:?cp=40.726966~-74.006076	Affiche une carte centrée sur New York City.
bingmaps:?cp=40.726966~-74.006076&lvl=10	Affiche une carte centrée sur New York City avec un niveau de zoom de 10.
bingmaps:?bb=39.719_-74.52~41.71_-73.5	Affiche une carte de New York City, qui est la zone spécifiée dans l’argument bb.
bingmaps:?bb=39.719_-74.52~41.71_-73.5&cp=47~-122	Affiche une carte de New York City, qui est la zone spécifiée dans l’argument de rectangle englobant. Le point central de Seattle spécifié dans l’argument cp est ignoré, car bb est spécifié.
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace&lvl=16	Affiche une carte avec un point nommé Caesars Palace (à Las Vegas) et définit le niveau de zoom sur 16.
bingmaps:?collection=point.40.726966_-74.006076_Some%255FBusiness	Affiche une carte avec un point nommé Some_Business (à Las Vegas).
bingmaps:?cp=40.726966~-74.006076&trfc=1&sty=a	Affiche une carte de New York City avec le trafic sur et le style de carte aérienne.
bingmaps:?cp=47.6204~-122.3491&sty=3d	Affiche une vue 3D de Space Needle.
bingmaps:?cp=47.6204~-122.3491&sty=3d&rad=200&pit=75&hdg=165	Affiche une vue 3D de Space Needle avec un rayon de 200m, un pas de 75 degrés et un titre de 165 degrés.
bingmaps:?cp=47.6204~-122.3491&ss=1	Affiche une vue Streetside de Space Needle.

Afficher les résultats de la recherche

Lorsque vous recherchez des emplacements à l’aide du paramètre q, nous vous recommandons de rendre les termes aussi spécifiques que possible et d’utiliser le cp, bb ou l’emplacement où les paramètres doivent spécifier un emplacement de recherche. Si vous ne spécifiez pas d’emplacement de recherche et que l’emplacement actuel de l’utilisateur n’est pas disponible, la recherche peut ne pas retourner de résultats significatifs. Les résultats de la recherche sont affichés dans la vue cartographique la plus appropriée. Pour plus d’informations sur ces paramètres et d’autres paramètres, consultez les bingmaps : référence de paramètre.

URI d’exemple	Résultats
bingmaps:?q=1600%20Pennsylvania%20Ave,%20Washington,%20DC	Affiche une carte et recherche l’adresse de la Maison Blanche à Washington, D.C.
bingmaps:?q=coffee&where=Seattle	Recherche d’un café à Seattle.
bingmaps:?cp=40.726966~-74.006076&where=New%20York	Recherche New York près du point central spécifié.
bingmaps:?bb=39.719_-74.52~41.71_-73.5&q=pizza	Recherche d’une pizza dans le rectangle englobant spécifié (autrement dit, à New York).

Afficher plusieurs points

Utilisez le paramètre de collection pour afficher un ensemble personnalisé de points sur la carte. S’il y a plusieurs points, une liste de points s’affiche. Il peut y avoir jusqu’à 25 points dans une collection et ils sont répertoriés dans l’ordre fourni. La collection est prioritaire sur les demandes de recherche et d’itinéraires. Pour plus d’informations sur ce paramètre et d’autres, consultez les bingmaps : référence de paramètre.

URI d’exemple	Résultats
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace	Recherche Caesar’s Palace à Las Vegas et affiche les résultats sur une carte dans la meilleure vue de carte.
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace&lvl=16	Affiche une punaise nommée Caesars Palace à Las Vegas et zoome sur le niveau 16.
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace~point.36.113126_-115.175188_The%20Bellagio&lvl=16&cp=36.114902~-115.176669	Affiche une punaise nommée Caesars Palace et une punaise nommée The Bellagio à Las Vegas et zoome au niveau 16.
bingmaps:?collection=point.40.726966_-74.006076_Fake%255FBusiness%255Fwith%255FUnderscore	Affiche New York avec une punaise nommée 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	Affiche une liste nommée Hotel List et deux pushpins pour Caesars Palace et The Bellagio à Las Vegas et zoome au niveau 16.

Afficher les itinéraires et le trafic

Vous pouvez afficher des itinéraires entre deux points à l’aide du paramètre rtp ; ces points peuvent être des adresses ou des coordonnées de latitude et de longitude. Utilisez le paramètre trfc pour afficher les informations de trafic. Pour spécifier le type de direction : conduite, marche ou transit, utilisez le paramètre de mode. Si le mode n’est pas spécifié, les itinéraires sont fournis à l’aide du mode de déplacement préféré de l’utilisateur. Pour plus d’informations sur ces paramètres et d’autres paramètres, consultez les bingmaps : référence de paramètre.

un exemple de directions

URI d’exemple	Résultats
bingmaps:?rtp=pos.44.9160_-110.4158~pos.45.0475_-109.4187	Affiche une carte avec des directions point à point. Étant donné que le mode n’est pas spécifié, les itinéraires seront fournis à l’aide du mode de déplacement préféré de l’utilisateur.
bingmaps:?cp=43.0332~-87.9167&trfc=1	Affiche une carte centrée sur Milwaukee, WI avec le trafic.
bingmaps:?rtp=adr.One Microsoft Way, Redmond, WA 98052~pos.39.0731_-108.7238	Affiche une carte avec des directions de l’adresse spécifiée à l’emplacement spécifié.
bingmaps:?rtp=adr.1%20Microsoft%20Way,%20Redmond,%20WA,%2098052~pos.36.1223_-111.9495_Grand%20Canyon%20northern%20rim	Affiche les directions de 1 Microsoft Way, Redmond, WA, 98052 jusqu’au bord nord du Grand Canyon.
bingmaps:?rtp=adr.Davenport, CA~adr.Yosemite Village	Affiche une carte avec des directions voiture de l’emplacement spécifié vers le repère spécifié.
bingmaps:?rtp=adr.Mountain%20View,%20CA~adr.San%20Francisco%20International%20Airport,%20CA&mode=d	Affiche les itinéraires voiture de Mountain View, CA à l’aéroport international de San Francisco, CA.
bingmaps:?rtp=adr.Mountain%20View,%20CA~adr.San%20Francisco%20International%20Airport,%20CA&mode=w	Affiche les itinéraires piéton de Mountain View, CA à l’aéroport international de San Francisco, CA.
bingmaps:?rtp=adr.Mountain%20View,%20CA~adr.San%20Francisco%20International%20Airport,%20CA&mode=t	Affiche les itinéraires de transit de Mountain View, CA à l’aéroport international de San Francisco, CA.

Afficher les directions étape par étape

Les schémas d’URI ms-drive-to: et ms-walk-to: vous permettent de lancer directement dans une vue étape par étape d’un itinéraire. Ces schémas d’URI peuvent uniquement fournir des itinéraires à partir de l’emplacement actuel de l’utilisateur. Si vous devez fournir des instructions entre les points qui n’incluent pas l’emplacement actuel de l’utilisateur, utilisez le schéma d’URI bingmaps: comme décrit dans la section précédente. Pour plus d’informations sur ces schémas d’URI, consultez la référence des paramètres ms-drive-to: et ms-walk-to:.

Important Lorsque les schémas d’URI ms-drive-to: ou ms-walk-to: sont lancés, l’application Cartes vérifie afin de savoir si l’appareil a déjà eu un correctif de localisation GPS. Si c’est le cas, l’application Cartes passe aux itinéraires étape par étape. Si ce n’est pas le cas, l’application affiche la vue d’ensemble de l’itinéraire, comme décrit dans Affichage des itinéraires et du trafic.

un exemple de directions de tour par tour

URI d’exemple	Résultats
ms-drive-to:?destination.latitude=47.680504&destination.longitude=-122.328262&destination.name=Green Lake	Affiche une carte avec des directions voiture étape par étape vers Green Lake à partir de votre emplacement actuel.
ms-walk-to:?destination.latitude=47.680504&destination.longitude=-122.328262&destination.name=Green Lake	Affiche une carte avec des itinéraires piéton étape par étape vers Green Lake à partir de votre emplacement actuel.

Télécharger des cartes hors connexion

Le schéma d’URI ms-settings: vous permet de lancer directement dans une page particulière de l’application Paramètres. Bien que le schéma d’URI ms-settings: ne se lance pas dans l’application Cartes, il vous permet de lancer directement sur la page de Cartes hors connexion de l’application Paramètres et affiche une boîte de dialogue de confirmation pour télécharger les cartes hors connexion utilisées par l’application Cartes. Le schéma d’URI accepte un point spécifié par une latitude et une longitude et détermine automatiquement s’il existe des cartes hors connexion disponibles pour une région contenant ce point. Si la latitude et la longitude transférées se trouvent dans plusieurs régions de téléchargement, la boîte de dialogue de confirmation permet à l’utilisateur de choisir les régions à télécharger. Si les cartes hors connexion ne sont pas disponibles pour une région contenant ce point, la page de Cartes hors connexion de l’application Paramètres s’affiche avec une boîte de dialogue d’erreur.

URI d’exemple	Résultats
ms-settings:maps-downloadmaps?latlong=47.6,-122.3	Ouvre l’application Paramètres sur la page Hors connexion Cartes avec une boîte de dialogue de confirmation affichée pour télécharger des cartes pour la région contenant le point de longitude de latitude spécifié.

bingmaps: référence de paramètre

La syntaxe de chaque paramètre de ce tableau s’affiche à l’aide de l’élément notation BNF (Backus-Naur) (ABNF).

Paramètre	Définition	Définition et exemple ABNF	Détails
cp	Point central	cp = "cp=" cpval cpval = degreeslat « ~ » degreeslon degreeslat = ["-"] 13DIGIT ["." 17DIGIT] degreeslon = ["-"] 12DIGIT ["." 17DIGIT] Exemple : cp=40.726966~-74.006076	Les deux valeurs doivent être exprimées en degrés décimaux et séparées par un tilde(~). Les valeurs valides de longitude sont comprises entre -180 et +180 inclus. Les valeurs valides de latitude sont comprises entre -90 et +90 inclus.
bb	Rectangle englobant	bb = "bb=" southlatitude "_" westlongitude "~" northlatitude "_" eastlongitude southlatitude = degreeslat northlatitude = degreeslat westlongitude = degreeslon eastlongitude = degreeslon degreeslat = ["-"] 13DIGIT ["." 17DIGIT] degreeslon = ["-"] 12DIGIT ["." 17DIGIT] Exemple : bb=39.719_-74.52~41.71_-73.5	Zone rectangulaire qui spécifie le rectangle englobant exprimé en degrés décimaux, à l’aide d’un tilde (~) pour séparer le coin inférieur gauche du coin supérieur droit. La latitude et la longitude pour chacune d’elles sont séparées par un trait de soulignement (_). Les valeurs valides de longitude sont comprises entre -180 et +180 inclus. Les valeurs valides de latitude sont comprises entre -90 et +90 inclus. Les paramètres cp et lvl sont ignorés lorsqu’un rectangle englobant est fourni.
where	Emplacement	where = "where=" whereval whereval = 1( ALPHA / DIGIT / "-" / "." / "_" / pct-encoded / "!" / "$" / "'" / "(" / ")" / "" / "+" / "," / ";" / ":" / "@" / "/" / "?") Exemple : where=1600%20Pennsylvania%20Ave,%20Washington,%20DC	Terme de recherche d’un emplacement, d’un repère ou d’un lieu spécifique.
t	Terme de requête	q = « q= » whereval Exemple : q=mexican%20restaurants	Terme de recherche pour les entreprises locales ou la catégorie d’entreprises.
lvl	Niveau de zoom	lvl = "lvl=" 12DIGIT ["." 12DIGIT] Exemple : lvl=10.50	Définit le niveau de zoom de la vue cartographique. Les valeurs valides sont 1 à 20, où 1 est zoomé jusqu’à la sortie.
sty	Style	sty = "sty=" ("a" / "r"/"3d") Exemple : sty=a	Définit le style de carte. Les valeurs valides pour ce paramètre incluent : a : Afficher une vue aérienne de la carte. r : afficher une vue routière de la carte. 3d : Afficher une vue 3D de la carte. Utilisez conjointement avec le paramètre cp et éventuellement avec le paramètre rad. Dans Windows 10, les styles de vue aérienne et 3D sont identiques. Notez que l’omission du paramètre sty produit les mêmes résultats que sty=r.
rad	Rayon	rad = "rad=" 1*8DIGIT Exemple : rad=1000	Zone circulaire qui spécifie la vue cartographique souhaitée. La valeur du rayon est mesurée en mètres.
pit	Tangage	pit = "pit=" pitch Exemple : pit=60	Indique l’angle auquel la carte est vue, où 90 regarde l’horizon (maximum) et 0 regarde droit vers le bas (minimum). Les valeurs de langage valides sont comprises entre 0 et 90 inclus.
hdg	Direction	hdg = "hdg=" heading Exemple : hdg=180	Indique la direction de la carte en degrés, où 0 ou 360 = Nord, 90 = Est, 180 = Sud et 270 = Ouest.
ss	Streetside	ss = "ss=" BIT Exemple : ss=1	Indique que l’imagerie au niveau de la rue est affichée lorsque `ss=1`. L’omission du paramètre ss produit le même résultat que `ss=0`. Utilisez conjointement avec le paramètre cp pour spécifier l’emplacement de la vue au niveau de la rue. Notez que l’imagerie au niveau de la rue n’est pas disponible dans toutes les régions.
trfc	Trafic	trfc = "trfc=" BIT Exemple : trfc=1	Spécifie si les informations de trafic sont incluses sur la carte. L’omission du paramètre trfc produit les mêmes résultats que `trfc=0`. Notez que les données de trafic ne sont pas disponibles dans toutes les régions.
rtp	Route	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 / "!" / "$" / "'" / "(" / ")" / "" / "+" / "," / ";" / ":" / "@" / "/" / "?") Exemples : rtp=adr. Mountain%20View,%20CA~adr. SFO rtp=adr.One%20Microsoft%20Way,%20Redmond,%20WA~pos.45.23423_-122.1232_My%20Picnic%20Spot	Définit le début et la fin d’une route à dessiner sur la carte, séparées par un tilde (~). Chacun des points de route est défini par une position à l’aide de la latitude, la longitude, ainsi que d’un titre facultatif ou d’un identifiant d’adresse. Un itinéraire complet contient exactement deux points de route. Par exemple, un itinéraire avec deux points de route est défini par `rtp="A"~"B"`. Il est également acceptable de spécifier un itinéraire incomplet. Par exemple, vous ne pouvez définir que le début d’une route avec `rtp="A"~`. Dans ce cas, l’entrée de direction s’affiche avec le point de route fourni dans le champ De et le champ À a le focus. Si seule la fin d’une route est spécifiée, comme avec `rtp=~"B"`, le panneau directions s’affiche avec le point de route fourni dans le champ À. Si un emplacement actuel précis est disponible, l’emplacement actuel est prérempli dans le champ De avec focus. Aucune ligne d’itinéraire n’est dessinée lorsqu’une route incomplète est donnée. Utilisez conjointement avec le paramètre de mode pour spécifier le mode de transport (conduite, transport public ou marche). Si le mode n’est pas spécifié, les instructions sont fournies à l’aide du mode de transport de l’utilisateur. Notez qu’un titre peut être utilisé pour un emplacement si l’emplacement est spécifié par la valeur du paramètre pos. Au lieu d’afficher la latitude et la longitude, le titre s’affiche.
mode	Mode de transport	mode = "mode=" ("d" / "t" / "w") Exemple : mode=d	Définit le mode de transport. Les valeurs valides pour ce paramètre incluent : d : Affiche la vue d’ensemble de l’itinéraire pour les itinéraires voiture t : affiche la vue d’ensemble de l’itinéraire pour les itinéraires de transit w : Affiche la vue d’ensemble de l’itinéraire pour les itinéraires piéton Utilisez conjointement avec le paramètre rtp pour les itinéraires de transport. Si le mode n’est pas spécifié, les instructions sont fournies à l’aide du mode de transport de l’utilisateur. Un mode peut être fourni sans paramètre d’itinéraire pour entrer des instructions pour ce mode à partir de l’emplacement actuel.
collection	Collection	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 Exemple : collection=name.My%20Trip%20Stops~point.36.116584_-115.176753_Las%20Vegas~point.37.8268_-122.4798_Golden%20Gate%20Bridge	Collection de points à ajouter à la carte et à la liste. La collection de points peut être nommée à l’aide du paramètre name. Un point est spécifié à l’aide d’une latitude, d’une longitude et d’un titre facultatif. Nom distinct et points multiples avec tildes (~). Si l’élément que vous spécifiez contient un tilde, vérifiez que le tilde est encodé en tant que `%7E`. S’il n’est pas accompagné de paramètres de point central et de niveau de zoom, la collection fournit la meilleure vue cartographique. Important Si l’article que vous spécifiez contient un trait de soulignement, vérifiez que le trait de soulignement est doublement encodé en tant que %255F.

ms-drive-to: référence de paramètre

L’URI permettant de lancer une requête pour les directions voiture étape par étape n’a pas besoin d’être encodé et a le format suivant.

Notez que vous ne spécifiez pas le point de départ de ce schéma d’URI. Le point de départ est toujours supposé être l’emplacement actuel. Si vous devez spécifier un point de départ autre que l’emplacement actuel, consultez Les directions d’affichage et le trafic.

Paramètre	Définition	Exemple	Détails
destination.latitude	Latitude de destination	Exemple : destination.latitude=47.6451413797194	La latitude de la destination. Les valeurs valides de latitude sont comprises entre -90 et +90 inclus.
destination.longitude	Longitude de destination	Exemple : destination.longitude=-122.141964733601	La longitude de la destination. Les valeurs valides de longitude sont comprises entre -180 et +180 inclus.
destination.name	Nom de la destination	Exemple : destination.name=Redmond, WA	Nom de la destination. Vous n’avez pas besoin d’encoder la valeur destination.name.

ms-walk-to: référence de paramètre

L’URI permettant de lancer une requête pour les itinéraires piéton étape par étape n’a pas besoin d’être encodé et a le format suivant.