How can be detected if a zoom level image is not available in Map Static Image?

Question

When using the Render - Get Map Static Image API (https://learn.microsoft.com/en-us/rest/api/maps/render/get-map-static-image?view=rest-maps-2025-01-01&tabs=HTTP), if the image does not exist the service returns a status code 200 and a image indicating that the image does not exist, but that makes pretty difficult to detect with code that the image is not a valid one.

For example, this is an URL request of such a case, where a static image is requested, but that zoom level do not exist:

https://atlas.microsoft.com/map/static?api-version=2024-04-01&center=1.8403012152988873,30.937338013574852&height=1280&width=1280&zoom=19&tilesetId=microsoft.imagery&subscription-key=<key>

Is there any method to being able to detect by code that the requested static image with a defined zoom level do not exist?

Can be added a parameter to the request to state that I would like to receive, for example a HTTP status 400, instead of the 200 with the default image?

Thanks in advance for any help.

Best regards

Answer 1

Hola Antonio Arias,

Bienvenido a Preguntas y respuestas de Microsoft.

Gracias por su pregunta. Esta es una situación común al trabajar con la API de imágenes estáticas de Azure Maps y comprendo la dificultad de detectar cuándo el nivel de zoom solicitado no existe.

Comportamiento actual de la API.

Al solicitar una imagen de mapa estática con un nivel de zoom que no está disponible para un conjunto de mosaicos específico (como microsoft.imagery), el servicio:

Devolverá HTTP 200 y

Devolverá un marcador de posición predeterminado de "imagen no disponible" en lugar de un error.

Actualmente, este comportamiento es predeterminado. No hay ningún parámetro ni opción de solicitud que pueda cambiar esto para que devuelva un 400 ni ningún otro estado de error.

Cómo detectar imágenes estáticas no válidas o no disponibles

Dado que la API siempre devuelve un 200, la detección debe realizarse en el lado del cliente. Los enfoques recomendados son:

1. Validar los niveles de zoom admitidos antes de realizar la solicitud

Cada conjunto de mosaicos tiene un nivel de zoom máximo admitido (que puede variar según la región).

Puede evitar llamadas innecesarias a la API:

Consultando la documentación para conocer los niveles de zoom compatibles, o

Manteniendo una tabla local de las capacidades del conjunto de mosaicos (por ejemplo, el conjunto de mosaicos de imágenes suele alcanzar un máximo de zoom de 17 a 18).

Si el zoom solicitado supera el rango del conjunto de mosaicos, puede omitir la llamada.

2. Detectar la imagen de marcador de posición mediante programación

La imagen de reserva "no disponible" tiene características consistentes. Puede detectarla:

Comparando el tamaño en bytes de la imagen devuelta

Comprobando patrones de píxeles específicos o colores dominantes

Calculando un hash (MD5/SHA) de la imagen devuelta y comparándolo con un hash conocido de la imagen de marcador de posición

Comprobando las dimensiones o los metadatos

Actualmente, esta es la forma más fiable de distinguir un mapa válido de la imagen de reserva predeterminada.

Estrategia de gestión de errores

Implemente la lógica en su aplicación para que, si la imagen devuelta coincide con las características de la imagen de reserva predeterminada, se considere una imagen no válida o no disponible.

Consulte este

Render - Get Map Static Image

Coordenadas de mosaicos

Estilos de mapa integrados admitidos en Azure Maps

Espero que le sea útil. Si tiene alguna otra pregunta, no dude en contactarnos.

¡Gracias!

Answer 2

Hola,

Muchas gracias por la respuesta.

Me surge una duda con respecto a lo que se indica:
"Manteniendo una tabla local de las capacidades del conjunto de mosaicos (por ejemplo, el conjunto de mosaicos de imágenes suele alcanzar un máximo de zoom de 17 a 18)."

¿Cómo consultar la información para rellenar esa tabla local?

Muchas gracias.

Un saludo,
Antonio