Notes de publication du contrôle de carte du SDK web
Ce document contient des informations sur les nouvelles fonctionnalités et d’autres modifications apportées au contrôle de carte.
v3 (dernière version)
3.4.0 (CDN : 30 septembre 2024, npm : 2 octobre)
Nouvelles fonctionnalités
- Ajoutez la prise en charge de PMTiles.
Résolution des bogues
- Accessibilité : résolution du problème de dépassement de capacité avec l’étiquette du sélecteur de style dans les petits conteneurs.
- Correction de l’attribution non mise à jour après les modifications de style avec une source de données GeoJSON.
- Corrigez
setCamera
les limites et le zoom min/max. - Utilisez
ResizeObserver
plutôt que les événements de redimensionnement de fenêtre. - Corrigez la largeur du logo du pied de page.
Autres modifications
- Ajouter
@types/geojson
en tant que dépendance. - Mettre à jour la dépendance
@microsoft/applicationinsights-web
vers^3.3.0
3.3.0 (8 août 2024)
Nouvelles fonctionnalités
- Mettre à jour le contrôle copyright
- Faites en sorte que le texte de copyright soit plus petit et assurez-vous qu’il s’adapte à une ligne.
- Utilisez différents types de logos Microsoft pour différents thèmes CSS pour améliorer la visibilité.
- Implémentez RWD pour masquer une partie du composant (logo MS) lorsque le canevas de carte est relativement petit.
- Améliorez la classe de couche de base en ajoutant des fonctions abstraites
getOptions
.setOptions
Résolution des bogues
- Ignorez les sources existantes lors de la copie des couches utilisateur.
- [CASSANT] Traitez l’ordre incorrect des valeurs de latitude et de longitude dans
Position.fromLatLng()
. - Corrigez le problème visible de l’élément accessible masqué sur les boutons de contrôle.
3.2.1 (13 mai 2024)
Nouvelles fonctionnalités
- Limitez le mouvement panoramique horizontal lorsqu’il
renderWorldCopies
est défini surfalse
. - Rendre et
flyTo
l’animationeaseTo
plus fluide lorsque le point cible est proche des limites : maxBounds, vertical world edges ou antimeridian.
Résolution des bogues
- Corrigez les numéros accessibles pour les contrôles masqués lors de l’utilisation de la commande « Afficher les nombres ».
- Corrigez la fuite de mémoire dans worker lorsque la carte est supprimée.
- Corrigez les modifications de zoom et de panoramique indésirables à la fin d’un mouvement panoramique.
Autres modifications
- Améliorez le format du code inline dans le document.
3.2.0 (29 mars 2024)
Autres modifications
Mettez à niveau MapLibre vers V4.
Corrigez la valeur par défaut de
HtmlMarkerOptions.pixelOffset
from[0, -18]
to[0, 0]
dans la documentation.
3.1.2 (22 février 2024)
Nouvelles fonctionnalités
- Ajout
fillAntialias
de l’option permettant d’activerPolygonLayer
l’anticrénelage MSAA sur les remplissages de polygones.
Autres modifications
- Mettez à jour l’icône de commentaires et le lien.
3.1.1 (26 janvier 2024)
Nouvelles fonctionnalités
- Ajout d’une nouvelle option,
enableAccessibilityLocationFallback
pour activer ou désactiver la secours de l’API de géocodage inverse pour l’accessibilité (lecteur d’écran).
Résolution des bogues
- Résolution d’un problème où ApplicationInsights v3.0.5 envoyait potentiellement un grand nombre de requêtes.
3.1.0 (12 janvier 2024)
Nouvelles fonctionnalités
Ajout d’un nouveau contrôle,
atlas.control.ScaleControl
pour afficher une barre d’échelle sur la carte.Fonctions introduites pour l’accès, la mise à jour et la suppression d’un état de fonctionnalité.
Résolution des bogues
Nous avons résolu le problème de l’ordre des couches après une mise à jour de style, lorsqu’une couche utilisateur est insérée avant une autre couche utilisateur.
[CASSANT] Aligné le comportement du modèle de remplissage de polygone avec Maplibre. À présent, l’option
fillPattern
désactive constamment l’optionfillColor
. Lors de la configurationfillColor
des couches de polygones, vérifiez qu’ellefillPattern
est définieundefined
sur .
3.0.3 (29 novembre 2023)
Nouvelles fonctionnalités
- Prise en charge ESM incluse.
Autres modifications
La fonctionnalité d’accessibilité du lecteur d’écran a été mise à niveau pour utiliser l’API Search V2 (géocodage inverse).
Accessibilité améliorée dans les contrôles Boussole et Pitch.
3.0.2 (1er novembre 2023)
Résolution des bogues
- Correction de plusieurs erreurs dans le fichier de déclaration de type et ajout d’une dépendance pour
@maplibre/maplibre-gl-style-spec
.
Autres modifications
Suppression des en-têtes d’autorisation du style, de la miniature, du sprite et des requêtes de glyphe pour améliorer la mise en cache CDN pour les ressources statiques.
Mise à jour de la documentation pour
map.clear()
etlayers.clear()
.
3.0.1 (6 octobre 2023)
Résolution des bogues
Diverses améliorations dans le domaine de l’accessibilité.
Résolution du problème d’attribution dynamique lorsque le chargement progressif est activé.
Correction des noms d’événements manquants dans
HtmlMarkerEvents
.
Autres modifications
Modification des méthodes membres à protéger pour les contrôles de zoom, d’inclinaison et de boussole.
La télémétrie est désactivée par défaut dans le cloud Azure Government.
3.0.0 (18 août 2023)
Résolution des bogues
Correction du contrôle de zoom pour tenir compte des
maxBounds
CameraOptions.Correction d’un problème lié au décalage des positions de la souris après une transformation d’échelle css sur le conteneur de carte.
Autres modifications
Suppression progressive de la version de définition de style
2022-08-05
et passage de la valeur par défautstyleDefinitionsVersion
à2023-01-01
.Ajout du paramètre
mvc
pour englober la version du contrôle de carte dans les définitions et les demandes de style.
Installation
La version est disponible sur npm et CDN.
NPM : consultez les instructions sur azure-maps-control@3.0.0
CDN : Référencez les fichiers CSS et JavaScript suivants dans l’élément
<head>
d’un fichier 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 juillet 2023)
Résolution des bogues
Ratio de pixels dynamique corrigé dans la dépendance maplibre-gl sous-jacente.
Correction d’un problème lié à la non application de
sortKey
,radialOffset
,variableAnchor
en cas d’utilisation dans les optionsSymbolLayer
.
Installation
Cette préversion est disponible sur npm et CDN.
NPM : consultez les instructions dans azure-maps-control@3.0.0-preview.10
CDN : Référencez les fichiers CSS et JavaScript suivants dans l’élément
<head>
d’un fichier 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 juin 2023)
Nouvelles fonctionnalités
WebGL2 est utilisé par défaut.
API d’élévation :
atlas.sources.ElevationTileSource
,map.enableElevation(elevationSource, options)
,map.disableElevation()
Capacité de personnaliser maxPitch/minPitch dans
CameraOptions
Résolution des bogues
- Correction d’un problème de duplication des éléments d’accessibilité DOM lorsque
map.setServiceOptions
est appelé
Installation
Cette préversion est disponible sur npm et CDN.
NPM : reportez-vous aux instructions sur azure-maps-control@3.0.0-preview.9
CDN : Référencez les fichiers CSS et JavaScript suivants dans l’élément
<head>
d’un fichier 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 juin 2023)
Résolution des bogues
Correction d’une exception qui s’est produite lors de la mise à jour de la propriété d’une disposition qui n’existe plus.
Correction d’un problème où les indicateurs accessibles de BubbleLayer n’étaient pas mis à jour lors de la modification de la source de données.
Correction d’une erreur dans les appels suivants
map.setStyle()
si le style Maplibre brut était récupéré dans le rappel d’événement lors de lastylechanged
sérialisation du style.
Autres modifications
- Logo et lien d’attribution mis à jour.
Installation
Cette préversion est disponible sur npm et CDN.
NPM : renvoie aux instructions sur azure-maps-control@3.0.0-preview.8
CDN : Référencez les fichiers CSS et JavaScript suivants dans l’élément
<head>
d’un fichier 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 mai 2023)
Nouvelles fonctionnalités
- En plus de la configuration de la carte, Map.setServiceOptions() prend désormais en charge la modification de
domain
,styleAPIVersion
etstyleDefinitionsVersion
durant l’exécution.
Résolution des bogues
Correction de l’exception de jeton expiré lors des relances pendant l’utilisation d’Azure AD / de jeton partagé / d’authentification anonyme en s’assurant que l’authentification est résolue avant toute demande de définition de style
Correction de la définition de style redondante et des demandes de miniatures
Correction d’une application incorrecte de
aria-label
à l’élément de bouton de contrôle de zoom arrièreCorrection de la possibilité d’un conteneur d’éléments de copyright non défini lorsque withRuleBasedAttribution a la valeur false
Correction de la possibilité de suppression de l’écouteur d’événement appelée sur la cible non définie dans
EventManager.remove()
Installation
Cette préversion est disponible sur npm et CDN.
NPM : revoit aux instructions sur azure-maps-control@3.0.0-preview.7
CDN : Référencez les fichiers CSS et JavaScript suivants dans l’élément
<head>
d’un fichier 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 mars 2023)
Installation
Cette préversion est disponible sur npm et CDN.
NPM : Revoit aux instructions sur azure-maps-control@3.0.0-preview.6
CDN : Référencez les fichiers CSS et JavaScript suivants dans l’élément
<head>
d’un fichier 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>
Nouvelles fonctionnalités
- Optimisation du niveau de performance de la transformation du style interne.
Résolution des bogues
Résolution d’un problème où la première requête de jeu de style n’était pas authentifiée pour l’authentification
AAD
.Requêtes redondantes éliminées lors de l’initialisation de la carte et des événements de changement de style.
3.0.0-preview.5 (15 mars 2023)
Installation
Cette préversion est disponible sur npm et CDN.
NPM : Reportez-vous aux instructions sur azure-maps-control@3.0.0-preview.5
CDN : Référencez les fichiers CSS et JavaScript suivants dans l’élément
<head>
d’un fichier 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>
Nouvelles fonctionnalités
- Prise en charge de la mise à jour dynamique de mapConfiguration à travers
map.setServiceOptions({ mapConfiguration: 'MAP_CONFIG' })
3.0.0-preview.4 (10 mars 2023)
Installation
Cette préversion est disponible sur npm et CDN.
NPM : Reportez-vous aux instructions sur azure-maps-control@3.0.0-preview.4
CDN : Référencez les fichiers CSS et JavaScript suivants dans l’élément
<head>
d’un fichier 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>
Nouvelles fonctionnalités
Couverture cartographique étendue en Chine, au Japon et en Corée.
Aperçu des styles de cartes actualisés (Route/Nuit/Hybride/Échelle de gris foncé/Échelle de gris clair/Terra/Contraste élevé foncé/Contraste élevé clair).
Plus de détails sur les routes/l’encombrement des bâtiments/la couverture des sentiers.
Plages de niveaux de zoom plus larges (1~21) pour le style Terra.
Plus de détails sur les transports en commun, y compris les ferries, les métros et les arrêts de bus.
Informations supplémentaires sur l’altitude des montagnes et l’emplacement des cascades.
Modifications
Les données de trafic prennent désormais uniquement en charge le mode relatif.
showBuildingModels
Déconseillé dans StyleOptions.Modification de la valeur par défaut
minZoom
de -2 à 1.
Résolution des bogues
Nettoyage de diverses fuites de mémoire dans Map.dispose().
Amélioration de la navigation par onglets du sélecteur de style pour l’accessibilité dans la disposition de la liste.
Changement de style optimisé en évitant le clonage profond des objets.
Correction d’une exception qui se produisait dans SourceManager lors d’un changement de style avec des sources qui n’étaient pas vectorielles ni raster.
[NOUVEAUTÉ] Les anciens événements
sourceadded
sont émis uniquement si de nouvelles sources sont ajoutées au style. À présent, les événementssourceremoved
/sourceadded
sont émis lorsque la nouvelle source et la source d’origine dans le style actuel ne sont pas égales, même si elles ont le même ID de source.
3.0.0-preview.3 (2 février 2023)
Installation
Cette préversion est disponible sur npm et CDN.
NPM : Reportez-vous aux instructions sur azure-maps-control@3.0.0-preview.3
CDN : Référencez les fichiers CSS et JavaScript suivants dans l’élément
<head>
d’un fichier 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>
Nouvelles fonctionnalités
[ARRÊT] Migration de adal-angular vers @azure/msal-browser utilisé pour l’authentification avec Microsoft Azure Active Directory (Azure AD). Modifications qui pourraient être nécessaires :
- Le type
Platform / Reply URL
doit être défini surSingle-page application
sur le portail d’inscription Azure AD App. - Un changement de code est nécessaire si
authOptions.authContext
un personnalisé est utilisé. - Pour en savoir plus, voir Comment migrer une application JavaScript d’ADAL.js vers MSAL.js.
- Le type
Autoriser la définition du pitch (inclinaison) et du bearing (rotation) avec CameraBoundsOptions dans Map.setCamera(options).
Résolution des bogues
Correction d’un problème dans le mappage de langue, maintenant
zh-Hant-TW
ne revient plus àen-US
.Correction de l’impossibilité de basculer entre les régions utilisateur (affichage).
Correction de l’exception qui s’est produite lors du changement de style alors que le chargement progressif de la couche est en cours.
Correction de la récupération des informations d’accessibilité à partir des couches d’étiquette de vignette de carte.
Correction du problème occasionnel dans lequel les vignettes vectorielles ne sont pas rendues après l’ajout d’images via ImageSpriteManager.add().
3.0.0-preview.2 (16 décembre 2022)
Installation
Cette préversion est disponible sur npm et CDN.
NPM : Reportez-vous aux instructions sur azure-maps-control@3.0.0-preview.2
CDN : Référencez les fichiers CSS et JavaScript suivants dans l’élément
<head>
d’un fichier 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>
Nouvelles fonctionnalités
Ajoutez progressiveLoading
et progressiveLoadingInitialLayerGroups
à StyleOptions pour permettre le chargement progressif des couches de carte. Cette fonctionnalité améliore le temps de chargement perçu de la carte. Pour plus d’informations, consultez les notes de publication de la version 2.2.2.
Résolution des bogues
Correction d’un problème lié au fait que l’ordre des couches utilisateur n’était pas conservé après l’appel de
map.layers.move()
.Correction de l’impossibilité de désactiver les incidents de trafic dans TrafficControlOptions quand
new atlas.control.TrafficControl({incidents: false})
est utilisé.Ajoutez
.atlas-map
à tous les sélecteurs CSS pour étendre les styles dans le conteneur de carte. Le correctif empêche le CSS d’ajouter accidentellement des styles indésirables à d’autres éléments de la page.
3.0.0-preview.1 (18 novembre 2022)
Installation
La préversion est disponible sur npm.
Installez azure-maps-control@next à vos dépendances :
npm i azure-maps-control@next
Nouvelles fonctionnalités
Cette mise à jour est la première préversion de la prochaine version 3.0.0. La dépendance maplibre-gl sous-jacente a été mise à niveau de 1.14
vers 3.0.0-pre.1
, offrant des améliorations en matière de stabilité et de performances.
Résolution des bogues
Correction d’un problème de régression qui empêche IndoorManager de supprimer un tileset :
indoorManager.setOptions({ tilesetId: undefined })
v2
2.3.7 (22 février 2024)
Nouvelles fonctionnalités
- Ajout
fillAntialias
de l’option permettant d’activerPolygonLayer
l’anticrénelage MSAA sur les remplissages de polygones. - Ajout d’une nouvelle option,
enableAccessibilityLocationFallback
pour activer ou désactiver la secours de l’API de géocodage inverse pour l’accessibilité (lecteur d’écran).
Autres modifications
- Mettez à jour l’icône de commentaires et le lien.
2.3.6 (12 janvier 2024)
Nouvelles fonctionnalités
Ajout d’un nouveau contrôle,
atlas.control.ScaleControl
pour afficher une barre d’échelle sur la carte.Fonctions introduites pour l’accès, la mise à jour et la suppression d’un état de fonctionnalité.
Résolution des bogues
- Nous avons résolu le problème de l’ordre des couches après une mise à jour de style, lorsqu’une couche utilisateur est insérée avant une autre couche utilisateur.
2.3.5 (29 novembre 2023)
Autres modifications
- La fonctionnalité d’accessibilité du lecteur d’écran a été mise à niveau pour utiliser l’API Search V2 (géocodage inverse).
2.3.4 (1er novembre 2023)
Autres modifications
Suppression des en-têtes d’autorisation du style, de la miniature, du sprite et des requêtes de glyphe pour améliorer la mise en cache CDN pour les ressources statiques.
Mise à jour de la documentation pour
map.clear()
etlayers.clear()
.
2.3.3 (6 octobre 2023)
Résolution des bogues
- Résolution du problème d’attribution dynamique lorsque le chargement progressif est activé.
2.3.2 (11 août 2023)
Résolution des bogues
Correction d’un problème de duplication des éléments d’accessibilité DOM lorsque
map.setServiceOptions
est appelé.Correction du contrôle de zoom pour tenir compte des
maxBounds
CameraOptions.
Autres modifications
- Ajout du paramètre
mvc
pour englober la version du contrôle de carte dans les définitions et les demandes de style.
2.3.1 (27 juin 2023)
Résolution des bogues
- Correction du problème pouvant entraîner la suppression des images de l’icône
ImageSpriteManager
lors du changement de style
Autres modifications
- Sécurité : correction du problème de génération aléatoire et insécure de l’UUID.
2.3.0 (2 juin 2023)
Nouvelles fonctionnalités
- [EN COURS] Refactorisation du StyleManager interne pour remplacer
_stylePatch
partransformStyle
. Cette modification permettra aux icônes de protection routière de se mettre à jour et de s’afficher correctement après un changement de style.
Résolution des bogues
Correction d’une exception qui s’est produite lors de la mise à jour de la propriété d’une disposition qui n’existe plus.
Correction d’un problème où les indicateurs accessibles de BubbleLayer n’étaient pas mis à jour lors de la modification de la source de données.
Autres modifications
- Logo et lien d’attribution mis à jour.
2.2.7 (2 mai 2023)
Nouvelles fonctionnalités
- En plus de la configuration de la carte, Map.setServiceOptions() prend désormais en charge la modification de
domain
,styleAPIVersion
etstyleDefinitionsVersion
durant l’exécution.
Résolution des bogues
Correction de l’exception de jeton expiré lors des relances pendant l’utilisation d’Azure AD / de jeton partagé / d’authentification anonyme en s’assurant que l’authentification est résolue avant toute demande de définition de style
Correction de la définition de style redondante et des demandes de miniatures
Correction d’une application incorrecte de
aria-label
à l’élément de bouton de contrôle de zoom arrièreCorrection de la possibilité d’un conteneur d’éléments de copyright non défini lorsque withRuleBasedAttribution a la valeur false
Correction de la possibilité de suppression de l’écouteur d’événement appelée sur la cible non définie dans EventManager.remove()
2.2.6
Résolution des bogues
Résolution d’un problème où la première requête de jeu de style n’était pas authentifiée pour l’authentification
AAD
.Requêtes redondantes éliminées lors de l’initialisation de la carte et des événements de changement de style.
2.2.5
Nouvelles fonctionnalités
- Prise en charge de la mise à jour dynamique de mapConfiguration à travers
map.setServiceOptions({ mapConfiguration: 'MAP_CONFIG' })
2.2.4
Résolution des bogues
Nettoyage de diverses fuites de mémoire dans Map.dispose().
Amélioration de la navigation par onglets du sélecteur de style pour l’accessibilité dans la disposition de la liste.
2.2.3
Nouvelles fonctionnalités
- Autoriser la définition du pitch (inclinaison) et du bearing (rotation) avec CameraBoundsOptions dans Map.setCamera(options).
Résolution des bogues
Correction d’un problème dans le mappage de langue, maintenant
zh-Hant-TW
ne revient plus àen-US
.Correction de l’impossibilité de basculer entre les régions utilisateur (affichage).
Correction de l’exception qui s’est produite lors du changement de style alors que le chargement progressif de la couche est en cours.
Correction de la récupération des informations d’accessibilité à partir des couches d’étiquette de vignette de carte.
Correction du problème occasionnel dans lequel les vignettes vectorielles ne sont pas rendues après l’ajout d’images via ImageSpriteManager.add().
2.2.2 (15 décembre 2022)
Nouvelles fonctionnalités
Ajoutez progressiveLoading
et progressiveLoadingInitialLayerGroups
à StyleOptions pour permettre le chargement progressif des couches de carte. Cette fonctionnalité améliore le temps de chargement perçu de la carte.
progressiveLoading
- Permet le chargement progressif des couches de carte.
- La valeur par défaut est
false
.
progressiveLoadingInitialLayerGroups
- Spécifie les groupes de couches à charger en premier.
- La valeur par défaut est
["base"]
. - Les valeurs possibles sont
base
,transit
,labels
,buildings
etlabels_places
. - D’autres groupes de couches sont différés de sorte que les groupes de couches initiaux peuvent être chargés en premier.
Résolution des bogues
Correction d’un problème lié au fait que l’ordre des couches utilisateur n’était pas conservé après l’appel de
map.layers.move()
.Correction de l’impossibilité de désactiver les incidents de trafic dans TrafficControlOptions quand
new atlas.control.TrafficControl({incidents: false})
est utilisé.
Étapes suivantes
Explorez des exemples présentant Azure Maps :
Restez informé sur Azure Maps :