Compartilhar via

Notas sobre a versão do controle de mapeamento do SDK da Web

  • Artigo

Este documento contém informações sobre novos recursos e outras alterações no Controle de Mapeamento.

v3 (mais recente)

3.6.0 (CDN: 18 de fevereiro de 2025, npm: 20 de fevereiro de 2025)

Novos recursos

  • Adicione uma nova opção StyleOptions.styleOverrides que controla a visibilidade de vários elementos do mapa, incluindo countryRegion, adminDistrict, , adminDistrict2buildingFootprint, e roadDetails.
  • Adicionar auto opção e StyleOptions.languageatlas.setLanguage que define a opção de idioma para corresponder ao cabeçalho Accept-Language do navegador.

Correções de bug

  • Resolva o problema em que clicar no botão Fechar de um pop-up dentro de um elemento de formulário aciona o envio do formulário.
  • Correção do problema em que ImageLayer.setOptions() potencialmente causa erros de anulação se a imagem for grande e a solicitação não tiver sido concluída.

Outras alterações

  • Desabilite a telemetria por padrão.

3.5.0 (CDN: 4 de novembro de 2024, npm: 7 de novembro de 2024)

Novos recursos

  • Adicione suporte para controle de tela inteira.

Correções de bug

  • Exponha o novo tipo ao PolygonExtrusionLayerOptions.fillPattern suporte DataDrivenPropertyValueSpecification<string>.

3.4.0 (CDN: 30 de setembro de 2024, npm: 2 de outubro de 2024)

Novos recursos

  • Adicione suporte para PMTiles.

Correções de bug

  • Acessibilidade: corrija o problema de estouro com o rótulo do seletor de estilo em contêineres pequenos.
  • Correção da atribuição que não é atualizada após alterações de estilo com uma fonte de dados GeoJSON.
  • Corrija setCamera com limites e zoom mínimo / máximo.
  • Use ResizeObserver em vez de eventos de redimensionamento de janela.
  • Corrija a largura do logotipo do rodapé.

Outras alterações

  • Adicionar @types/geojson como uma dependência.
  • Atualize @microsoft/applicationinsights-web a dependência para ^3.3.0

3.3.0 (8 de agosto de 2024)

Novos recursos

  • Atualizar o controle de direitos autorais
    • Diminua o texto protegido por direitos autorais e certifique-se de que ele caiba em uma linha.
    • Use diferentes tipos de logotipos da Microsoft para diferentes temas CSS para melhorar a visibilidade.
    • Implemente o RWD para ocultar parte do componente (logotipo da MS) quando a tela do mapa for relativamente pequena.
  • Aprimore a classe da camada base adicionando abstract getOptions e setOptions functions.

Correções de bug

  • Ignore as fontes existentes ao copiar camadas do usuário.
  • [URGENTE] Correção da ordem incorreta dos valores de latitude e longitude em Position.fromLatLng().
  • Corrija o problema visível do elemento acessível oculto nos botões de controle.

3.2.1 (13 de maio de 2024)

Novos recursos

  • Restringir panorâmica horizontal quando renderWorldCopies estiver definido como false.
  • Torne easeTo a flyTo animação mais suave quando o ponto de destino estiver próximo dos limites: maxBounds, bordas verticais do mundo ou antimeridiano.

Correções de bug

  • Corrija números acessíveis para controles ocultos ao usar o comando 'Mostrar números'.
  • Corrija o vazamento de memória no worker quando o mapa é removido.
  • Corrija alterações indesejadas de zoom e panorâmica no final de um movimento panorâmico.

Outras alterações

  • Melhore o formato do código embutido no documento.

3.2.0 (29 de março de 2024)

Outras alterações

  • Atualize o MapLibre para V4.

  • Corrija o valor padrão de HtmlMarkerOptions.pixelOffset de para [0, 0][0, -18] no documento.

3.1.2 (22 de fevereiro de 2024)

Novos recursos

  • Adicionada fillAntialias opção para PolygonLayer habilitar a suavização de serrilhado MSAA em preenchimentos de polígonos.

Outras alterações

  • Atualize o ícone e o link de feedback.

3.1.1 (26 de janeiro de 2024)

Novos recursos

  • Adicionada uma nova opção, enableAccessibilityLocationFallback, para habilitar ou desabilitar o fallback da API de geocodificação reversa para acessibilidade (leitor de tela).

Correções de bug

  • Resolvido um problema em que o ApplicationInsights v3.0.5 estava potencialmente enviando um grande número de solicitações.

3.1.0 (12 de janeiro de 2024)

Novos recursos

  • Adicionado um novo controle, atlas.control.ScaleControl, para exibir uma barra de escala no mapa.

  • Funções introduzidas para acessar, atualizar e excluir um estado de recurso.

Correções de bug

  • Resolvido o problema de ordenação de camadas após uma atualização de estilo, quando uma camada de usuário é inserida antes de outra camada de usuário.

  • [URGENTE] Alinhou o comportamento do padrão de preenchimento do polígono com o Maplibre. Agora, a fillPattern opção desativa consistentemente a fillColor opção. Ao configurar fillColor para camadas de polígono, certifique-se de que fillPattern esteja definido como undefined.

3.0.3 (29 de novembro de 2023)

Novos recursos

  • Suporte ESM incluído.

Outras alterações

  • O recurso de acessibilidade do leitor de tela foi atualizado para utilizar a API Search V2 (geocodificação reversa).

  • Acessibilidade aprimorada nos controles de bússola e inclinação.

3.0.2 (01º de novembro de 2023)

Correções de bug

  • Abordou vários erros no arquivo de declaração de tipo e adicionou uma dependência para @maplibre/maplibre-gl-style-spec.

Outras alterações

  • Removeram Cabeçalhos de autorização de solicitações de estilo, miniatura, sprite e glifo para aprimorar o cache de CDN nos ativos estáticos.

  • Atualizou a documentação para map.clear() e layers.clear().

3.0.1 (6 de outubro de 2023)

Correções de bug

  • Diversos aprimoramentos de acessibilidade.

  • Resolvido o problema envolvendo a atribuição dinâmica quando o carregamento progressivo está habilitado.

  • Corrigidos os nomes de eventos ausentes em HtmlMarkerEvents.

Outras alterações

  • Modificados os métodos de membros a serem protegidos para os controles de ampliação (zoom), inclinação (pitch) e giro (compass).

  • A telemetria fica desabilitada por padrão na nuvem do Azure Governamental.

3.0.0 (18 de agosto de 2023)

Correções de bug

  • Corrigido o controle de zoom para levar em conta as maxBoundsCameraOptions.

  • Correção de um problema em que as posições do mouse eram deslocadas após uma transformação de escala css no contêiner do mapa.

Outras alterações

  • A versão 2022-08-05 da definição de estilo foi gradualmente eliminada, e o padrão de styleDefinitionsVersion foi alternado para 2023-01-01.

  • Adicionado o mvc parâmetro para abranger a versão de controle de mapa em definições e solicitações de estilo.

Instalação

A versão está disponível no npm e CDN.

  • NPM: consulte as instruções em azure-maps-control@3.0.0

  • CDN: Consulte os seguintes CSS e JavaScript no elemento <head> de um arquivo HTML:

    <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0/atlas.min.css" rel="stylesheet" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0/atlas.min.js"></script>

3.0.0-preview.10 (11 de julho de 2023)

Correções de bug

  • Proporção dinâmica de pixels fixada na dependência subjacente do maplibre-gl.

  • Correção de um problema em que sortKey, radialOffset, variableAnchor não era aplicado quando usado em opções SymbolLayer.

Instalação

A versão prévia está disponível no npm e CDN.

  • NPM: consulte as instruções em azure-maps-control@3.0.0-preview.10

  • CDN: Consulte os seguintes CSS e JavaScript no elemento <head> de um arquivo HTML:

    <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.10/atlas.min.css" rel="stylesheet" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.10/atlas.min.js"></script>

3.0.0-preview.9 (27 de junho de 2023)

Novos recursos

  • O WebGL2 é usado por padrão.

  • APIs de elevação: atlas.sources.ElevationTileSource, map.enableElevation(elevationSource, options), map.disableElevation()

  • Capacidade de personalizar maxPitch / minPitch em CameraOptions

Correções de bug

  • Foi corrigido um problema em que os elementos DOM duplicados relacionados à acessibilidade podiam resultar quando map.setServiceOptions é chamado

Instalação

A versão prévia está disponível no npm e CDN.

  • NPM: consulte as instruções em azure-maps-control@3.0.0-preview.9

  • CDN: Consulte os seguintes CSS e JavaScript no elemento <head> de um arquivo HTML:

    <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.9/atlas.min.css" rel="stylesheet" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.9/atlas.min.js"></script>

3.0.0-preview.8 (2 de junho de 2023)

Correções de bug

  • Correção de uma exceção que ocorria durante a atualização da propriedade de um layout que não existe mais.

  • Correção de um problema em que os indicadores acessíveis do BubbleLayer não eram atualizados quando a fonte de dados era modificada.

  • Correção de um erro em chamadas subsequentes map.setStyle() se o estilo Maplibre bruto for recuperado no retorno de chamada do evento stylechanged na serialização de estilo.

Outras alterações

  • Logotipo e link de atribuição atualizados.

Instalação

A versão prévia está disponível no npm e CDN.

  • NPM: consulte as instruções em azure-maps-control@3.0.0-preview.8

  • CDN: Consulte os seguintes CSS e JavaScript no elemento <head> de um arquivo HTML:

    <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.8/atlas.min.css" rel="stylesheet" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.8/atlas.min.js"></script>

3.0.0-preview.7 (2 de maio de 2023)

Novos recursos

  • Além da configuração do mapa, Map.setServiceOptions() agora tem suporte para alteração de domain, styleAPIVersion, styleDefinitionsVersion no runtime.

Correções de bug

  • Correção da exceção de token expirado em relançamentos ao utilizar o Azure AD /token compartilhado/autenticação anônima, certificando-se de que a autenticação seja resolvida antes de qualquer solicitação de definição de estilo

  • Corrigida a definição de estilo redundante e solicitações de miniatura

  • Corrigido o erro aria-label aplicado ao elemento do botão de controle de redução de zoom

  • Corrigida a possibilidade de um contêiner indefinido de elementos de direitos autorais quando withRuleBasedAttribution está definido como falso

  • Corrigida a possibilidade de a remoção do ouvinte de eventos ser chamada em um alvo indefinido em EventManager.remove()

Instalação

A versão prévia está disponível no npm e CDN.

  • NPM: consulte as instruções em azure-maps-control@3.0.0-preview.7

  • CDN: Consulte os seguintes CSS e JavaScript no elemento <head> de um arquivo HTML:

    <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.7/atlas.min.css" rel="stylesheet" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.7/atlas.min.js"></script>

3.0.0-preview.6 (31 de março de 2023)

Instalação

A versão prévia está disponível no npm e CDN.

  • NPM: Consulte as instruções em azure-maps-control@3.0.0-preview.6

  • CDN: Consulte os seguintes CSS e JavaScript no elemento <head> de um arquivo HTML:

    <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.6/atlas.min.css" rel="stylesheet" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.6/atlas.min.js"></script>

Novos recursos

  • Otimizado o desempenho de transformação de estilo interno.

Correções de bug

  • Resolvido um problema em que a primeira solicitação de conjunto de estilos não era autenticada para autenticação AAD.

  • Foram eliminadas solicitações redundantes durante a inicialização do mapa e em eventos alterados de estilo.

3.0.0-preview.5 (15 de março de 2023)

Instalação

A versão prévia está disponível no npm e CDN.

  • NPM: Consulte as instruções em azure-maps-control@3.0.0-preview.5

  • CDN: Consulte os seguintes CSS e JavaScript no elemento <head> de um arquivo HTML:

    <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.5/atlas.min.css" rel="stylesheet" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.5/atlas.min.js"></script>

Novos recursos

  • Suporte à atualização dinâmica de mapConfiguration via map.setServiceOptions({ mapConfiguration: 'MAP_CONFIG' })

3.0.0-preview.4 (10 de março de 2023)

Instalação

A versão prévia está disponível no npm e CDN.

  • NPM: Confira as instruções em azure-maps-control@3.0.0-preview.4

  • CDN: Consulte os seguintes CSS e JavaScript no elemento <head> de um arquivo HTML:

    <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.4/atlas.min.css" rel="stylesheet" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.4/atlas.min.js"></script>

Novos recursos

  • Cobertura de mapa estendida na China, Japão e Coreia.

  • Visualização dos estilos de mapa atualizados (Estrada/Noite/Híbrida/Escala Cinza Escura/Cinza Claro/Terra/Alto Contraste Escuro/Claro de Alto Contraste).

  • Mais detalhes sobre estradas/compilação de volume/cobertura de trilhas.

  • Intervalos de nível de zoom mais amplos (1~21) para o estilo Terra.

  • Maiores detalhes sobre o transporte público, incluindo balsas, metrôs e paradas de ônibus.

  • Informações adicionais sobre a altitude das montanhas e a localização das cachoeiras.

Alterações

  • Os dados de tráfego agora dão suporte apenas ao modo relativo.

  • Preterido showBuildingModels em StyleOptions.

  • O padrão minZoom foi alterado de -2 para 1.

Correções de bug

  • Limpou várias perdas de memória em Map.dispose().

  • Navegação de guia do seletor de estilo aprimorada para acessibilidade no layout da lista.

  • Alternância de estilo otimizada evitando a clonagem profunda de objetos.

  • Correção de uma exceção que ocorreu no SourceManager ao alternar de estilo com fontes que não eram vetor ou raster.

  • [INTERRUPÇÃO] Os eventos anteriores sourceadded só serão emitidos se novas fontes forem adicionadas ao estilo. Agora, eventos sourceremoved / sourceadded são emitidos quando a nova fonte e a fonte original no estilo atual não são iguais, mesmo que tenham a mesma ID de origem.

3.0.0-preview.3 (02 de fevereiro de 2023)

Instalação

A versão prévia está disponível no npm e CDN.

  • NPM: Confira as instruções em azure-maps-control@3.0.0-preview.3

  • CDN: Consulte os seguintes CSS e JavaScript no elemento <head> de um arquivo HTML:

    <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.3/atlas.min.css" rel="stylesheet" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.3/atlas.min.js"></script>

Novos recursos

Correções de bug

  • O problema no mapeamento de idioma foi corrigido. Agora zh-Hant-TW não será mais revertido para en-US.

  • A incapacidade de alternar entre as regiões do usuário (exibição) foi corrigida.

  • A exceção que ocorreu ao alternar o estilo enquanto o carregamento de camada progressiva estava em andamento foi corrigida.

  • A recuperação de informações de acessibilidade das camadas de rótulo da peça de mapa foi corrigida.

  • O problema ocasional em que os blocos vetoriais não estavam sendo renderizados depois que as imagens eram adicionadas via ImageSpriteManager.add() foi corrigido.

3.0.0-preview.2 (16 de dezembro de 2022)

Instalação

A versão prévia está disponível no npm e CDN.

  • NPM: Confira as instruções em azure-maps-control@3.0.0-preview.2

  • CDN: Consulte os seguintes CSS e JavaScript no elemento <head> de um arquivo HTML:

    <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.2/atlas.min.css" rel="stylesheet" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.2/atlas.min.js"></script>

Novos recursos

Adicione progressiveLoading e progressiveLoadingInitialLayerGroups a StyleOptions para habilitar a capacidade de carregar camadas do mapa progressivamente. Esse recurso melhora o tempo de carregamento percebido do mapa. Para obter mais informações, confira as notas sobre a versão 2.2.2.

Correções de bug

  • O problema em que a ordenação de camadas de usuário não foi preservada depois de chamar map.layers.move() foi corrigido.

  • A incapacidade de desabilitar incidentes de tráfego em TrafficControlOptions quando new atlas.control.TrafficControl({incidents: false}) for usado foi corrigida.

  • Inclusão de .atlas-map a todos os seletores CSS para definir o escopo dos estilos dentro do contêiner do mapa. A correção impede que o CSS adicione acidentalmente estilos indesejados a outros elementos na página.

3.0.0-preview.1 (18 de novembro de 2022)

Instalação

A versão prévia está disponível no npm.

Novos recursos

Esta atualização é a primeira versão prévia da versão 3.0.0 futura. A dependência maplibre-gl subjacente foi atualizada de 1.14 para 3.0.0-pre.1, oferecendo melhorias na estabilidade e no desempenho.

Correções de bug

  • O problema de regressão que impede o IndoorManager de remover um conjunto de peças foi corrigido.

    indoorManager.setOptions({
    tilesetId: undefined
})

v2

2.3.7 (22 de fevereiro de 2024)

Novos recursos

  • Adicionada fillAntialias opção para PolygonLayer habilitar a suavização de serrilhado MSAA em preenchimentos de polígonos.
  • Adicionada uma nova opção, enableAccessibilityLocationFallback, para habilitar ou desabilitar o fallback da API de geocodificação reversa para acessibilidade (leitor de tela).

Outras alterações

  • Atualize o ícone e o link de feedback.

2.3.6 (12 de janeiro de 2024)

Novos recursos

  • Adicionado um novo controle, atlas.control.ScaleControl, para exibir uma barra de escala no mapa.

  • Funções introduzidas para acessar, atualizar e excluir um estado de recurso.

Correções de bug

  • Resolvido o problema de ordenação de camadas após uma atualização de estilo, quando uma camada de usuário é inserida antes de outra camada de usuário.

2.3.5 (29 de novembro de 2023)

Outras alterações

  • O recurso de acessibilidade do leitor de tela foi atualizado para utilizar a API Search V2 (geocodificação reversa).

2.3.4 (01º de novembro de 2023)

Outras alterações

  • Removeram Cabeçalhos de autorização de solicitações de estilo, miniatura, sprite e glifo para aprimorar o cache de CDN nos ativos estáticos.

  • Atualizou a documentação para map.clear() e layers.clear().

2.3.3 (6 de outubro de 2023)

Correções de bug

  • Resolvido o problema envolvendo a atribuição dinâmica quando o carregamento progressivo está habilitado.

2.3.2 (11 de agosto de 2023)

Correções de bug

  • Foi corrigido um problema em que os elementos DOM duplicados relacionados à acessibilidade podiam resultar quando map.setServiceOptions é chamado.

  • Corrigido o controle de zoom para levar em conta as maxBoundsCameraOptions.

Outras alterações

  • Adicionado o mvc parâmetro para abranger a versão de controle de mapa em definições e solicitações de estilo.

2.3.1 (junho de 27, 2023)

Correções de bug

  • Correção ImageSpriteManager imagens de ícone podem ser removidas durante a alteração de estilo

Outras alterações

  • Segurança: correção de aleatoriedade insegura na geração de UUID.

2.3.0 (2 de junho de 2023)

Novos recursos

  • [BREAKING] Refatorou o StyleManager interno para substituir _stylePatch por transformStyle. Essa alteração permitirá que os ícones de escudo de estrada sejam atualizados e renderizados corretamente após uma troca de estilo.

Correções de bug

  • Correção de uma exceção que ocorria durante a atualização da propriedade de um layout que não existe mais.

  • Correção de um problema em que os indicadores acessíveis do BubbleLayer não eram atualizados quando a fonte de dados era modificada.

Outras alterações

  • Logotipo e link de atribuição atualizados.

2.2.7 (2 maio de 2023)

Novos recursos

  • Além da configuração do mapa, Map.setServiceOptions() agora tem suporte para alteração de domain, styleAPIVersion, styleDefinitionsVersion no runtime.

Correções de bug

  • Correção da exceção de token expirado em relançamentos ao utilizar o Azure AD /token compartilhado/autenticação anônima, certificando-se de que a autenticação seja resolvida antes de qualquer solicitação de definição de estilo

  • Corrigida a definição de estilo redundante e solicitações de miniatura

  • Corrigido o erro aria-label aplicado ao elemento do botão de controle de redução de zoom

  • Corrigida a possibilidade de um contêiner indefinido de elementos de direitos autorais quando withRuleBasedAttribution está definido como falso

  • Corrigida a possibilidade de remoção do ouvinte de eventos chamado no destino indefinido em EventManager.remove()

2.2.6

Correções de bug

  • Resolvido um problema em que a primeira solicitação de conjunto de estilos não era autenticada para autenticação AAD.

  • Foram eliminadas solicitações redundantes durante a inicialização do mapa e em eventos alterados de estilo.

2.2.5

Novos recursos

  • Suporte à atualização dinâmica de mapConfiguration via map.setServiceOptions({ mapConfiguration: 'MAP_CONFIG' })

2.2.4

Correções de bug

  • Limpou várias perdas de memória em Map.dispose().

  • Navegação de guia do seletor de estilo aprimorada para acessibilidade no layout da lista.

2.2.3

Novos recursos

Correções de bug

  • O problema no mapeamento de idioma foi corrigido. Agora zh-Hant-TW não será mais revertido para en-US.

  • A incapacidade de alternar entre as regiões do usuário (exibição) foi corrigida.

  • A exceção que ocorreu ao alternar o estilo enquanto o carregamento de camada progressiva estava em andamento foi corrigida.

  • A recuperação de informações de acessibilidade das camadas de rótulo da peça de mapa foi corrigida.

  • O problema ocasional em que os blocos vetoriais não estavam sendo renderizados depois que as imagens eram adicionadas via ImageSpriteManager.add() foi corrigido.

2.2.2 (15 de dezembro de 2022)

Novos recursos

Adicione progressiveLoading e progressiveLoadingInitialLayerGroups a StyleOptions para habilitar a capacidade de carregar camadas do mapa progressivamente. Esse recurso melhora o tempo de carregamento percebido do mapa.

  • progressiveLoading
    • Habilita o carregamento progressivo de camadas do mapa.
    • Assume o padrão de false.
  • progressiveLoadingInitialLayerGroups
    • Especifica os grupos de camadas a serem carregados primeiro.
    • Assume o padrão de ["base"].
    • Os valores possíveis são base, transit, labels, buildings e labels_places.
    • Outros grupos de camadas são adiados de modo que os grupos de camadas iniciais possam ser carregados primeiro.

Correções de bug

  • O problema em que a ordenação de camadas de usuário não foi preservada depois de chamar map.layers.move() foi corrigido.

  • A incapacidade de desabilitar incidentes de tráfego em TrafficControlOptions quando new atlas.control.TrafficControl({incidents: false}) for usado foi corrigida.

Próximas etapas

Explore exemplos mostrando o Azure Mapas:

Amostras do Azure Mapas

Mantenha-se atualizado sobre o Azure Mapas:

Blog do Azure Mapas