Migrar o controle de mapa do SDK Web do Azure Mapas v1 e v2.0.x para a v3

O Azure Mapas Web SDK Map Control v1 e as versões 2.0.0 à 2.0.32 do Map Control foram descontinuados. Atualize todos os aplicativos que usam essas versões para o Map Control v3. Este guia explica como completar a migração.

Entenda as alterações

Antes de iniciar o processo de migração, é importante se familiarizar com as principais mudanças e melhorias introduzidas no Web SDK v3. Revise as notas de lançamento para entender o escopo das novas funcionalidades.

Atualização da versão do Web SDK

CDN

Se você estiver usando uma CDN (rede de distribuição de conteúdo), atualize a folha de estilos e as referências JavaScript no head elemento dos seus arquivos HTML.

Antes da migração: Map Control v1

<link rel="stylesheet" href="https://atlas.microsoft.com/sdk/css/atlas.min.css?api-version=1" type="text/css" />
<script src="https://atlas.microsoft.com/sdk/js/atlas.min.js?api-version=1"></script>

Antes da migração: Map Control v2

O caminho genérico do CDN Map Control v2 carrega a versão mais recente da v2, não uma versão específica da v2.0.x. Portanto, essa URL sozinha não indica que um aplicativo usa uma versão v2.0.x afetada:

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

Para aplicações que instalam o Map Control via npm, verifique a versão resolvida azure-maps-control no arquivo de bloqueio de pacotes. Versões de 2.0.0 a 2.0.32 foram aposentadas.

Após a migração: Map Control v3

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

npm

Se você estiver usando o npm, atualize para a versão mais recente do controle do Azure Mapas executando o seguinte comando:

npm install azure-maps-control@latest

Revise métodos de autenticação (opcional)

Para aumentar a segurança, mais métodos de autenticação são incluídos no Web SDK a partir da v2. Os novos métodos incluem autenticação Microsoft Entra e Autenticação de Chave Compartilhada. Para mais informações sobre segurança de aplicações web do Azure Mapas, veja Gerenciar Autenticação no Azure Mapas.

Testing

Testes abrangentes são essenciais durante a migração. Realize testes detalhados da funcionalidade, desempenho e experiência do usuário do seu aplicativo em diferentes navegadores e dispositivos.

Lançamento gradual

Considere uma estratégia de implementação gradual para a versão atualizada. Libere a versão migrada para um grupo menor de usuários ou em um ambiente controlado antes de disponibilizá-la para toda a sua base de usuários.

Seguindo esses passos e considerando as melhores práticas, você pode migrar sua aplicação do Azure Mapas Web SDK Map Control v1 ou v2.0.x para a v3. Para mais informações, veja as melhores práticas do Azure Mapas Web SDK.

Próximas Etapas 

Aprenda como adicionar mapas a aplicações web e móveis usando a biblioteca JavaScript do lado do cliente Map Control no Azure Mapas: