Launch the Windows Maps app

Artikel
01/04/2023

Learn how to launch the Windows Maps app from your app. This topic describes the bingmaps:, ms-drive-to:, ms-walk-to:, and ms-settings: Uniform Resource Identifier (URI) schemes. Use these URI schemes to launch the Windows Maps app to specific maps, directions, and search results or to download Windows Maps offline maps from the Settings app.

Tip To learn more about launching the Windows Maps app from your app, download the Universal Windows Platform (UWP) map sample from the Windows-universal-samples repo on GitHub.

Introducing URIs

URI schemes let you open apps by clicking hyperlinks (or programmatically, in your app). Just as you can start a new email using mailto: or open a web browser using http:, you can open the Windows maps app using bingmaps:, ms-drive-to:, and ms-walk-to:.

The bingmaps: URI provides maps for locations, search results, directions, and traffic.
The ms-drive-to: URI provides turn-by-turn driving directions from your current location.
The ms-walk-to: URI provides turn-by-turn walking directions from your current location.

For example, the following URI opens the Windows Maps app and displays a map centered over New York City.

<bingmaps:?cp=40.726966~-74.006076>

a map centered over new york city.

Here is a description of the URI scheme:

bingmaps:?query

In this URI scheme, query is a series of parameter name/value pairs:

&param1=value1&param2=value2 …

For a full list of the available parameters, see the bingmaps:, ms-drive-to:, and ms-walk-to: parameter reference. There are also examples later in this topic.

Launch a URI from your app

To launch the Windows Maps app from your app, call the LaunchUriAsync method with a bingmaps:, ms-drive-to:, or ms-walk-to: URI. The following example launches the same URI from the previous example. For more info about launching apps via URI, see Launch the default app for a 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 this example, the LauncherOptions class is used to help ensure the Windows Maps app is launched.

Display known locations

There are many options to control which part of the map to show. You can use the cp (center point) parameter with either the rad (radius) or the lvl (zoom level) parameters to show a location and choose how close to zoom in to it. When you use the cp parameter, you can also specify a hdg (heading) and pit (pitch) to control what direction to look. Another method is to use the bb (bounding box) parameter to provide the maximum south, east, north, and west coordinates of the area you want to show.

To control the type of view, use the sty (style) and ss (Streetside) parameters. The sty parameter lets you switch between road and aerial views. The ss parameter puts the map into a Streetside view. For more info about these and other parameters, see the bingmaps: parameter reference.

Sample URI	Results
bingmaps:?	Opens the Maps app.
bingmaps:?cp=40.726966~-74.006076	Displays a map centered over New York City.
bingmaps:?cp=40.726966~-74.006076&lvl=10	Displays a map centered over New York City with a zoom level of 10.
bingmaps:?bb=39.719_-74.52~41.71_-73.5	Displays a map of New York City, which is the area specified in the bb argument.
bingmaps:?bb=39.719_-74.52~41.71_-73.5&cp=47~-122	Displays a map of New York City, which is the area specified in the bounding box argument. The center point for Seattle specified in the cp argument is ignored because bb is specified.
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace&lvl=16	Displays a map with a point named Caesars Palace (in Las Vegas) and sets the zoom level to 16.
bingmaps:?collection=point.40.726966_-74.006076_Some%255FBusiness	Displays a map with a point named Some_Business (in Las Vegas).
bingmaps:?cp=40.726966~-74.006076&trfc=1&sty=a	Displays a map of New York City with traffic on and aerial map style.
bingmaps:?cp=47.6204~-122.3491&sty=3d	Displays a 3D view of the Space Needle.
bingmaps:?cp=47.6204~-122.3491&sty=3d&rad=200&pit=75&hdg=165	Displays a 3D view of the Space Needle with a radius of 200m, a pitch of 75 degrees, and a heading of 165 degrees.
bingmaps:?cp=47.6204~-122.3491&ss=1	Displays a Streetside view of the Space Needle.

Display search results

When searching for places using the q parameter, we recommend making the terms as specific as possible and using the cp, bb, or where parameters to specify a search location. If you do not specify a search location and the user's current location isn't available, the search may not return meaningful results. Search results are displayed in the most appropriate map view. For more info about these and other parameters, see the bingmaps: parameter reference.

Sample URI	Results
bingmaps:?q=1600%20Pennsylvania%20Ave,%20Washington,%20DC	Displays a map and searches for the address of the White House in Washington, D.C.
bingmaps:?q=coffee&where=Seattle	Searches for coffee in Seattle.
bingmaps:?cp=40.726966~-74.006076&where=New%20York	Searches for New York near the specified center point.
bingmaps:?bb=39.719_-74.52~41.71_-73.5&q=pizza	Searches for pizza in the specified bounding box (that is, in New York City).

Display multiple points

Use the collection parameter to show a custom set of points on the map. If there is more than one point, a list of points is displayed. There can be up to 25 points in a collection and they are listed in the order provided. The collection takes precedence over search and directions requests. For more info about this parameter and others, see the bingmaps: parameter reference.

Sample URI	Results
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace	Searches for Caesar's Palace in Las Vegas and displays the results on a map in the best map view.
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace&lvl=16	Displays a pushpin named Caesars Palace in Las Vegas and zooms to level 16.
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace~point.36.113126_-115.175188_The%20Bellagio&lvl=16&cp=36.114902~-115.176669	Displays a pushpin named Caesars Palace and a pushpin named The Bellagio in Las Vegas and zooms to level 16.
bingmaps:?collection=point.40.726966_-74.006076_Fake%255FBusiness%255Fwith%255FUnderscore	Displays New York with a pushpin named 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	Displays a list named Hotel List and two pushpins for Caesars Palace and The Bellagio in Las Vegas and zooms to level 16.

Display directions and traffic

You can display directions between two points using the rtp parameter; those points can be either addresses or latitude and longitude coordinates. Use the trfc parameter to show traffic information. To specify the type of directions: driving, walking, or transit, use the mode parameter. If mode isn't specified, directions will be provided using the user's preferred mode of transportation. For more info about these parameters and others, see the bingmaps: parameter reference.

an example of directions

Sample URI	Results
bingmaps:?rtp=pos.44.9160_-110.4158~pos.45.0475_-109.4187	Displays a map with point-to-point directions. Because mode is not specified, directions will be provided using the user's mode of transportation preference.
bingmaps:?cp=43.0332~-87.9167&trfc=1	Displays a map centered over Milwaukee, WI with traffic.
bingmaps:?rtp=adr.One Microsoft Way, Redmond, WA 98052~pos.39.0731_-108.7238	Displays a map with directions from the specified address to the specified location.
bingmaps:?rtp=adr.1%20Microsoft%20Way,%20Redmond,%20WA,%2098052~pos.36.1223_-111.9495_Grand%20Canyon%20northern%20rim	Displays directions from 1 Microsoft Way, Redmond, WA, 98052 to the Grand Canyon's northern rim.
bingmaps:?rtp=adr.Davenport, CA~adr.Yosemite Village	Displays a map with driving directions from the specified location to the specified landmark.
bingmaps:?rtp=adr.Mountain%20View,%20CA~adr.San%20Francisco%20International%20Airport,%20CA&mode=d	Displays driving directions from Mountain View, CA to San Francisco International Airport, CA.
bingmaps:?rtp=adr.Mountain%20View,%20CA~adr.San%20Francisco%20International%20Airport,%20CA&mode=w	Displays walking directions from Mountain View, CA to San Francisco International Airport, CA.
bingmaps:?rtp=adr.Mountain%20View,%20CA~adr.San%20Francisco%20International%20Airport,%20CA&mode=t	Displays transit directions from Mountain View, CA to San Francisco International Airport, CA.

Display turn-by-turn directions

The ms-drive-to: and ms-walk-to: URI schemes let you launch directly into a turn-by-turn view of a route. These URI schemes can only provide directions from the user's current location. If you must provide directions between points that do not include the user's current location, use the bingmaps: URI scheme as described in the previous section. For more info about these URI schemes, see the ms-drive-to: and ms-walk-to: parameter reference.

Important When the ms-drive-to: or ms-walk-to: URI schemes are launched, the Maps app will check to see if the device has ever had a GPS location fix. If it has, then the Maps app will proceed to turn-by-turn directions. If it hasn't, the app will display the route overview, as described in Display directions and traffic.

an example of turn-by-turn directions

Sample URI	Results
ms-drive-to:?destination.latitude=47.680504&destination.longitude=-122.328262&destination.name=Green Lake	Displays a map with turn-by-turn driving directions to Green Lake from your current location.
ms-walk-to:?destination.latitude=47.680504&destination.longitude=-122.328262&destination.name=Green Lake	Displays a map with turn-by-turn walking directions to Green Lake from your current location.

Download offline maps

The ms-settings: URI scheme lets you launch directly into a particular page in the Settings app. While the ms-settings: URI scheme doesn't launch into the Maps app, it does allow you to launch directly to the Offline Maps page in the Settings app and displays a confirmation dialog to download the offline maps used by the Maps app. The URI scheme accepts a point specified by a latitude and longitude and automatically determines if there are offline maps available for a region containing that point. If the latitude and longitude passed happen to fall within multiple download regions, the confirmation dialog will let the user pick which of those regions to download. If offline maps are not available for a region containing that point, the offline Maps page in the Settings app is displayed with an error dialog.

Sample URI	Results
ms-settings:maps-downloadmaps?latlong=47.6,-122.3	Opens the Settings app to the Offline Maps page with a confirmation dialog displayed to download maps for the region containing the specified latitude-longitude point.

bingmaps: parameter reference

The syntax for each parameter in this table is shown by using Augmented Backus–Naur Form (ABNF).

Parameter	Definition	ABNF Definition and Example	Details
cp	Center point	cp = "cp=" cpval cpval = degreeslat "~" degreeslon degreeslat = ["-"] 13DIGIT ["." 17DIGIT] degreeslon = ["-"] 12DIGIT ["." 17DIGIT] Example: cp=40.726966~-74.006076	Both values must be expressed in decimal degrees and separated by a tilde(~). Valid longitude values are between -180 and +180 inclusive. Valid latitude values are between -90 and +90 inclusive.
bb	Bounding box	bb = "bb=" southlatitude "_" westlongitude "~" northlatitude "_" eastlongitude southlatitude = degreeslat northlatitude = degreeslat westlongitude = degreeslon eastlongitude = degreeslon degreeslat = ["-"] 13DIGIT ["." 17DIGIT] degreeslon = ["-"] 12DIGIT ["." 17DIGIT] Example: bb=39.719_-74.52~41.71_-73.5	A rectangular area that specifies the bounding box expressed in decimal degrees, using a tilde (~) to separate the lower left corner from the upper right corner. Latitude and longitude for each are separated with an underscore (_). Valid longitude values are between -180 and +180 inclusive. Valid latitude values are between -90 and +90 inclusive. The cp and lvl parameters are ignored when a bounding box is provided.
where	Location	where = "where=" whereval whereval = 1( ALPHA / DIGIT / "-" / "." / "_" / pct-encoded / "!" / "$" / "'" / "(" / ")" / "" / "+" / "," / ";" / ":" / "@" / "/" / "?") Example: where=1600%20Pennsylvania%20Ave,%20Washington,%20DC	Search term for a specific location, landmark or place.
q	Query Term	q = "q=" whereval Example: q=mexican%20restaurants	Search term for local business or category of businesses.
lvl	Zoom Level	lvl = "lvl=" 12DIGIT ["." 12DIGIT] Example: lvl=10.50	Defines the zoom level of the map view. Valid values are 1-20 where 1 is zoomed all the way out.
sty	Style	sty = "sty=" ("a" / "r"/"3d") Example: sty=a	Defines the map style. Valid values for this parameter include: a: Display an aerial view of the map. r: Display a road view of the map. 3d: Display a 3D view of the map. Use in conjunction with the cp parameter and optionally with the rad parameter. In Windows 10, the aerial view and 3D view styles are the same. Note Omitting the sty parameter produces the same results as sty=r.
rad	Radius	rad = "rad=" 1*8DIGIT Example: rad=1000	A circular area that specifies the desired map view. The radius value is measured in meters.
pit	Pitch	pit = "pit=" pitch Example: pit=60	Indicates the angle that the map is viewed at, where 90 is looking out at the horizon (maximum) and 0 is looking straight down (minimum). Valid pitch values are between 0 and 90 inclusive.
hdg	Heading	hdg = "hdg=" heading Example: hdg=180	Indicates the direction the map is heading in degrees, where 0 or 360 = North, 90 = East, 180 = South, and 270 = West.
ss	Streetside	ss = "ss=" BIT Example: ss=1	Indicates that street-level imagery is shown when `ss=1`. Omitting the ss parameter produces the same result as `ss=0`. Use in conjunction with the cp parameter to specify the location of the street-level view. Note Street-level imagery is not available in all regions.
trfc	Traffic	trfc = "trfc=" BIT Example: trfc=1	Specifies whether traffic information is included on the map. Omitting the trfc parameter produces the same results as `trfc=0`. Note Traffic data is not available in all regions.
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 / "!" / "$" / "'" / "(" / ")" / "" / "+" / "," / ";" / ":" / "@" / "/" / "?") Examples: rtp=adr.Mountain%20View,%20CA~adr.SFO rtp=adr.One%20Microsoft%20Way,%20Redmond,%20WA~pos.45.23423_-122.1232_My%20Picnic%20Spot	Defines the start and end of a route to draw on the map, separated by a tilde (~). Each of the waypoints is defined by either a position using ltitude, longitude, and optional title or an address identifier. A complete route contains exactly two waypoints. For example, a route with two waypoints is defined by `rtp="A"~"B"`. It's also acceptable to specify an incomplete route. For example, you can define only the start of a route with `rtp="A"~`. In this case, the directions input is displayed with the provided waypoint in the From field and the To field has focus. If only the end of a route is specified, as with `rtp=~"B"`, the directions panel is displayed with the provided waypoint in the To field. If an accurate current location is available, the current location is pre-populated in the From field with focus. No route line is drawn when an incomplete route is given. Use in conjunction with the mode parameter to specify the mode of transportation (driving, transit, or walking). If mode isn't specified, directions will be provided using the user's mode of transportation preference. Note A title can be used for a location if the location is specified by the pos parameter value. Rather than showing the latitude and longitude, the title will be displayed.
mode	Transportation mode	mode = "mode=" ("d" / "t" / "w") Example: mode=d	Defines the transportation mode. Valid values for this parameter include: d: Displays route overview for driving directions t: Displays route overview for transit directions w: Displays route overview for walking directions Use in conjunction with the rtp parameter for transportation directions. If mode isn't specified, directions will be provided using the user's mode of transportation preference. A mode can be provided with no route parameter to enter directions input for that mode from the current location.
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 Example: collection=name.My%20Trip%20Stops~point.36.116584_-115.176753_Las%20Vegas~point.37.8268_-122.4798_Golden%20Gate%20Bridge	Collection of points to be added to the map and list. The collection of points can be named using the name parameter. A point is specified using a latitude, longitude, and optional title. Separate name and multiple points with tildes (~). If the item you specify contains a tilde, make sure the tilde is encoded as `%7E`. If not accompanied by Center point and Zoom Level parameters, the collection will provide the best map view. Important If the item you specify contains an underscore, make sure the underscore is double encoded as %255F.

ms-drive-to: parameter reference

The URI to launch a request for turn-by-turn driving directions does not need to be encoded and has the following format.

Note You don’t specify the starting point in this URI scheme. The starting point is always assumed to be the current location. If you need to specify a starting point other than the current location, see Display directions and traffic.

Parameter	Definition	Example	Details
destination.latitude	Destination latitude	Example: destination.latitude=47.6451413797194	The latitude of the destination. Valid latitude values are between -90 and +90 inclusive.
destination.longitude	Destination longitude	Example: destination.longitude=-122.141964733601	The longitude of the destination. Valid longitude values are between -180 and +180 inclusive.
destination.name	Name of the destination	Example: destination.name=Redmond, WA	The name of the destination. You do not have to encode the destination.name value.

ms-walk-to: parameter reference

The URI to launch a request for turn-by-turn walking directions does not need to be encoded and has the following format.