Como posso usar o serviço Azure Map para obter uma miniatura?

O serviço de mapa estático para Azure Maps e muitas outras plataformas de mapas (Big Maps, Google Maps, Mapbox...) utilizam níveis de zoom inteiros para dimensionamento com base no esquema de mosaico quadtree, conforme documentado aqui: https://learn.microsoft.com/ en-us/azure/azure-maps/zoom-levels-and-tile-grid?tabs=csharp Portanto, usar esses serviços não permitirá que você obtenha uma imagem que represente uma área de exatamente 160 quilômetros x 160 quilômetros, mas você pode obtenha uma escala semelhante com base na escala de nível de zoom. 100 milhas equivalem a 160.934,4 metros e, dado um tamanho de imagem de 256 pixels, isso resultaria em 628,65 metros por pixel. Com base na documentação fornecida acima, o nível de zoom 8 provavelmente seria o mais próximo (são 611 metros por pixel no equador, você pode tentar o nível de zoom 7 se quiser mostrar mais área).

Agora que você tem um nível de zoom para trabalhar, você pode pegar seu ponto central e usar o serviço para criar facilmente sua imagem com um alfinete conforme a documentação:

https://learn.microsoft.com/en-us/rest/api/maps/render-v2/get-map-static-image?view=rest-maps-2022-08-01&tabs=HTTP

O formato de imagem retornado pelo serviço é PNG, não há opção BMP, mas isso não deve ser um grande problema, pois você pode facilmente converter para esse formato via código se realmente precisar de BMP.

Para centralizar você usaria o centerparâmetro de consulta. que assume um valor "Longitude, Latitude".

Para adicionar um alfinete ao centro, você usaria a mesma coordenada e o pinsparâmetro de consulta. Existem muitas opções para personalizar a forma como o alfinete aparece no mapa, então você precisará consultar a documentação para personalizar da maneira que desejar.

Aqui está um exemplo simples que cria um mapa sobre Seattle (Lat: 47.612965, Lon: -122.338000) no nível de zoom 8 e adiciona o ícone de alfinete padrão ao centro. A largura/altura está definida para 256 pixels. Além disso, eu configurei o

https://atlas.microsoft.com/map/static/png?api-version=2022-08-01&layer=basic&style=main&zoom=8&center=-122.338000,47.612965&height=256&width=256&pins=default||-122.338000%2047.612965&subscription-key=<Your Azure Maps Key>

Esta é a aparência da imagem gerada:

Agora, com tudo isso dito, se você for exibir isso em uma página da Web, recomendo fortemente considerar o uso do Web SDK interativo, pois ele usará blocos de mapas que são armazenados em cache no navegador do usuário e gerariam significativamente menos transações ao longo do tempo. Um pequeno mapa interativo usando blocos geraria uma fração de transações na primeira vez que fosse carregado e nenhuma transação por um período de tempo devido ao armazenamento em cache dos blocos (mesmo se o usuário fechasse o navegador e voltasse dias depois). Ao usar o serviço de mapa estático, geraria uma transação com cada solicitação (cada vez que a imagem fosse carregada/exibida) e não poderia ser armazenada em cache de acordo com os termos de serviço. Você também tem muito mais opções de estilo ao usar o controle de mapa interativo e também tem acesso a imagens de satélite, se desejar.