{"slug":"azure-maps","name":"Azure Maps","host":"atlas.microsoft.com","site":"https://microsoft.com","category":"data","docsUrl":null,"sources":[{"kind":"openapi","url":"https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/maps/data-plane/Render/stable/2024-04-01/render.json"},{"kind":"openapi","url":"https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/maps/data-plane/Route/stable/2025-01-01/route.json"},{"kind":"openapi","url":"https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/maps/data-plane/Search/stable/2026-01-01/search.json"},{"kind":"archive","url":"https://learn.microsoft.com/en-us/azure/azure-maps/migrate-render-v1-api"},{"kind":"archive","url":"https://learn.microsoft.com/en-us/rest/api/maps/route/get-route-directions?view=rest-maps-1.0"},{"kind":"archive","url":"https://learn.microsoft.com/en-us/rest/api/maps/traffic/get-traffic-flow-tile?view=rest-maps-1.0"}],"url":"https://www.okapi.bot/providers/azure-maps/","json":"https://www.okapi.bot/api/v1/providers/azure-maps.json","breakingChanges":[{"slug":"route-v1-directions-stops-working","api":"azure-maps","title":"Route v1 directions stops working","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2028-03-31","scope":null,"calls":["/route/directions/*"],"method":null,"path":"/route/directions/*","source":{"url":"https://learn.microsoft.com/en-us/rest/api/maps/route/get-route-directions?view=rest-maps-1.0","kind":"archive"},"quote":"The Azure Maps Route v1 service is now deprecated and will be retired on 3/31/28. To avoid service disruptions, all calls to Route v1 service will need to be updated to use Route v2025-01-01 service by 3/31/28.","migration":"Call POST /route/directions?api-version=2025-01-01 (GeoJSON body); batches go to /route/directions:batch.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:39:52.450Z","updatedAt":"2026-10-23T10:39:52.450Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/azure-maps/breaking-changes/route-v1-directions-stops-working/"},{"slug":"route-v1-matrix-stops-working","api":"azure-maps","title":"Route v1 matrix stops working","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2028-03-31","scope":null,"calls":["/route/matrix/*"],"method":null,"path":"/route/matrix/*","source":{"url":"https://learn.microsoft.com/en-us/rest/api/maps/route/get-route-directions?view=rest-maps-1.0","kind":"archive"},"quote":"The Azure Maps Route v1 service is now deprecated and will be retired on 3/31/28. To avoid service disruptions, all calls to Route v1 service will need to be updated to use Route v2025-01-01 service by 3/31/28.","migration":"Call POST /route/matrix?api-version=2025-01-01, or /route/matrix:async for large matrices.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:39:52.450Z","updatedAt":"2026-10-23T10:39:52.450Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/azure-maps/breaking-changes/route-v1-matrix-stops-working/"},{"slug":"route-v1-range-stops-working","api":"azure-maps","title":"Route v1 range stops working","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2028-03-31","scope":null,"calls":["/route/range/*"],"method":null,"path":"/route/range/*","source":{"url":"https://learn.microsoft.com/en-us/rest/api/maps/route/get-route-directions?view=rest-maps-1.0","kind":"archive"},"quote":"The Azure Maps Route v1 service is now deprecated and will be retired on 3/31/28. To avoid service disruptions, all calls to Route v1 service will need to be updated to use Route v2025-01-01 service by 3/31/28.","migration":"Call POST /route/range?api-version=2025-01-01.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:39:52.450Z","updatedAt":"2026-10-23T10:39:52.450Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/azure-maps/breaking-changes/route-v1-range-stops-working/"},{"slug":"traffic-v1-flow-stops-working","api":"azure-maps","title":"Traffic v1 flow stops working","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2028-03-31","scope":null,"calls":["/traffic/flow/*"],"method":null,"path":"/traffic/flow/*","source":{"url":"https://learn.microsoft.com/en-us/rest/api/maps/traffic/get-traffic-flow-tile?view=rest-maps-1.0","kind":"archive"},"quote":"The Azure Maps Traffic v1 service is now deprecated and will be retired on 3/31/28. To avoid service disruptions, all calls to Traffic v1 service will need to be updated by 3/31/28.","migration":"Draw traffic flow tiles with Render's GET /map/tile?api-version=2024-04-01 and a microsoft.traffic.flow tileset.","migrationChange":null,"needsDecision":"Traffic v1 flow segment data has no direct replacement in Traffic 2025-01-01.","text":null,"publishedAt":"2026-10-23T10:39:58.879Z","updatedAt":"2026-10-23T10:39:58.879Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/azure-maps/breaking-changes/traffic-v1-flow-stops-working/"},{"slug":"traffic-v1-incidents-stops-working","api":"azure-maps","title":"Traffic v1 incidents stops working","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2028-03-31","scope":null,"calls":["/traffic/incident/*"],"method":null,"path":"/traffic/incident/*","source":{"url":"https://learn.microsoft.com/en-us/rest/api/maps/traffic/get-traffic-flow-tile?view=rest-maps-1.0","kind":"archive"},"quote":"The Azure Maps Traffic v1 service is now deprecated and will be retired on 3/31/28. To avoid service disruptions, all calls to Traffic v1 service will need to be updated by 3/31/28.","migration":"Call GET /traffic/incident?api-version=2025-01-01; draw incident tiles with Render's /map/tile and a microsoft.traffic.incident tileset.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:39:58.879Z","updatedAt":"2026-10-23T10:39:58.879Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/azure-maps/breaking-changes/traffic-v1-incidents-stops-working/"},{"slug":"get-map-imagery-stops-working","api":"azure-maps","title":"GET /map/imagery/{} stops working","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":"2023-09-22","effectiveAt":"2026-09-17","scope":null,"calls":["GET /map/imagery/*"],"method":"GET","path":"/map/imagery/*","source":{"url":"https://learn.microsoft.com/en-us/azure/azure-maps/migrate-render-v1-api","kind":"archive"},"quote":"Azure Maps Render version 1.0 retired on September 17, 2026. Render 1.0 requests are no longer supported.","migration":"Call GET /map/tile?api-version=2024-04-01 with tilesetId=microsoft.imagery.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:40:02.897Z","updatedAt":"2026-10-23T10:40:02.897Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/azure-maps/breaking-changes/get-map-imagery-stops-working/"},{"slug":"get-map-tile-stops-working","api":"azure-maps","title":"GET /map/tile/{} stops working","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":"2023-09-22","effectiveAt":"2026-09-17","scope":null,"calls":["GET /map/tile/*"],"method":"GET","path":"/map/tile/*","source":{"url":"https://learn.microsoft.com/en-us/azure/azure-maps/migrate-render-v1-api","kind":"archive"},"quote":"Azure Maps Render version 1.0 retired on September 17, 2026. Render 1.0 requests are no longer supported.","migration":"Call GET /map/tile?api-version=2024-04-01 with a tilesetId (microsoft.base.road, microsoft.imagery…).","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:40:02.897Z","updatedAt":"2026-10-23T10:40:02.897Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/azure-maps/breaking-changes/get-map-tile-stops-working/"}]}