Okapi Okapi

Azure Maps GET /map/imagery/* version retirement

Stopped workingSubscribe to Azure MapsShare

Calls to GET /map/imagery/* fail since September 17, 2026. Microsoft retired the Render 1.0 endpoint on that day, and these requests are no longer supported.


Calls it hits

  • GET /map/imagery/*

What to use instead of these calls

Call GET /map/tile?api-version=2024-04-01 with tilesetId=microsoft.imagery instead.

In Azure Maps's words

Azure Maps Render version 1.0 retired on September 17, 2026. Render 1.0 requests are no longer supported.

Azure Maps, Announcement

Facts

API
Azure Maps atlas.microsoft.com
Kind
Version retirement
Announced
September 22, 2023
Takes effect
September 17, 2026
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 GET /map/imagery/* on Azure Maps stopped working on September 17, 2026.

What happens to calls after September 17, 2026?

They have failed since September 17, 2026.

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/tile/*Version retirement Stopped working
  2. /route/directions/*Version retirement Stops workingin 511 days
  3. /route/matrix/*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

You fixed this one by hand.

Okapi opens the pull request with the fix before the next breaking change reaches your code.

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.