Skip to content

Commit 396df7a

Browse files
committed
Remove maps app launch page and add deprecation
Remove maps app URI launch page and add deprecation note to other pages that referenced it.
1 parent 18658ea commit 396df7a

File tree

8 files changed

+21
-21
lines changed

8 files changed

+21
-21
lines changed

.openpublishing.redirection.json

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8762,7 +8762,7 @@
87628762
},
87638763
{
87648764
"source_path": "uwp/launch-resume/launch-maps-app.md",
8765-
"redirect_url": "/windows/apps/develop/launch/launch-maps-app",
8765+
"redirect_url": "/windows/apps/develop/launch/launch-default-app",
87668766
"redirect_document_id": false
87678767
},
87688768
{
@@ -8889,6 +8889,11 @@
88898889
"source_path": "hub/apps/develop/actions/index.md",
88908890
"redirect_url": "/windows/ai/app-actions/",
88918891
"redirect_document_id": false
8892+
},
8893+
{
8894+
"source_path": "hub/apps/develop/launch/launch-maps-app.md",
8895+
"redirect_url": "/windows/apps/develop/launch/launch-default-app",
8896+
"redirect_document_id": false
88928897
}
88938898
]
88948899
}

hub/apps/develop/launch/index.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,6 @@ This section describes how to use a URI to launch your Windows app.
2323
| [Launch an app for results](/windows/uwp/launch-resume/how-to-launch-an-app-for-results) | Learn how to launch an app from another app and exchange data between the two. This is called launching an app for results. |
2424
| [Launch the Windows Settings app](launch-settings-app.md) | Learn how to launch the Windows Settings app from your app. This topic describes the ms-settings URI scheme. Use this URI scheme to launch the Windows Settings app to specific settings pages. |
2525
| [Launch the Microsoft Store app](launch-store-app.md) | This topic describes the ms-windows-store URI scheme. Your app can use this URI scheme to launch the Microsoft Store app to specific pages in the Store. |
26-
| [Launch the Windows Maps app](launch-maps-app.md) | Learn how to launch the Windows Maps app from your app. |
2726
| [Launch the People app](launch-people-app.md) | This topic describes the ms-people URI scheme. Your app can use this URI scheme to launch the People app for specific actions. |
2827
| [Launch screen snipping](launch-screen-snipping.md) | Learn how to use URI schemes to open a new snip, or to open the Snip & Sketch app. |
2928
| [Enable apps for websites using app URI handlers](web-to-app-linking.md) | Drive user engagement with your app by supporting the Apps for Websites feature. |

hub/apps/develop/launch/launch-default-app.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -160,13 +160,18 @@ Use the **http:** URI scheme to launch the default web browser.
160160

161161
### Maps app URI schemes
162162

163-
Use the **bingmaps:**, **ms-drive-to:**, and **ms-walk-to:** URI schemes to [launch the Windows Maps app](launch-maps-app.md) to specific maps, directions, and search results. For example, the following URI opens the Windows Maps app and displays a map centered over New York City.
163+
> [!IMPORTANT]
164+
> The Windows Maps app is deprecated and will be removed from the Microsoft Store by July 2025. At this time, there will also be a final update to the app from the Store that makes it nonfunctional. If you remove the app before July 2025, you can still reinstall it from the Store, but past July 2025 you won't be able to reinstall it.
165+
>
166+
> For more inforatmion, see [Resources for deprecated features - Maps app](/windows/whats-new/deprecated-features-resources#maps-app).
167+
168+
Use the **bingmaps:**, **ms-drive-to:**, and **ms-walk-to:** URI schemes to launch the Windows Maps app to specific maps, directions, and search results. For example, the following URI opens the Windows Maps app and displays a map centered over New York City.
164169

165170
`bingmaps:?cp=40.726966~-74.006076`
166171

167172
:::image type="content" source="images/mapnyc.png" alt-text="A screenshot of the Windows Maps app.":::
168173

169-
For more info, see [Launch the Windows Maps app](launch-maps-app.md). To use the map control in your UWP app, see [Display maps with 2D, 3D, and Streetside views](/windows/uwp/maps-and-location/display-maps). If you're using Windows App SDK 1.5 or later in a WinUI app or other desktop app, you can use the [MapControl](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.mapcontrol).
174+
To use the map control in your UWP app, see [Display maps with 2D, 3D, and Streetside views](/windows/uwp/maps-and-location/display-maps). If you're using Windows App SDK 1.5 or later in a WinUI app or other desktop app, you can use the [MapControl](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.mapcontrol).
170175

171176
### Messaging app URI scheme
172177

hub/apps/toc.yml

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -76,8 +76,6 @@ items:
7676
href: develop/launch/launch-default-apps-settings.md
7777
- name: Launch the Microsoft Store app
7878
href: develop/launch/launch-store-app.md
79-
- name: Launch the Windows Maps app
80-
href: develop/launch/launch-maps-app.md
8179
- name: Launch Snipping Tool
8280
href: develop/launch/launch-snipping-tool.md
8381
items:

uwp/launch-resume/index.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,6 @@ The **Launch an app with a URI** section details how to use a Uniform Resource I
5252
| [Choose and save tones using the ms-tonepicker URI scheme](launch-ringtone-picker.md) | This topic describes the ms-tonepicker URI scheme and how to use it to display a tone picker to select a tone, save a tone, and get the friendly name for a tone. |
5353
| [Launch the Windows Settings app](/windows/apps/develop/launch/launch-settings-app) | Learn how to launch the Windows Settings app from your app. This topic describes the ms-settings URI scheme. Use this URI scheme to launch the Windows Settings app to specific settings pages. |
5454
| [Launch the Microsoft Store app](/windows/apps/develop/launch/launch-store-app) | This topic describes the ms-windows-store URI scheme. Your app can use this URI scheme to launch the UWP app to specific pages in the Store. |
55-
| [Launch the Windows Maps app](/windows/apps/develop/launch/launch-maps-app) | Learn how to launch the Windows Maps app from your app. |
5655
| [Launch the People app](/windows/apps/develop/launch/launch-people-app) | This topic describes the ms-people URI scheme. Your app can use this URI scheme to launch the People app for specific actions. |
5756
| [Support web-to-app linking with app URI handlers](/windows/apps/develop/launch/web-to-app-linking) | Drive user engagement with your app by using app URI handlers. |
5857

uwp/maps-and-location/display-maps.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -90,9 +90,6 @@ Use a map control to show rich and customizable map data in your app. A map cont
9090

9191
Use a map control when you want a map within your app that allows users to view app-specific or general geographic information. Having a map control in your app means that users don't have to go outside your app to get that information.
9292

93-
> [!NOTE]
94-
> If you don't mind users going outside your app, consider using the Windows Maps app to provide that information. Your app can launch the Windows Maps app to display specific maps, directions, and search results. For more info, see [Launch the Windows Maps app](/windows/apps/develop/launch/launch-maps-app).
95-
9693
### Add a map control to your app
9794

9895
Display a map on a XAML page by adding a [**MapControl**](/uwp/api/Windows.UI.Xaml.Controls.Maps.MapControl). To use the **MapControl**, you must declare the [**Windows.UI.Xaml.Controls.Maps**](/uwp/api/Windows.UI.Xaml.Controls.Maps) namespace in the XAML page or in your code. If you drag the control from the Toolbox, this namespace declaration is added automatically. If you add the **MapControl** to the XAML page manually, you must add the namespace declaration manually at the top of the page.

uwp/maps-and-location/index.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,13 @@
11
---
22
title: Maps and location overview
3-
description: This section explains how you can display maps, use map services, find the location, and set up a geofence in your app. This section also shows you how to launch the Windows Maps app to a specific map, route, or a set of turn-by-turn directions.
3+
description: This section explains how you can display maps, use map services, find the location, and set up a geofence in your app.
44
ms.assetid: F4C1F094-CF46-4B15-9D80-C1A26A314521
55
ms.date: 05/27/2025
66
ms.topic: article
77
keywords: windows 10, uwp, map, location, map services
88
ms.localizationpriority: medium
99
---
10+
1011
# Maps and location overview
1112

1213
> [!IMPORTANT]
@@ -19,7 +20,12 @@ ms.localizationpriority: medium
1920
>
2021
> For more information, see the [Bing Maps Developer Center](https://www.bingmapsportal.com/) and [Bing Maps documentation](/bingmaps/getting-started/).
2122
22-
This section explains how you can display maps, use map services, find the location, and set up a geofence in your app. This section also shows you how to launch the Windows Maps app to a specific map, route, or a set of turn-by-turn directions.
23+
> [!IMPORTANT]
24+
> The Windows Maps app is deprecated and will be removed from the Microsoft Store by July 2025. At this time, there will also be a final update to the app from the Store that makes it nonfunctional. If you remove the app before July 2025, you can still reinstall it from the Store, but past July 2025 you won't be able to reinstall it.
25+
>
26+
> For more inforatmion, see [Resources for deprecated features - Maps app](/windows/whats-new/deprecated-features-resources#maps-app).
27+
28+
This section explains how you can display maps, use map services, find the location, and set up a geofence in your app.
2329

2430
[**MapControl**](/uwp/api/Windows.UI.Xaml.Controls.Maps.MapControl) and map services require a maps authentication key called a [**MapServiceToken**](/uwp/api/windows.ui.xaml.controls.maps.mapcontrol.mapservicetoken). For more info about getting and setting a maps authentication key, see [Request a maps authentication key](authentication-key.md).
2531

@@ -59,12 +65,6 @@ Get the user's current location and be notified when the location changes in you
5965
| [Design guidance for geofencing](guidelines-for-geofencing.md) | Performance guidelines for apps that utilize the geofencing feature. |
6066
| [Set up a geofence](set-up-a-geofence.md) | Set up a geofence in your app, and learn how to handle notifications in the foreground and background. |
6167

62-
## Launch the Windows Maps app
63-
64-
Your app can launch the Windows Maps app as shown here to display specific maps and turn-by-turn directions. Rather than provide map functionality directly in your own app, consider using the Windows Maps app to provide that functionality. For more info, see [Launch the Windows Maps app](/windows/apps/develop/launch/launch-maps-app).
65-
66-
![an example of the windows maps app.](images/mapnyc.png)
67-
6868
## Related topics
6969

7070
* [UWP map sample](https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/MapControl)

uwp/maps-and-location/routes-and-directions.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -24,9 +24,6 @@ ms.localizationpriority: medium
2424
2525
Request routes and directions, and display them in your app.
2626

27-
> [!NOTE]
28-
> If mapping isn't a core feature of your app, consider launching the Windows Maps app instead. You can use the `bingmaps:`, `ms-drive-to:`, and `ms-walk-to:` URI schemes to launch the Windows Maps app to specific maps and turn-by-turn directions. For more info, see [Launch the Windows Maps app](/windows/apps/develop/launch/launch-maps-app).
29-
3027
## An intro to MapRouteFinder results
3128

3229
Here's how the classes for routes and directions are related:

0 commit comments

Comments
 (0)