Notas de versão do controle de mapa do SDK da Web

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

v3 (mais recente)

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

Novas funcionalidades

• Adicione suporte para controle de tela cheia.

Correções de erros

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

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

Novas funcionalidades

• Adicione suporte para PMTiles.

Correções de erros

• Acessibilidade: corrija o problema de estouro com a etiqueta do seletor de estilo em recipientes pequenos.
• Corrija a atribuição que não é atualizada após alterações de estilo com uma fonte de dados GeoJSON.
• Correção 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.
• Atualizar dependência @microsoft/applicationinsights-web para ^3.3.0

3.3.0 (8 de agosto de 2024)

Novas funcionalidades

• Atualizar o controle de direitos autorais
  • Reduza o texto dos direitos de autor e certifique-se de que se encaixa numa 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 MS) quando a tela do mapa for relativamente pequena.
• Melhore a classe da camada base adicionando abstrato getOptions e setOptions funções.

Correções de erros

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

3.2.1 (13 de maio de 2024)

Novas funcionalidades

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

Correções de erros

• Corrija números acessíveis para controles ocultos usando o comando 'Mostrar números'.
• Corrija o vazamento de memória no trabalhador quando o mapa for removido.
• Corrija alterações indesejadas de zoom e movimento panorâmico 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 from [0, -18] to [0, 0] no doc.

3.1.2 (22 de fevereiro de 2024)

Novas funcionalidades

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

Outras alterações

• Atualize o ícone e o link de comentários.

3.1.1 (26 de janeiro de 2024)

Novas funcionalidades

• 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 erros

• 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)

Novas funcionalidades

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

• Introduziu funções para acessar, atualizar e excluir um estado de recurso.

Correções de erros

• Foi resolvido o problema da 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.

• [QUEBRANDO] Alinhado 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, verifique se fillPattern está definido como undefined.

3.0.3 (29 de novembro de 2023)

Novas funcionalidades

• Suporte ESM incluído.

Outras alterações

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

• Acessibilidade melhorada nos controlos Compass e Pitch.

3.0.2 (1 de novembro de 2023)

Correções de erros

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

Outras alterações

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

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

3.0.1 (6 de outubro de 2023)

Correções de erros

• Várias melhorias de acessibilidade.

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

• Corrigidos nomes de eventos ausentes no HtmlMarkerEvents.

Outras alterações

• Métodos de membros modificados a serem protegidos para os controles de zoom, pitch e bússola.

• A telemetria está desabilitada por padrão na nuvem do Azure Government.

3.0.0 (18 de agosto de 2023)

Correções de erros

• Controle de zoom fixo para levar em conta o maxBounds CameraOptions.

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

Outras alterações

• Eliminada gradualmente a versão 2022-08-05 de definição de estilo e mudado o padrão styleDefinitionsVersion 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 em npm e CDN.

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

• CDN: Faça referência aos seguintes CSS e JavaScript no <head> elemento 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 erros

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

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

Instalação

A pré-visualização está disponível em npm e CDN.

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

• CDN: Faça referência aos seguintes CSS e JavaScript no <head> elemento 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)

Novas funcionalidades

• 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 erros

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

Instalação

A pré-visualização está disponível em npm e CDN.

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

• CDN: Faça referência aos seguintes CSS e JavaScript no <head> elemento 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 erros

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

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

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

Outras alterações

• Logótipo e link de atribuição atualizados.

Instalação

A pré-visualização está disponível em npm e CDN.

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

• CDN: Faça referência aos seguintes CSS e JavaScript no <head> elemento 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)

Novas funcionalidades

• Além da configuração do mapa, Map.setServiceOptions() agora suporta a alteração domain, styleAPIVersion, styleDefinitionsVersion em tempo de execução.

Correções de erros

• Exceção de token expirado fixa em reinicializações ao usar 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

• Definição de estilo redundante fixa e solicitações de miniatura

• Corrigido incorreto aria-label aplicado ao elemento do botão de controle de zoom out

• Corrigida a possibilidade de contêiner de elemento de direitos autorais indefinido quando withRuleBasedAttribution é definido como false

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

Instalação

A pré-visualização está disponível em npm e CDN.

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

• CDN: Faça referência aos seguintes CSS e JavaScript no <head> elemento 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 pré-visualização está disponível em npm e CDN.

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

• CDN: Faça referência aos seguintes CSS e JavaScript no <head> elemento 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>
  

Novas funcionalidades

• Otimizou o desempenho da transformação de estilo interno.

Correções de erros

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

• Eliminou 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 pré-visualização está disponível em npm e CDN.

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

• CDN: Faça referência aos seguintes CSS e JavaScript no <head> elemento 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>
  

Novas funcionalidades

• Suporte a 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 pré-visualização está disponível em npm e CDN.

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

• CDN: Faça referência aos seguintes CSS e JavaScript no <head> elemento 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>
  

Novas funcionalidades

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

• Pré-visualização de estilos de mapa atualizados (Road / Night / Hybrid / Gray Scale Dark / Gray Scale Light / Terra / High Contrast Dark / High Contrast Light).

• Mais detalhes sobre estradas/pegadas de construção/cobertura de trilhos.

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

• Mais detalhes sobre 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 suportam apenas o modo relativo.

• Preterido showBuildingModels em StyleOptions.

• Alterado o padrão minZoom de -2 para 1.

Correções de erros

• Limpo vários vazamentos de memória em Map.dispose().

• Navegação melhorada no separador do seletor de estilos para acessibilidade no esquema de lista.

• Comutação de estilo otimizada, evitando clonagem profunda de objetos.

• Corrigida uma exceção que ocorria no SourceManager quando alternava de estilo com fontes que não eram vetor ou raster.

• [QUEBRANDO] Anteriormente sourceadded , os eventos só são emitidos se novas fontes forem adicionadas ao estilo. Agora sourceremoved / sourceadded , os eventos são emitidos quando a nova fonte e a fonte original no estilo atual não são iguais, mesmo que tenham o mesmo ID de origem.

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

Instalação

A pré-visualização está disponível em npm e CDN.

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

• CDN: Faça referência aos seguintes CSS e JavaScript no <head> elemento 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>
  

Novas funcionalidades

• [QUEBRANDO] Migrado de adal-angular para @azure/msal-browser usado para autenticação com o Microsoft Azure Ative Directory (Azure AD). Alterações que podem ser necessárias:

  • Platform / Reply URL O tipo deve ser definido como Single-page application no portal de Registro de Aplicativo do Azure AD.
  • A alteração de código é necessária se uma personalização authOptions.authContext for usada.
  • Para obter mais informações, consulte Como migrar um aplicativo JavaScript do ADAL.js para o MSAL.js.

• Permita que o passo e o rolamento sejam definidos com CameraBoundsOptions em Map.setCamera(options).

Correções de erros

• Corrigido problema no mapeamento de idioma, agora zh-Hant-TW não reverte mais para en-US.

• Corrigida a incapacidade de alternar entre regiões do usuário (exibição).

• Exceção corrigida que ocorria quando a troca de estilo enquanto o carregamento progressivo da camada estava em andamento.

• Corrigida a recuperação de informações de acessibilidade das camadas de rótulo de bloco do mapa.

• Corrigido o problema ocasional em que blocos vetoriais não estavam sendo rerenderizados depois que as imagens estavam sendo adicionadas via ImageSpriteManager.add().

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

Instalação

A pré-visualização está disponível em npm e CDN.

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

• CDN: Faça referência aos seguintes CSS e JavaScript no <head> elemento 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>
  

Novas funcionalidades

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

Correções de erros

• Corrigido um problema que fazia com que a ordenação das camadas do usuário não fosse preservada após a chamada map.layers.move().

• Corrigida a incapacidade de desativar incidentes de tráfego em TrafficControlOptions quando new atlas.control.TrafficControl({incidents: false}) é usado.

• Adicione .atlas-map a todos os seletores de css para definir o escopo dos estilos dentro do contêiner de 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 prévia está disponível no npm.

• Instale azure-maps-control@next em suas dependências:

  npm i azure-maps-control@next
  

Novas funcionalidades

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

Correções de erros

• Corrigido um problema de regressão que impedia o IndoorManager de remover um conjunto de blocos:

  indoorManager.setOptions({
      tilesetId: undefined
  })
  

v2

2.3.7 (22 de fevereiro de 2024)

Novas funcionalidades

• Adicionada fillAntialias opção para habilitar a PolygonLayer suavização de serrilhado do 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 comentários.

2.3.6 (12 de janeiro de 2024)

Novas funcionalidades

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

• Introduziu funções para acessar, atualizar e excluir um estado de recurso.

Correções de erros

• Foi resolvido o problema da 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 para leitor de tela foi atualizado para utilizar a API Search V2 (geocodificação reversa).

2.3.4 (1 de novembro de 2023)

Outras alterações

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

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

2.3.3 (6 de outubro de 2023)

Correções de erros

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

2.3.2 (11 de agosto de 2023)

Correções de erros

• Corrigido um problema em que elementos DOM duplicados relacionados à acessibilidade podiam resultar quando map.setServiceOptions são chamados.

• Controle de zoom fixo para levar em conta o maxBounds CameraOptions.

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 (27 de junho de 2023)

Correções de erros

• Corrigir ImageSpriteManager imagens de ícones podem ser removidas durante a mudança 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)

Novas funcionalidades

• [QUEBRANDO] Refatorado o StyleManager interno para substituir _stylePatch por transformStyle. Esta alteração permitirá que os ícones do escudo rodoviário sejam atualizados e renderizados corretamente após uma mudança de estilo.

Correções de erros

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

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

Outras alterações

• Logótipo e link de atribuição atualizados.

2.2.7 (2 de maio de 2023)

Novas funcionalidades

• Além da configuração do mapa, Map.setServiceOptions() agora suporta a alteração domain, styleAPIVersion, styleDefinitionsVersion em tempo de execução.

Correções de erros

• Exceção de token expirado fixa em reinicializações ao usar 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

• Definição de estilo redundante fixa e solicitações de miniatura

• Corrigido incorreto aria-label aplicado ao elemento do botão de controle de zoom out

• Corrigida a possibilidade de contêiner de elemento de direitos autorais indefinido quando withRuleBasedAttribution é definido como false

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

2.2.6

Correções de erros

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

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

2.2.5

Novas funcionalidades

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

2.2.4

Correções de erros

• Limpo vários vazamentos de memória em Map.dispose().

• Navegação melhorada no separador do seletor de estilos para acessibilidade no esquema de lista.

2.2.3

Novas funcionalidades

• Permita que o passo e o rolamento sejam definidos com CameraBoundsOptions em Map.setCamera(options).

Correções de erros

• Corrigido problema no mapeamento de idioma, agora zh-Hant-TW não reverte mais para en-US.

• Corrigida a incapacidade de alternar entre regiões do usuário (exibição).

• Exceção corrigida que ocorria quando a troca de estilo enquanto o carregamento progressivo da camada estava em andamento.

• Corrigida a recuperação de informações de acessibilidade das camadas de rótulo de bloco do mapa.

• Corrigido o problema ocasional em que blocos vetoriais não estavam sendo rerenderizados depois que as imagens estavam sendo adicionadas via ImageSpriteManager.add().

2.2.2 (15 de dezembro de 2022)

Novas funcionalidades

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

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

Correções de erros

• Corrigido um problema que fazia com que a ordenação das camadas do usuário não fosse preservada após a chamada map.layers.move().

• Corrigida a incapacidade de desativar incidentes de tráfego em TrafficControlOptions quando new atlas.control.TrafficControl({incidents: false}) é usado.

Próximos passos

Explore exemplos que mostram o Azure Maps:

Exemplos do Azure Maps

Mantenha-se atualizado sobre o Azure Maps:

Blogue do Azure Maps