Exibir dados personalizados em um mapa raster

Este artigo descreve como usar o comando Obter Imagem Estática do Mapa com a funcionalidade de composição de imagem. A funcionalidade de composição de imagens dá suporte à recuperação de blocos de varredura estáticos que contêm dados personalizados e estilos diferentes.

Veja os seguintes exemplos de dados personalizados:

  • Marcadores personalizadas
  • Rótulos
  • Sobreposições de geometria

Dica

Para mostrar um mapa simples em uma página da Web, geralmente é mais econômico usar o SDK da Web dos Azure Mapas do que usar o serviço de imagem estática. O Web SDK usa mosaicos de mapa e, a menos que o usuário desloque o mapa e aumente ou diminua o zoom, geralmente será gerada apenas uma fração de uma transação por carregamento do mapa, usando o cache do navegador. O SDK Web do Azure Mapas oferece opções para desabilitar o deslocamento e o zoom. Além disso, o SDK da Web do Azure Mapas fornece um conjunto mais avançado de opções de visualização de dados do que um serviço Web de mapa estático.

Pré-requisitos

Importante

Nos exemplos de URL, substitua {Your-Azure-Maps-Subscription-key} por sua chave de assinatura do Azure Mapas.

Este artigo usa o aplicativo Bruno, mas você pode usar um ambiente de desenvolvimento de API diferente.

Obter imagem estática com marcadores e rótulos personalizados

Para obter uma imagem estática com marcadores e rótulos personalizados:

  1. No aplicativo Bruno, selecione Nova Solicitação.

  2. Defina o tipo como HTTP.

  3. Insira um Nome para a solicitação, como Obter Imagem Estática do Mapa.

  4. Selecione o método de URL HTTP GET.

  5. Insira a seguinte URL:

    https://atlas.microsoft.com/map/static?subscription-key={Your-Azure-Maps-Subscription-key}&zoom=13&tilesetId=microsoft.base.road&api-version=2024-04-01&language=en-us&center=-73.964085, 40.78477&path=lcFF0000|lw2|la0.60|ra700||-122.13230609893799 47.64599069048016&pins=custom%7Cla15+50%7Cls12%7Clc003b61%7C%7C%27Central Park%27-73.9657974+40.781971%7C%7Chttps%3A%2F%2Fsamples.azuremaps.com%2Fimages%2Ficons%2Fylw-pushpin.png
    
  6. Selecione Criar.

  7. Selecione a seta Enviar Solicitação que aparece à direita da URL da solicitação.

    A imagem a seguir é retornada:

    Um alfinete personalizado com um rótulo.

Renderize um polígono com cor e opacidade

É possível modificar a aparência de um polígono, usando modificadores de estilo com o parâmetro de caminho.

Para renderizar um polígono com cor e opacidade:

  1. No aplicativo Bruno, selecione Nova Solicitação.

  2. Defina o tipo como HTTP.

  3. Insira um Nome para a solicitação, como Obter Polígono.

  4. Selecione o método de URL HTTP GET.

  5. Insira a seguinte URL no serviço Render:

    https://atlas.microsoft.com/map/static?subscription-key={Your-Azure-Maps-Subscription-key}&zoom=15&tilesetId=microsoft.base.road&api-version=2024-04-01&language=en-us&path=lc0000FF|fc0000FF|lw3|la0.80|fa0.50||-74.03995513916016 40.70090237454063|-74.04082417488098 40.70028420372218|-74.04113531112671 40.70049568385827|-74.04298067092896 40.69899904076542|-74.04271245002747 40.69879568992435|-74.04367804527283 40.6980961582905|-74.04364585876465 40.698055487620714|-74.04368877410889 40.698022951066996|-74.04168248176573 40.696444909137|-74.03901100158691 40.69837271818651|-74.03824925422668 40.69837271818651|-74.03809905052185 40.69903971085914|-74.03771281242369 40.699340668780984|-74.03940796852112 40.70058515602143|-74.03948307037354 40.70052821920425|-74.03995513916016 40.70090237454063&pins=custom%7Cla15+50%7Cls12%7Clc003b61%7C%7C%27Central Park%27-73.9657974+40.781971%7C%7Chttps%3A%2F%2Fsamples.azuremaps.com%2Fimages%2Ficons%2Fylw-pushpin.png&center=-74.040701, 40.698666&height=500&Width=500
    

    A imagem a seguir é retornada:

    Renderizar um polígono opaco.

Renderizar um círculo e pinos com rótulos personalizados

É possível modificar a aparência dos pinos adicionando modificadores de estilo. Por exemplo, para tornar os pushpins e seus rótulos maiores ou menores, use o modificador de estilo de sc escala. Esse modificador usa um valor maior que zero. Um valor de 1 é a escala padrão. Valores maiores que 1 tornam os pinos maiores, e valores menores que 1 os tornam menores. Para obter mais informações sobre modificadores de estilo, confira o parâmetro Path do comando Obter Imagem Estática do Mapa.

Para renderizar um círculo e alfinetes com rótulos personalizados:

  1. No aplicativo Bruno, selecione Nova Solicitação.

  2. Defina o tipo como HTTP.

  3. Insira um Nome para a solicitação, como Obter Polígono.

  4. Selecione o método de URL HTTP GET.

  5. Insira a seguinte URL no serviço Render:

    https://atlas.microsoft.com/map/static?subscription-key={Your-Azure-Maps-Subscription-key}&zoom=14&tilesetId=microsoft.base.road&api-version=2024-04-01&language=en-us&center=-122.13230609893799,47.64599069048016&path=lcFF0000|lw2|la0.60|ra1000||-122.13230609893799 47.64599069048016&pins=default|la15+50|sc1|al0.66|lc003C62|co002D62||'Microsoft Corporate Headquarters'-122.14131832122801 47.64690503939462|'Microsoft Visitor Center'-122.136828 47.642224|'Microsoft Conference Center'-122.12552547454833 47.642940335653996|'Microsoft The Commons'-122.13687658309935 47.64452336193245&height=700&Width=700
    
  6. Selecione Criar.

  7. Selecione a seta Enviar Solicitação que aparece à direita da URL da solicitação.

    A imagem a seguir é retornada:

    Renderizar um círculo com marcadores personalizados.

  8. Em seguida, altere a cor dos alfinetes modificando o modificador de estilo co. Se você observar o valor do parâmetro pins (pins=default|la15+50|al0.66|lc003C62|co002D62|), note que a cor atual é #002D62. Para alterar a cor para #41d42a, substitua #002D62 por #41d42a. Agora o parâmetro pins é pins=default|la15+50|al0.66|lc003C62|co41D42A|. A solicitação é semelhante à seguinte URL:

    https://atlas.microsoft.com/map/static?subscription-key={Your-Azure-Maps-Subscription-key}&zoom=14&tilesetId=microsoft.base.road&api-version=2024-04-01&language=en-us&center=-122.13230609893799,47.64599069048016&path=lcFF0000|lw2|la0.60|ra1000||-122.13230609893799 47.64599069048016&pins=default|la15+50|al0.66|lc003C62|co41D42A||'Microsoft Corporate Headquarters'-122.14131832122801  47.64690503939462|'Microsoft Visitor Center'-122.136828 47.642224|'Microsoft Conference Center'-122.12552547454833 47.642940335653996|'Microsoft The Commons'-122.13687658309935  47.64452336193245&height=700&Width=700 
    
  9. Selecione Criar.

  10. Selecione a seta Enviar Solicitação que aparece à direita da URL da solicitação.

    A imagem a seguir é retornada:

    Renderizar um círculo com marcadores atualizados.

Da mesma forma, você pode alterar, adicionar e remover outros modificadores de estilo.

Adicionar uma camada de tráfego

Para obter uma imagem estática com uma camada de tráfego renderizada em um mapa base de estradas, use o parâmetro trafficLayer. O exemplo a seguir mostra um mapa com uma camada de tráfego e uma marcação com um rótulo:

  1. No aplicativo Bruno, selecione Nova Solicitação.

  2. Defina o tipo como HTTP.

  3. Insira um Nome para a solicitação, como Obter Imagem Estática do Mapa - camada de tráfego.

  4. Selecione o método de URL HTTP GET.

  5. Insira a seguinte URL:

    https://atlas.microsoft.com/map/static?subscription-key={Your-Azure-Maps-Subscription-key}&zoom=14&tilesetId=microsoft.base.road&api-version=2024-04-01&language=en-us&center= -0.122427, 51.500867&pins=custom%7Cla15+50%7Cls12%7Clc003b61%7C%7C%27Westminster Bridge%27-0.122427+51.500867%7C%7Chttps%3A%2F%2Fsamples.azuremaps.com%2Fimages%2Ficons%2Fylw-pushpin.png&height=700&Width=700&trafficLayer=microsoft.traffic.relative.main 
    
  6. Selecione Criar.

  7. Selecione a seta Enviar Solicitação que aparece à direita da URL da solicitação.

    A imagem a seguir é retornada:

    Captura de tela de um mapa mostrando a camada de tráfego, bem como um alfinete personalizado com o rótulo Westminster Bridge.

Criar um mapa usando o estilo cinza escuro

Para obter uma imagem estática com o estilo cinza escuro aplicado, defina o parâmetro TilesetId como microsoft.base.darkgrey:

  1. No aplicativo Bruno, selecione Nova Solicitação.

  2. Defina o tipo como HTTP.

  3. Insira um Nome para a solicitação, como Obter Imagem Estática do Mapa - estilo cinza escuro.

  4. Selecione o método de URL HTTP GET.

  5. Insira a seguinte URL:

    https://atlas.microsoft.com/map/static?subscription-key={Your-Azure-Maps-Subscription-key}&zoom=16&tilesetId=microsoft.base.darkgrey&api-version=2024-04-01&language=en-us&center=-95.360200,29.753452&pins=custom%7Cla15+50%7Cls12%7Clc003b61%7C%7C%27Westminster Bridge%27-0.122427+51.500867%7C%7Chttps%3A%2F%2Fsamples.azuremaps.com%2Fimages%2Ficons%2Fylw-pushpin.png&height=700&Width=700 
    
  6. Selecione Criar.

  7. Selecione a seta Enviar Solicitação que aparece à direita da URL da solicitação.

A imagem a seguir é retornada:

Uma captura de tela de um mapa mostrando o estilo cinza-escuro criado ao definir o parâmetro tileset ID como microsoft.base.darkgrey.

Para mais informações sobre os diferentes estilos disponíveis usando o parâmetro TilesetId, consulte TilesetId na documentação da API REST Renderizar - Obter o Conjunto de Blocos de Mapas.

Criar um mapa usando o estilo de imagem

Para obter uma imagem estática com o estilo de imagem aplicado, defina o parâmetro TilesetId como microsoft.imagery:

  1. No aplicativo Bruno, selecione Nova Solicitação.

  2. Defina o tipo como HTTP.

  3. Insira um Nome para a solicitação, como Obter Imagem Estática do Mapa - estilo de imagem.

  4. Selecione o método de URL HTTP GET.

  5. Insira a seguinte URL:

    https://atlas.microsoft.com/map/static?subscription-key={Your-Azure-Maps-Subscription-key}&zoom=16&tilesetId=microsoft.imagery&api-version=2024-04-01&language=en-us&center=-43.176141,-22.965458&height=700&Width=700
    
  6. Selecione Criar.

  7. Selecione a seta Enviar Solicitação que aparece à direita da URL da solicitação.

    A imagem a seguir é retornada:

    Uma captura de tela de um mapa mostrando o estilo de imagética criado ao definir o parâmetro de ID do conjunto de blocos para microsoft.imagery.

Para mais informações sobre os diferentes estilos disponíveis usando o parâmetro TilesetId, consulte TilesetId na documentação da API REST Renderizar - Obter o Conjunto de Blocos de Mapas.

Próximas etapas