Tutorial: Migrate from Bing Maps to Azure Maps
This guide provides insights on how to migrate web, mobile and server-based applications from Bing Maps to the Azure Maps platform. This guide includes comparative code samples, migration suggestions, and best practices for migrating to Azure Maps.
In this tutorial, you'll learn:
- High-level comparison for equivalent Bing Maps features available in Azure Maps.
- What licensing differences to take into consideration.
- How to plan your migration.
- Where to find technical resources and support.
If you don't have an Azure subscription, create a free Azure account before you begin.
For more information on authentication in Azure Maps, see manage authentication in Azure Maps.
Azure Maps platform overview
Azure Maps provides developers from all industries powerful geospatial capabilities, packed with the freshest mapping data available to provide geographic context for web and mobile applications. Azure Maps is an Azure One API compliant set of REST APIs for Maps, Search, Routing, Traffic, Time Zones, Geofencing, Map Data, Weather Data, and many more services accompanied by both Web and Android SDKs to make development easy, flexible, and portable across multiple platforms. Azure Maps is also available in Power BI.
High-level platform comparison
The following table provides a high-level list of Bing Maps features and the relative support for those features in Azure Maps. This list doesn’t include other Azure Maps features such as accessibility, geofencing APIs, traffic services, spatial operations, direct map tile access, and batch services.
|Bing Maps feature||Azure Maps support|
|REST Service APIs||✓|
|Directions (including truck)||✓|
|Imagery – Static Map||✓|
|Locations (forward/reverse geocoding)||✓|
|Optimized Itinerary Routes||Planned|
|Snap to roads||1|
|Spatial Data Services (SDS)||Partial|
|Configuration driven maps||N/A|
1 While there's no direct replacement for the Bing Maps Snap to road service, this functionality can be implemented using the Azure Maps Route - Get Route Directions REST API. For a complete code sample demonstrating the snap to road functionality, see the Basic snap to road logic sample that demonstrates how to snap individual points to the rendered roads on the map. Also see the Snap points to logical route path sample that shows how to snap points to the road network to form a logical path.
Bing Maps provides basic key-based authentication. Azure Maps provides both basic key-based authentication and highly secure, Azure Active Directory authentication.
When migrating to Azure Maps from Bing Maps, the following information should be considered regarding licensing.
Azure Maps charges for the usage of interactive maps based on the number of map tiles loaded, whereas Bing Maps charges for the loading of the map control (sessions). To reduce costs for developers, Azure Maps automatically caches map tiles. One Azure Maps transaction is generated for every 15 map tiles that are loaded. The interactive Azure Maps SDKs use 512-pixel tiles, and on average generates one or less transactions per page view.
Here are some licensing-related resources for Azure Maps:
- Azure Maps pricing page
- Azure pricing calculator
- Azure Maps term of use (Scroll down to the Azure Maps section)
Suggested migration plan
Here's an example of a high-level migration plan.
- Take inventory of what Bing Maps SDKs and services your application is using and verify that Azure Maps provides alternative SDKs and services for you to migrate to.
- Create an Azure subscription (if you don’t already have one) at azure.com).
- Create an Azure Maps account.
- Setup authentication using an Azure Maps subscription key or Azure Active Directory authentication.
- Migrate your application code.
- Test your migrated application.
- Deploy your migrated application to production.
Create an Azure Maps account
To create an Azure Maps account and get access to the Azure Maps platform, follow these steps:
- If you don't have an Azure subscription, create a free Azure account before you begin.
- Sign in to the Azure portal.
- Create an Azure Maps account.
- Get your Azure Maps subscription key or setup Azure Active Directory authentication for enhanced security.
Azure Maps technical resources
Here's a list of useful technical resources for Azure Maps.
- Azure Maps product page
- Azure Maps product documentation
- Azure Maps code samples
- Azure Maps developer forums
- Microsoft learning center shows
- Azure Maps Blog
- Azure Maps Feedback (UserVoice)
The following list contains common Bing Maps terms and their corresponding Azure Maps terms.
|Bing Maps Term||Azure Maps Term|
|Aerial||Satellite or Aerial|
|Directions||May also be referred to as Routing|
|Entities||Geometries or Features|
||Data source or Layer|
||XML files in the Spatial IO module|
|Ground Overlay||Image layer|
|Hybrid (in reference to map type)||Satellite with roads|
|Map Type||Map style|
|Navigation bar||Map style picker, Zoom control, Pitch control, Compass control|
|Pushpin||Bubble layer, Symbol layer, or HTML Marker|
Clean up resources
There are no resources that require cleanup.
Learn the details of how to migrate your Bing Maps application with these articles: