Notas de la versión del control de mapa del SDK web

Este documento contiene información sobre las características nuevas y otros cambios en el Control de mapa.

v3 (más reciente)

3.5.0 (CDN: 4 de noviembre de 2024, npm: 7 de noviembre)

Nuevas características

• Agregue compatibilidad con el control de pantalla completa.

Corrección de errores

• Exponga el nuevo tipo en PolygonExtrusionLayerOptions.fillPattern para admitir DataDrivenPropertyValueSpecification<string>.

3.4.0 (CDN: 30 de septiembre de 2024, npm: 2 de octubre)

Nuevas características

• Agregue compatibilidad con PMTiles.

Corrección de errores

• Accesibilidad: corrija el problema de desbordamiento con la etiqueta del selector de estilo en contenedores pequeños.
• Corregir la atribución no se actualiza después de los cambios de estilo con un origen de datos GeoJSON.
• Corrección setCamera con límites y zoom mínimo/máximo.
• Use ResizeObserver en lugar de eventos de cambio de tamaño de ventana.
• Corregir el ancho del logotipo del pie de página.

Otros cambios

• Agregue @types/geojson como dependencia.
• Actualización de la dependencia @microsoft/applicationinsights-web a ^3.3.0

3.3.0 (8 de agosto de 2024)

Nuevas características

• Actualizar el control de copyright
  • Haga que el texto de copyright sea más pequeño y asegúrese de que encaja en una sola línea.
  • Use diferentes tipos de logotipos de Microsoft para diferentes temas CSS para mejorar la visibilidad.
  • Implemente RWD para ocultar parte del componente (logotipo de MS) cuando el lienzo del mapa es relativamente pequeño.
• Mejore la clase de capa base agregando funciones y setOptions abstractasgetOptions.

Corrección de errores

• Omita los orígenes existentes al copiar capas de usuario.
• [IMPORTANTE] Direccione la ordenación incorrecta de los valores de latitud y longitud en Position.fromLatLng().
• Se ha corregido un problema visible del elemento accesible oculto en los botones de control.

3.2.1 (13 de mayo de 2024)

Nuevas características

• Restrinja el movimiento panorámico horizontal cuando renderWorldCopies se establece falseen .
• Suavizar easeTo la animación y flyTo el punto de destino cuando el punto de destino está cerca de los límites: maxBounds, vertical world edges o antimeridian.

Corrección de errores

• Corrija los números accesibles para los controles ocultos mientras se usa el comando "Mostrar números".
• Corrija la pérdida de memoria en el trabajo cuando se quite el mapa.
• Corregir cambios de movimiento panorámico y zoom no deseados al final de un movimiento panorámico.

Otros cambios

• Mejore el formato del código insertado en el documento.

3.2.0 (29 de marzo de 2024)

Otros cambios

• Actualice MapLibre a V4.

• Corrija el valor predeterminado de HtmlMarkerOptions.pixelOffset de [0, -18] a [0, 0] en el documento.

3.1.2 (22 de febrero de 2024)

Nuevas características

• Se ha agregado fillAntialias la opción a PolygonLayer para habilitar el suavizado de suavizado de MSAA en rellenos de polígono.

Otros cambios

• Actualice el icono de comentarios y el vínculo.

3.1.1 (26 de enero de 2024)

Nuevas características

• Se ha agregado una nueva opción, enableAccessibilityLocationFallback, para habilitar o deshabilitar la reserva de api de geocodificación inversa para la accesibilidad (lector de pantalla).

Corrección de errores

• Se ha resuelto un problema que provocaba que ApplicationInsights v3.0.5 enviara un gran número de solicitudes.

3.1.0 (12 de enero de 2024)

Nuevas características

• Se ha agregado un nuevo control, atlas.control.ScaleControl, para mostrar una barra de escalado en el mapa.

• Se introdujeron funciones para acceder, actualizar y eliminar un estado de característica.

Corrección de errores

• Se ha corregido el problema de la ordenación de capas después de una actualización de estilo, cuando se inserta una capa de usuario antes de otra capa de usuario.

• [IMPORTANTE] Alineó el comportamiento del patrón de relleno de polígono con Maplibre. Ahora, la fillPattern opción deshabilita de forma coherente la fillColor opción. Al configurar fillColor para capas de polígono, asegúrese de que fillPattern está establecido undefineden .

3.0.3 (29 de noviembre de 2023)

Nuevas características

• Se incluye compatibilidad con ESM.

Otros cambios

• La característica de accesibilidad para el lector de pantalla se ha actualizado para usar search V2 API (geocodificación inversa).

• Accesibilidad mejorada en los controles Compass y Pitch.

3.0.2 (1 de noviembre de 2023)

Corrección de errores

• Se han solucionado varios errores en el archivo de declaración de tipos y se agregó una dependencia para @maplibre/maplibre-gl-style-spec.

Otros cambios

• Se han quitado los encabezados de autorización de solicitudes de estilo, miniatura, sprite y glifo para mejorar el almacenamiento en caché de CDN para los recursos estáticos.

• Se ha actualizado la documentación de map.clear() y layers.clear().

3.0.1 (6 de octubre de 2023)

Corrección de errores

• Varias mejoras de accesibilidad.

• Se resolvió el problema con la atribución dinámica cuando se habilita la carga progresiva.

• Se corrigieron los nombres de eventos ausentes en HtmlMarkerEvents.

Otros cambios

• Se modificaron los métodos de miembros, que se protegerán para los controles de zoom, inclinación y brújula.

• La telemetría está deshabilitada de manera predeterminada en la nube de Azure Government.

3.0.0 (18 de agosto de 2023)

Corrección de errores

• Se ha corregido el control de zoom para tener en cuenta CameraOptions maxBounds .

• Se ha corregido un problema por el que las posiciones del mouse se desplazaban después de una transformación de escala css en el contenedor del mapa.

Otros cambios

• Se ha eliminado gradualmente la versión de definición de estilo 2022-08-05 y se ha cambiado el valor predeterminado styleDefinitionsVersion a 2023-01-01.

• Se agregó el parámetro mvc para abarcar la versión del control de mapa en las definiciones y las solicitudes de estilo.

Instalación

La versión está disponible en npm y CDN.

• NPM: consulte las instrucciones en azure-maps-control@3.0.0

• CDN: Haga referencia a los CSS y JavaScript siguientes en el elemento <head> de un archivo HTML:

  <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0/atlas.min.css" rel="stylesheet" />
  <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0/atlas.min.js"></script>
  

3.0.0-preview.10 (11 de julio de 2023)

Corrección de errores

• Relación de píxeles dinámica fija en la dependencia maplibre-gl subyacente.

• Se ha corregido un problema por el que sortKey, radialOffset y variableAnchor no se aplican cuando se usa en las opciones de SymbolLayer.

Instalación

La versión preliminar está disponible en npm y CDN.

• NPM: consulte las instrucciones en azure-maps-control@3.0.0-preview.10

• CDN: Haga referencia a los CSS y JavaScript siguientes en el elemento <head> de un archivo HTML:

  <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.10/atlas.min.css" rel="stylesheet" />
  <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.10/atlas.min.js"></script>
  

3.0.0-preview.9 (27 de junio de 2023)

Nuevas características

• WebGL2 se usa de manera predeterminada.

• API de elevación: atlas.sources.ElevationTileSource, map.enableElevation(elevationSource, options), map.disableElevation()

• Capacidad de personalizar maxPitch / minPitch en CameraOptions

Corrección de errores

• Se ha corregido un problema por el que podían duplicarse elementos DOM relacionados con la accesibilidad cuando se llamaba a map.setServiceOptions

Instalación

La versión preliminar está disponible en npm y CDN.

• NPM: consulte las instrucciones en azure-maps-control@3.0.0-preview.9

• CDN: Haga referencia a los CSS y JavaScript siguientes en el elemento <head> de un archivo HTML:

  <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.9/atlas.min.css" rel="stylesheet" />
  <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.9/atlas.min.js"></script>
  

3.0.0-preview.8 (2 de junio de 2023)

Corrección de errores

• Se ha corregido una excepción que se producía al actualizar la propiedad de un diseño que ya no existe.

• Se ha corregido un problema por el que los indicadores accesibles de BubbleLayer no se actualizaban cuando se modificaba el origen de datos.

• Se ha corregido un error en las llamadas posteriores de map.setStyle() si el estilo Maplibre sin procesar se recupera en la devolución de llamada del evento stylechanged en la serialización de estilo.

Otros cambios

• Se ha actualizado el logotipo y el vínculo de atribución.

Instalación

La versión preliminar está disponible en npm y CDN.

• NPM: consulte las instrucciones en azure-maps-control@3.0.0-preview.8

• CDN: Haga referencia a los CSS y JavaScript siguientes en el elemento <head> de un archivo HTML:

  <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.8/atlas.min.css" rel="stylesheet" />
  <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.8/atlas.min.js"></script>
  

3.0.0-preview.7 (2 de mayo de 2023)

Nuevas características

• Además de la configuración de mapa, Map.setServiceOptions() ahora admite el cambio de domain, styleAPIVersion y styleDefinitionsVersion en el tiempo de ejecución.

Corrección de errores

• Se ha corregido una excepción de token expirada al volver a iniciar cuando se usa Azure AD, token compartido o autenticación anónima. Esto se ha logrado al garantizar que la autenticación se resuelva antes de cualquier solicitud de definición de estilo

• Definición de estilo redundante corregido y solicitudes en miniatura

• Se ha corregido un error de aria-label en el elemento del botón de control de alejar

• Se ha corregido la posibilidad de un contenedor de elementos de copyright sin definir cuando withRuleBasedAttribution se establezca en false

• Se ha corregido la posibilidad de quitar el agente de escucha de eventos al que se llama en el destino no definido en EventManager.remove()

Instalación

La versión preliminar está disponible en npm y CDN.

• NPM: consulte las instrucciones en azure-maps-control@3.0.0-preview.7

• CDN: Haga referencia a los CSS y JavaScript siguientes en el elemento <head> de un archivo HTML:

  <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.7/atlas.min.css" rel="stylesheet" />
  <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.7/atlas.min.js"></script>
  

3.0.0-preview.6 (31 de marzo de 2023)

Instalación

La versión preliminar está disponible en npm y CDN.

• NPM: consulte las instrucciones en azure-maps-control@3.0.0-preview.6

• CDN: Haga referencia a los CSS y JavaScript siguientes en el elemento <head> de un archivo HTML:

  <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.6/atlas.min.css" rel="stylesheet" />
  <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.6/atlas.min.js"></script>
  

Nuevas características

• Optimiza el rendimiento de la transformación de estilo interno.

Corrección de errores

• Se ha resuelto un problema por el que la primera solicitud de conjunto de estilos no estaba autenticada para AAD autenticación.

• Elimina las solicitudes redundantes durante la inicialización del mapa y en los eventos de estilo modificados.

3.0.0-preview.5 (15 de marzo de 2023)

Instalación

La versión preliminar está disponible en npm y CDN.

• NPM: consulte las instrucciones en azure-maps-control@3.0.0-preview.5

• CDN: Haga referencia a los CSS y JavaScript siguientes en el elemento <head> de un archivo HTML:

  <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.5/atlas.min.css" rel="stylesheet" />
  <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.5/atlas.min.js"></script>
  

Nuevas características

• Compatibilidad con la actualización dinámica de mapConfiguration mediante map.setServiceOptions({ mapConfiguration: 'MAP_CONFIG' })

3.0.0-preview.4 (10 de marzo de 2023)

Instalación

La versión preliminar está disponible en npm y CDN.

• NPM: Consulta las instrucciones en azure-maps-control@3.0.0-preview.4

• CDN: Haga referencia a los CSS y JavaScript siguientes en el elemento <head> de un archivo HTML:

  <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.4/atlas.min.css" rel="stylesheet" />
  <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.4/atlas.min.js"></script>
  

Nuevas características

• Cobertura ampliada de mapas en China, Japón y Corea.

• Vista previa de estilos de mapa actualizados (Carretera / Noche / Híbrido / Escala de grises oscuro / Escala de grises claro / Terra / Alto contraste oscuro / Alto contraste claro).

• Más detalles sobre las superficies de carreteras, edificios y rutas de cobertura.

• Rangos de nivel de zoom más amplios (1~21) para el estilo Terra.

• Más detalles sobre el transporte público, incluidos ferris, metros y paradas de autobús.

• Información adicional sobre la altitud de las montañas y la ubicación de las cascadas.

Cambios

• Ahora, los datos de tráfico solo son compatibles con el modo relativo.

• En desuso showBuildingModels en StyleOptions.

• Se ha cambiado el valor predeterminado minZoom de -2 a 1.

Corrección de errores

• Limpió varias fugas de memoria en Map.dispose().

• Se ha mejorado la navegación por pestañas del selector de estilos para la accesibilidad en el diseño de lista.

• Cambio de estilo optimizado evitando la clonación profunda de objetos.

• Se ha corregido una excepción que se producía en SourceManager al cambiar de estilo con orígenes que no eran vectores ni tramas.

• [IMPORTANTE] Los eventos anteriores sourceadded solo se emiten si se agregan nuevos orígenes al estilo. Ahora los eventos sourceremoved / sourceadded se emiten cuando el nuevo origen y el origen original en el estilo actual no son iguales, incluso si tienen el mismo identificador de origen.

3.0.0-preview.3 (2 de febrero de 2023)

Instalación

La versión preliminar está disponible en npm y CDN.

• NPM: Consulte las instrucciones en azure-maps-control@3.0.0-preview.3

• CDN: Haga referencia a los CSS y JavaScript siguientes en el elemento <head> de un archivo HTML:

  <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.3/atlas.min.css" rel="stylesheet" />
  <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.3/atlas.min.js"></script>
  

Nuevas características

• [IMPORTANTE] Migrado de adal-angular a @azure/msal-browser usado para la autenticación con Microsoft Azure Active Directory (Azure AD). Cambios que podrían ser necesarios:

  • Platform / Reply URL El tipo debe establecerse en Single-page application en el portal de registro de aplicación de Azure AD.
  • El cambio de código es necesario si se usa un authOptions.authContext personalizado.
  • Para obtener más información, consulte Cómo migrar aplicación de JavaScript de ADAL.js a MSAL.js.

• Permite que la inclinación y el rodamiento se establezcan con CameraBoundsOptions en Map.setCamera(options).

Corrección de errores

• El problema solucionado en la asignación de lenguaje, ahora zh-Hant-TW no regresa a en-US.

• La incapacidad para cambiar entre regiones de usuario (ver) fue corregida.

• Se corrigió la excepción que ocurría cuando se cambiaba de estilo mientras la carga de capa progresiva estaba en curso.

• Se corrigió la recuperación de información de accesibilidad de las capas de etiquetas de mosaicos de mapa.

• Se corrigió el problema ocasional en el que los mosaicos de vector no se vuelven a representar después de agregar imágenes a través de ImageSpriteManager.add().

3.0.0-preview.2 (16 de diciembre de 2022)

Instalación

La versión preliminar está disponible en npm y CDN.

• NPM: Consulte las instrucciones en azure-maps-control@3.0.0-preview.2

• CDN: Haga referencia a los CSS y JavaScript siguientes en el elemento <head> de un archivo HTML:

  <link href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.2/atlas.min.css" rel="stylesheet" />
  <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3.0.0-preview.2/atlas.min.js"></script>
  

Nuevas características

Agregue progressiveLoading y progressiveLoadingInitialLayerGroups a StyleOptions para habilitar la capacidad de cargar capas de mapa de manera progresiva. Esta característica mejora el tiempo de carga percibido del mapa. Para más información, consulte las notas de la versión 2.2.2.

Corrección de errores

• Se corrigió un problema por el cual el orden de las capas de usuario no se conservaba después de llamar a map.layers.move().

• Se corrigió la incapacidad de deshabilitar los incidentes de tráfico en TrafficControlOptions cuando se usa new atlas.control.TrafficControl({incidents: false}).

• Agregue .atlas-map a todos los selectores CSS para definir el ámbito de los estilos dentro del contenedor de mapa. La corrección impide que el CSS agregue accidentalmente estilos no deseados a otros elementos de la página.

3.0.0-preview.1 (18 de noviembre de 2022)

Instalación

La versión preliminar está disponible en npm.

• Instale azure-maps-control@next en las dependencias:

  npm i azure-maps-control@next
  

Nuevas características

Esta actualización es la primera versión preliminar de la próxima versión 3.0.0. La dependencia maplibre-gl subyacente se actualizó de 1.14 a 3.0.0-pre.1, lo que ofrece mejoras en la estabilidad y el rendimiento.

Corrección de errores

• Se corrigió un problema de regresión que evita que IndoorManager quite el conjunto de mosaicos:

  indoorManager.setOptions({
      tilesetId: undefined
  })
  

v2

2.3.7 (22 de febrero de 2024)

Nuevas características

• Se ha agregado fillAntialias la opción a PolygonLayer para habilitar el suavizado de suavizado de MSAA en rellenos de polígono.
• Se ha agregado una nueva opción, enableAccessibilityLocationFallback, para habilitar o deshabilitar la reserva de api de geocodificación inversa para la accesibilidad (lector de pantalla).

Otros cambios

• Actualice el icono de comentarios y el vínculo.

2.3.6 (12 de enero de 2024)

Nuevas características

• Se ha agregado un nuevo control, atlas.control.ScaleControl, para mostrar una barra de escalado en el mapa.

• Se introdujeron funciones para acceder, actualizar y eliminar un estado de característica.

Corrección de errores

• Se ha corregido el problema de la ordenación de capas después de una actualización de estilo, cuando se inserta una capa de usuario antes de otra capa de usuario.

2.3.5 (29 de noviembre de 2023)

Otros cambios

• La característica de accesibilidad para el lector de pantalla se ha actualizado para usar search V2 API (geocodificación inversa).

2.3.4 (1 de noviembre de 2023)

Otros cambios

• Se han quitado los encabezados de autorización de solicitudes de estilo, miniatura, sprite y glifo para mejorar el almacenamiento en caché de CDN para los recursos estáticos.

• Se ha actualizado la documentación de map.clear() y layers.clear().

2.3.3 (6 de octubre de 2023)

Corrección de errores

• Se resolvió el problema con la atribución dinámica cuando se habilita la carga progresiva.

2.3.2 (11 de agosto de 2023)

Corrección de errores

• Se ha corregido un problema por el que podían duplicarse elementos DOM relacionados con la accesibilidad cuando se llamaba a map.setServiceOptions.

• Se ha corregido el control de zoom para tener en cuenta CameraOptions maxBounds .

Otros cambios

• Se agregó el parámetro mvc para abarcar la versión del control de mapa en las definiciones y las solicitudes de estilo.

2.3.1 (27 de junio de 2023)

Corrección de errores

• Se ha corregido un error por el que las imágenes de icono ImageSpriteManager podrían quitarse durante el cambio de estilo

Otros cambios

• Seguridad: corrección de aleatoriedad no segura en la generación de UUID.

2.3.0 (2 junio de 2023)

Nuevas características

• [IMPORTANTE] Refactorizado el StyleManager interno para reemplazar _stylePatch por transformStyle. Este cambio permitirá que los iconos del escudo de carretera se actualicen y representen correctamente después de un cambio de estilo.

Corrección de errores

• Se ha corregido una excepción que se producía al actualizar la propiedad de un diseño que ya no existe.

• Se ha corregido un problema por el que los indicadores accesibles de BubbleLayer no se actualizaban cuando se modificaba el origen de datos.

Otros cambios

• Se ha actualizado el logotipo y el vínculo de atribución.

2.2.7 (2 de mayo de 2023)

Nuevas características

• Además de la configuración de mapa, Map.setServiceOptions() ahora admite el cambio de domain, styleAPIVersion y styleDefinitionsVersion en el tiempo de ejecución.

Corrección de errores

• Se ha corregido una excepción de token expirada al volver a iniciar cuando se usa Azure AD, token compartido o autenticación anónima. Esto se ha logrado al garantizar que la autenticación se resuelva antes de cualquier solicitud de definición de estilo

• Definición de estilo redundante corregido y solicitudes en miniatura

• Se ha corregido un error de aria-label en el elemento del botón de control de alejar

• Se ha corregido la posibilidad de un contenedor de elementos de copyright sin definir cuando withRuleBasedAttribution se establezca en false

• Se ha corregido la posibilidad de quitar el agente de escucha de eventos al que se llama en el destino no definido en EventManager.remove()

2.2.6

Corrección de errores

• Se ha resuelto un problema por el que la primera solicitud de conjunto de estilos no estaba autenticada para AAD autenticación.

• Elimina las solicitudes redundantes durante la inicialización del mapa y en los eventos de estilo modificados.

2.2.5

Nuevas características

• Compatibilidad con la actualización dinámica de mapConfiguration mediante map.setServiceOptions({ mapConfiguration: 'MAP_CONFIG' })

2.2.4

Corrección de errores

• Limpió varias fugas de memoria en Map.dispose().

• Se ha mejorado la navegación por pestañas del selector de estilos para la accesibilidad en el diseño de lista.

2.2.3

Nuevas características

• Permite que la inclinación y el rodamiento se establezcan con CameraBoundsOptions en Map.setCamera(options).

Corrección de errores

• El problema solucionado en la asignación de lenguaje, ahora zh-Hant-TW no regresa a en-US.

• La incapacidad para cambiar entre regiones de usuario (ver) fue corregida.

• Se corrigió la excepción que ocurría cuando se cambiaba de estilo mientras la carga de capa progresiva estaba en curso.

• Se corrigió la recuperación de información de accesibilidad de las capas de etiquetas de mosaicos de mapa.

• Se corrigió el problema ocasional en el que los mosaicos de vector no se vuelven a representar después de agregar imágenes a través de ImageSpriteManager.add().

2.2.2 (15 de diciembre de 2022)

Nuevas características

Agregue progressiveLoading y progressiveLoadingInitialLayerGroups a StyleOptions para habilitar la capacidad de cargar capas de mapa de manera progresiva. Esta característica mejora el tiempo de carga percibido del mapa.

• progressiveLoading
  • Habilita la carga progresiva de capas de mapa.
  • Tiene como valor predeterminado false.
• progressiveLoadingInitialLayerGroups
  • Especifica los grupos de capas que se van a cargar primero.
  • Tiene como valor predeterminado ["base"].
  • Los valores posibles son base, transit, labels, buildings y labels_places.
  • Otros grupos de capas se aplazan de modo que los grupos de capas iniciales se puedan cargar primero.

Corrección de errores

• Se corrigió un problema por el cual el orden de las capas de usuario no se conservaba después de llamar a map.layers.move().

• Se corrigió la incapacidad de deshabilitar los incidentes de tráfico en TrafficControlOptions cuando se usa new atlas.control.TrafficControl({incidents: false}).

Pasos siguientes

Explore ejemplos que muestran Azure Maps:

Ejemplos de Azure Maps

Manténgase al día con Azure Maps:

Blog de Azure Maps