O guia de migração do SDK da Web do Azure Maps
Obrigado por escolher o SDK da Web do Azure Maps para suas necessidades de mapeamento. Este guia de migração ajuda você a fazer a transição da v1 e v2 para a v3, permitindo que você aproveite os recursos e aprimoramentos mais recentes.
Entenda as mudanças
Antes de iniciar o processo de migração, é importante familiarizar-se com as principais alterações e melhorias introduzidas no Web SDK v3. Revise as notas de versão para entender o escopo dos novos recursos.
Atualizando a versão do SDK da Web
CDN
Se você estiver usando CDN (rede de distribuição de conteúdo), atualize as referências à folha de estilo v3 e JavaScript no head elemento de seus arquivos HTML.
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>
v2
<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>
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 npm, atualize para o controle mais recente do Azure Maps executando o seguinte comando:
npm install azure-maps-control@latest
Revisar métodos de autenticação (opcional)
Para aumentar a segurança, mais métodos de autenticação são incluídos no SDK da Web a partir da v2. Os novos métodos incluem a autenticação Microsoft Entra e a Autenticação de Chave Compartilhada. Para obter mais informações sobre a segurança do aplicativo Web do Azure Maps, consulte Gerenciar autenticação no Azure Maps.
Testar
Testes abrangentes são essenciais durante a migração. Realize testes completos da funcionalidade, do desempenho e da experiência do usuário do seu aplicativo em diferentes navegadores e dispositivos.
Implementação gradual
Considere uma estratégia de implantaçã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 estas etapas e considerando as práticas recomendadas, você pode migrar com êxito seu aplicativo do SDK da Web do Azure Maps v1 e v2 para v3. Adote os novos recursos e melhorias oferecidos pela versão mais recente, garantindo uma transição suave e perfeita para seus usuários. Para obter mais informações, consulte Práticas recomendadas do SDK da Web do Azure Maps.
Próximos passos
Saiba como adicionar mapas a aplicações Web e móveis utilizando a biblioteca JavaScript do lado do cliente do Controlo de Mapas no Azure Maps: