Azure Maps Rest API

Azure Maps is a set of mapping and geospatial services that enable developers and organizations to build intelligent location-based experiences for applications across many different industries and use cases. Use Azure Maps to bring maps, geocoding, location search, routing, real-time traffic, geolocation, time zone information and weather data into your web, mobile and server-side solutions.

The following tables show overviews of the services that Azure Maps offers:

Latest release

The most recent stable release of the Azure Maps services.

API API version Description
Data Registry 2023-06-01 Programmatically store and update geospatial data to use in spatial operations.
The Data registry service is deprecated and will be retired on 9/30/25.
Geolocation 1.0 Convert IP addresses to country/region ISO codes.
Render 2024-04-01 Get road, satellite/aerial, weather, traffic map tiles, and static map images.
Route 1.0 Calculate optimized travel times and distances between locations for multiple modes of transportation and get localized travel instructions.
Search 2023-06-01 Geocode addresses and coordinates, search for business listings and places by name or category and get administrative boundary polygons.
Spatial 2022-08-01 Use geofences, great circle distances and other spatial operations to analyze location data.
The Spatial service is deprecated and will be retired on 9/30/25.
Timezone 1.0 Get time zone and sunrise/sunset information for specified locations.
Traffic 1.0 Get current traffic information including traffic flow and traffic incident details.
Weather 1.1 Get current, forecasted, and historical weather conditions, air quality, tropical storm details and weather along a route.

Previous releases

There are previous stable releases of an Azure Maps service that are still in use. The services in these lists will generally have a more recent version available, and are slated for retirement. If using a previous release, update to the latest version before it's retired to avoid disruption of service.

Version 2022-08-01

API API version Description
Render 2022-08-01 Get road, satellite/aerial, weather, traffic map tiles, and static map images.

Version 1.0

API API version Description
Render 1.0 Get road, satellite/aerial, weather, traffic map tiles and static map images.
The Azure Maps Render v1 service is now deprecated and will be retired on 9/17/26. To avoid service disruptions, all calls to Render v1 API needs to be updated to use the latest version of the Render API by 9/17/26.
Search 1.0 Geocode addresses and coordinates, search for business listings and places by name or category and get administrative boundary polygons. This is version 1.0 of the Search service. For the latest version, see Search.

Latest preview

Prerelease version of an Azure Maps service. Preview releases contain new functionality or updates to existing functionality that will be included in a future release.

API API version Description
Route 2024-07-01-preview Returns the ideal route in GeoJSON between locations for multiple modes of transportation.

Some of the updates in this version of the Route service include:
  • New Snap to Roads API that snaps GPS data to road aligned coordinates.
  • Support for up to 50,000 cells in Route Matrix async.
  • High-definition route range polygon.
  • Routes with "via" waypoints that the route must pass through.
  • More geographies
  • More languages available for localized travel instructions.