Guía de migración del SDK web de Azure Maps
Gracias por elegir el SDK web de Azure Maps para sus necesidades de asignación. Esta guía de migración le ayudará a realizar la transición de la v1 a la v2 y v3, lo que le permitirá aprovechar las características y mejoras más recientes.
Comprensión de los cambios
Antes de iniciar el proceso de migración, es importante familiarizarse con los cambios clave y las mejoras introducidas en el SDK web v3. Revise las notas de la versión para comprender el ámbito de las nuevas características.
Actualización de la versión del SDK web
CDN
Si usa CDN (red de entrega de contenido), actualice las referencias a la hoja de estilos v3 y JavaScript dentro del elemento head de los archivos 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
Si usa npm, actualice al control de Azure Maps más reciente ejecutando el siguiente comando:
npm install azure-maps-control@latest
Revisión de métodos de autenticación (opcional)
Para mejorar la seguridad, se incluyen más métodos de autenticación en el SDK web a partir de la v2. Los nuevos métodos incluyen la autenticación de Microsoft Entra y la autenticación de clave compartida. Para obtener más información sobre la seguridad de aplic. web en Azure Maps, consulte Administración de la autenticación en Azure Maps.
Prueba
Las pruebas completas son esenciales durante la migración. Realice pruebas exhaustivas de funcionalidad, rendimiento y la experiencia de usuario de la aplicación en diferentes exploradores y dispositivos.
Lanzamiento gradual
Considere una estrategia de lanzamiento gradual para la versión actualizada. Libere la versión migrada a un grupo de usuarios más pequeño o en un entorno controlado antes de que esté disponible para toda la base de usuarios.
Siguiendo estos pasos y teniendo en cuenta los procedimientos recomendados, podrá migrar correctamente la aplicación desde el SDK web de Azure Maps v1 y v2 a v3. Adopte las nuevas funcionalidades y mejoras que ofrece la versión más reciente, a la vez que garantiza una transición fluida y sin problemas para los usuarios. Para obtener más información, consulte los procedimientos recomendados del SDK web de Azure Maps.
Pasos siguientes
Obtenga información sobre cómo agregar mapas a aplicaciones web y móviles mediante la biblioteca de JavaScript del lado cliente de Control de mapa de Azure Maps: