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.
- Sign in to the Azure portal. If you don't have an Azure subscription, create a free account before you begin.
- Make an Azure Maps account
- Obtain a primary subscription key, also known as the primary key or the subscription key. 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 additional 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||✓|
|Spatial Data Services (SDS)||Partial|
|Configuration driven maps||N/A|
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 with regard to 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 (included in the Microsoft Online Services Terms)
- Choose the right pricing tier in Azure Maps
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 https://azure.com.
- Create an Azure Maps account (documentation) and authentication key or Azure Active Directory (documentation).
- 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 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 is a list of useful technical resources for Azure Maps.
- Overview: https://azure.com/maps
- Documentation: https://aka.ms/AzureMapsDocs
- Web SDK Code Samples: https://aka.ms/AzureMapsSamples
- Developer Forums: https://aka.ms/AzureMapsForums
- Videos: https://aka.ms/AzureMapsVideos
- Blog: https://aka.ms/AzureMapsBlog
- Azure Maps Feedback (UserVoice): https://aka.ms/AzureMapsFeedback
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: