O guia de migração do SDK Web do Azure Mapas
Obrigado por escolher o SDK da Web do Azure Mapas para suas necessidades de mapeamento. Esse 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 alterações
Antes de iniciar o processo de migração, é importante se familiarizar com as principais alterações e melhorias introduzidas no SDK da Web v3. Examine as notas sobre a 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 entrega de conteúdo), atualize as referências à folha de estilo v3 e JavaScript no elemento head dos 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 o npm, atualize para o controle de Azure Mapas mais recente executando o seguinte comando:
npm install azure-maps-control@latest
Examinar métodos de autenticação (opcional)
Para aumentar a segurança, mais métodos de autenticação estã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 obter mais informações sobre a segurança do aplicativo Web do Azure Mapas, confira Gerenciar autenticação no Azure Mapas.
Testando
Testes abrangentes são essenciais durante a migração. Realize testes completos da funcionalidade, do desempenho e da experiência do usuário do aplicativo em diferentes navegadores e dispositivos.
Distribuição gradual
Considere uma estratégia de distribuiçã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, pode migrar com sucesso a sua aplicação do Azure Mapas Web SDK 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, confira Práticas recomendadas do SDK da Web do Azure Mapas.
Próximas etapas
Saiba mais como adicionar mapas a aplicativos Web e móveis usando a biblioteca JavaScript do lado do cliente do Controle de Mapeamento nos Azure Mapas: