Migrar o controlo de mapa do SDK Web do Azure Maps v1 e v2.0.x para v3

O Azure Maps Web SDK Map Control v1 e as versões 2.0.0 a 2.0.32 do Map Control foram retirados. Atualize todas as aplicações que utilizam estas versões para o Map Control v3. Este guia explica como completar a migração.

Compreender as alterações

Antes de iniciar o processo de migração, é importante familiarizar-se com as principais alterações e melhorias introduzidas no Web SDK v3. Consulte as notas de lançamento para compreender o alcance das novas funcionalidades.

Atualização da versão do Web SDK

CDN

Se estiveres a usar uma CDN (rede de distribuição de conteúdos), atualiza a folha de estilos e as referências JavaScript no head elemento dos teus ficheiros 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 da CDN Map Control v2 carrega a versão mais recente da v2, não uma versão específica da v2.0.x. Portanto, este URL por si só não indica que uma aplicação utilize 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 através do npm, verifique a versão resolvida azure-maps-control no ficheiro de bloqueio do pacote. As versões de 2.0.0 a 2.0.32 foram retiradas.

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 estiver a usar o npm, atualize para a versão mais recente do controlo do Azure Maps executando o seguinte comando:

npm install azure-maps-control@latest

Rever métodos de autenticação (opcionais)

Para reforçar 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 Partilhada. Para mais informações sobre a segurança de aplicações web do Azure Maps, consulte Gerir Autenticação no Azure Maps.

Testing

Testes abrangentes são essenciais durante a migração. Realize testes minuciosos da funcionalidade, desempenho e experiência do utilizador da sua aplicação em diferentes navegadores e dispositivos.

Lançamento gradual

Considere uma estratégia de implementação gradual para a versão atualizada. Liberte a versão migrada para um grupo mais pequeno de utilizadores ou num ambiente controlado antes de a disponibilizar a toda a sua base de utilizadores.

Ao seguir estes passos e considerar as melhores práticas, pode migrar a sua aplicação do Azure Maps Web SDK Map Control v1 ou v2.0.x para v3. Para mais informações, consulte as melhores práticas do Azure Maps Web SDK.

Passos seguintes

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