Okapi Okapi

Azure Maps /route/matrix/* version retirement

Stops workingin 511 daysSubscribe to Azure MapsShare

On March 31, 2028, the Azure Maps Route v1 service will be retired. Calls to /route/matrix/* endpoints will fail after that date. Requests must be updated to the Route v2025-01-01 service before the retirement date to avoid service disruptions.


Calls it hits

  • /route/matrix/*

What to use instead of these calls

Call POST /route/matrix?api-version=2025-01-01, or use /route/matrix:async for large matrices.

In Azure Maps's words

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.

Azure Maps, Announcement

Facts

API
Azure Maps atlas.microsoft.com
Kind
Version retirement
Takes effect
March 31, 2028
Calls after that day
Fail
Source
Announcement
Last updated
Verified
, against Azure Maps's own pages

Questions

When does this change take effect?

Calls to /route/matrix/* on Azure Maps stop working on March 31, 2028.

What happens to calls after March 31, 2028?

They fail from that day.

How do I find the calls this hits in my code?

Okapi reads your repository, finds the calls this change hits and opens a pull request with the fix. It never commits to your branches: every change comes as a pull request you review.


More from Azure Maps 6

  1. GET /map/imagery/*Version retirement Stopped working
  2. GET /map/tile/*Version retirement Stopped working
  3. /route/directions/*Version retirement Stops workingin 511 days
  4. /route/range/*Version retirement Stops workingin 511 days
  5. /traffic/flow/*Version retirement Stops workingin 511 days
  6. /traffic/incident/*Version retirement Stops workingin 511 days

Is your code calling this?

Okapi finds the calls this change hits in your repo and opens the pull request with the fix before March 31, 2028.

Add to GitHub

Get notifications

Subscribe to Azure Maps

Hear about each breaking change Azure Maps announces, in your feed reader, calendar or Slack.

1What to follow

Provider
  • Azure Maps

2Where to get it

/breaking-changes/feed.xml

Paste it into Feedly, Inoreader, NetNewsWire or any reader. New changes show up as they're announced.