Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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: