Can Azure Maps static image API support sas token added as request parameter instead of header.

Question

Can Azure Maps static image API support sas token added as request parameter instead of header.

Tongchen Gu 0 Microsoft Employee

We’re using a SAS token to authenticate Azure Maps API calls. However, the Static Image API cannot be used as the src of an <img> element because it requires authentication headers. Is it possible to include the SAS token in the request URL parameters so that we can render the image directly using an <img> element ?

Tongchen Gu 0 Reputation points Microsoft Employee

2025-11-19T10:05:42.4866667+00:00

Thanks for your answer, but my question is that is it possible to append the sas token as a URL parameter instead of add the token into the Authorization header?
Anshika Varshney 3,795 Reputation points Microsoft External Staff Moderator

2025-11-20T08:45:40.97+00:00

Hi Tongchen Gu ,

Thanks for the follow-up.

For Azure Maps Static Image API, it is not possible to pass the SAS token as a URL parameter. The service only supports SAS authentication through the Authorization header.

This is a design limitation of the Static Image API, and because <img> tags cannot send custom headers, you won’t be able to call the API directly from the browser using a query-string token.

If you need to load the image in the UI, the common workaround is to use a server-side proxy that adds the Authorization header and returns the image to your front-end.

Hope this clarifies the behavior.
Anshika Varshney 3,795 Reputation points Microsoft External Staff Moderator

2025-11-25T05:16:09.97+00:00

Hi Tongchen Gu ,

Did you get any chance to review the above response.

Thank you!

2 answers

Your answer

Tongchen Gu 0 Reputation points Microsoft Employee

2025-11-19T10:05:42.4866667+00:00

Thanks for your answer, but my question is that is it possible to append the sas token as a URL parameter instead of add the token into the Authorization header?
Anshika Varshney 3,795 Reputation points Microsoft External Staff Moderator

2025-11-20T08:45:40.97+00:00

Hi Tongchen Gu ,

Thanks for the follow-up.

For Azure Maps Static Image API, it is not possible to pass the SAS token as a URL parameter. The service only supports SAS authentication through the Authorization header.

This is a design limitation of the Static Image API, and because <img> tags cannot send custom headers, you won’t be able to call the API directly from the browser using a query-string token.

If you need to load the image in the UI, the common workaround is to use a server-side proxy that adds the Authorization header and returns the image to your front-end.

Hope this clarifies the behavior.
Anshika Varshney 3,795 Reputation points Microsoft External Staff Moderator

2025-11-25T05:16:09.97+00:00

Hi Tongchen Gu ,

Did you get any chance to review the above response.

Thank you!

Answer 1

Anshika Varshney 3,795 Microsoft External Staff Moderator

Hi Tongchen Gu ,
Yes you can use a SAS token to authenticate requests to the Azure Maps Static Image API. Just make sure to generate the SAS token properly (with correct permissions, rate limit, and allowed regions), and send it in the Authorization header as jwt-sas <token>.
Please let me know if there are any remaining questions or additional details, I can help with, I’ll be glad to provide further clarification or guidance.

Thankyou!

Anshika Varshney 3,795 Reputation points Microsoft External Staff Moderator

2025-11-26T04:58:23.67+00:00

Hi Tongchen Gu ,

I’ve converted my earlier comment into an answer, could you please take a moment to mark it as Accepted? This helps others in the community with the same question find the solution more easily.

Answer 2

The Azure Maps Static Image API requires authentication headers, specifically the Authorization header with the SAS token, and does not support including the SAS token as a request parameter in the URL. Therefore, you cannot use the Static Image API as the src of an <img> element directly without including the required authentication headers. This means that rendering the image directly in an <img> tag with a SAS token in the URL parameters is not possible.

References:

Share via

Can Azure Maps static image API support sas token added as request parameter instead of header.

2 answers

Your answer