通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Web SDK 地图控件发行说明

  • 项目

本文档包含有关地图控件的新功能和其他更改的信息。

v3（最新版本）

3.5.0 （CDN：2024 年 11 月 4 日，npm：11 月 7 日）

新功能

  • 添加对全屏控件的支持。

Bug 修复

  • 公开要支持DataDrivenPropertyValueSpecification<string>的新类型PolygonExtrusionLayerOptions.fillPattern。

3.4.0 （CDN：2024 年 9 月 30 日，下午： 10 月 2 日）

新功能

  • 添加对 PMTiles 的支持。

Bug 修复

  • 辅助功能：修复了小型容器中样式选取器标签的溢出问题。
  • 修复了使用 GeoJSON 数据源的样式更改后未更新的属性。
  • 使用边界和最小/最大缩放进行修复 setCamera 。
  • 使用 ResizeObserver 而不是窗口调整事件大小。
  • 修复页脚徽标宽度。

其他更改

  • 添加 @types/geojson 为依赖项。
  • 将依赖项 @microsoft/applicationinsights-web 更新到 ^3.3.0

3.3.0 （2024 年 8 月 8 日）

新功能

  • 更新版权控件
    • 使版权文本更小，并确保它适合一行。
    • 为不同的 CSS 主题使用不同类型的Microsoft徽标来提高可见性。
    • 当地图画布相对较小时，实现 RWD 以隐藏部分组件（MS 徽标）。
  • 通过添加抽象 getOptions 和 setOptions 函数来增强基层类。

Bug 修复

  • 复制用户层时跳过现有源。
  • [中断] 解决纬度和经度值在中的 Position.fromLatLng()错误排序问题。
  • 修复了控件按钮上的隐藏可访问元素可见问题。

3.2.1 （2024 年 5 月 13 日）

新功能

  • 当设置为 false 时renderWorldCopies，约束水平平移。
  • 当目标点接近限制时，使 easeTo 动画 flyTo 更流畅：maxBounds、垂直世界边缘或 antimeridian。

Bug 修复

  • 使用“显示数字”命令时，更正隐藏控件的可访问数字。
  • 修复删除映射时辅助角色中的内存泄漏。
  • 修复平移动作末尾不需要的缩放和平移更改。

其他更改

  • 改进文档中内联代码的格式。

3.2.0 （2024 年 3 月 29 日）

其他更改

  • 将 MapLibre 升级到 V4。

  • 更正文档中的HtmlMarkerOptions.pixelOffset默认值。[0, -18] [0, 0]

3.1.2 （2024 年 2 月 22 日）

新功能

  • 添加了 fillAntialias 用于在多边形填充上启用 MSAA 抗锯齿的选项 PolygonLayer 。

其他更改

  • 更新反馈图标和链接。

3.1.1 （2024 年 1 月 26 日）

新功能

  • 添加了一个新选项， enableAccessibilityLocationFallback用于启用或禁用辅助功能（屏幕阅读器）的反向地理编码 API 回退。

Bug 修复

  • 解决了 ApplicationInsights v3.0.5 可能发送大量请求的问题。

3.1.0 （2024 年 1 月 12 日）

新功能

  • 添加了一个新控件， atlas.control.ScaleControl用于在地图上显示缩放条。

  • 引入了用于访问、更新和删除功能状态的函数。

Bug 修复

  • 解决了样式更新后层排序的问题，即在其他用户层之前插入用户层时。

  • [中断] 将多边形填充模式行为与 Maplibre 对齐。 现在，该 fillPattern 选项一直禁用该 fillColor 选项。 为多边形层配置 fillColor 时，请确保 fillPattern 已设置为 undefined。

3.0.3 （2023 年 11 月 29 日）

新功能

  • 包括 ESM 支持。

其他更改

  • 屏幕阅读器的辅助功能已升级，以利用搜索 V2 API（反向地理编码）。

  • 指南针和间距控件中的增强辅助功能。

3.0.2（2023 年 11 月 1 日）

Bug 修复

  • 解决了类型声明文件中的多个错误，并为 @maplibre/maplibre-gl-style-spec 添加了依赖项。

其他更改

  • 删除了样式、缩略图、子画面和字形请求中的授权标头，以增强静态资产的 CDN 缓存。

  • 更新了 map.clear() 和 layers.clear() 的文档。

3.0.1（2023 年 10 月 6 日）

Bug 修复

  • 多项辅助功能改进。

  • 已解决启用渐进式加载时动态归因的问题。

  • 已修复 HtmlMarkerEvents 中丢失的事件名称。

其他更改

  • 已将缩放、俯仰和指南针控件的成员方法修改为受保护。

  • Azure 政府云中默认禁用遥测。

3.0.0（2023 年 8 月 18 日）

Bug 修复

  • 修复了要考虑 CameraOptions 的maxBounds缩放控件。

  • 修复了 css 在地图容器上缩放转换后移动鼠标位置的问题。

其他更改

  • 已逐步淘汰样式定义版本 2022-08-05，并且已将默认值 styleDefinitionsVersion 切换为 2023-01-01。

  • 添加了 mvc 参数以包含定义和样式请求中的地图控件版本。

安装

此版本在 npm 和 CDN 上可用。

  • NPM：请参阅 azure-maps-control@3.0.0 中的说明

  • CDN：在 HTML 文件的 <head> 元素中引用以下 CSS 和 JavaScript：

    <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（2023 年 7 月 11 日）

Bug 修复

  • 修复了基础 maplibre-gl 依赖项中的动态像素比率。

  • 修复了将 sortKey、radialOffset、variableAnchor 用于 SymbolLayer 选项中时不适用的问题。

安装

此预览版在 npm 和 CDN 中提供。

  • NPM：请参阅 azure-maps-control@3.0.0-preview.10 中的说明

  • CDN：在 HTML 文件的 <head> 元素中引用以下 CSS 和 JavaScript：

    <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（2023 年 6 月 27 日）

新功能

  • 默认情况下使用 WebGL2。

  • 提升 API：atlas.sources.ElevationTileSource、map.enableElevation(elevationSource, options)、map.disableElevation()

  • 能够在 CameraOptions 中自定义 maxPitch /minPitch

Bug 修复

  • 修复了调用 map.setServiceOptions 时可能导致与辅助功能相关的重复 DOM 元素的问题

安装

此预览版在 npm 和 CDN 中提供。

  • NPM：请参阅 azure-maps-control@3.0.0-preview.9 中的说明

  • CDN：在 HTML 文件的 <head> 元素中引用以下 CSS 和 JavaScript：

    <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（2023 年 6 月 2 日）

Bug 修复

  • 修复了更新不再存在的布局属性时发生的异常。

  • 修复了修改数据源时 BubbleLayer 的可访问指示器不更新的问题。

  • 修复了序列化样式时在 stylechanged 事件回调中检索原始 Maplibre 样式情况下后续 map.setStyle() 调用中出现的错误。

其他更改

  • 更新了属性徽标和链接。

安装

此预览版在 npm 和 CDN 中提供。

  • NPM：请参阅 azure-maps-control@3.0.0-preview.8 中的说明

  • CDN：在 HTML 文件的 <head> 元素中引用以下 CSS 和 JavaScript：

    <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（2023 年 5 月 2 日）

新功能

  • 除了映射配置外，Map.setServiceOptions () 现在还支持在运行时更改 domain、styleAPIVersion、styleDefinitionsVersion。

Bug 修复

  • 修复了在使用 Azure AD/共享令牌/匿名身份验证重新启动时令牌已到期的异常，方法是确保在请求样式定义之前解决身份验证

  • 修复了冗余样式定义和缩略图请求

  • 修复了对“缩小”控制按钮元素应用的 aria-label 不正确的问题

  • 修复了 RuleBasedAttribution 设置为 false 时可能未定义版权元素容器的问题

  • 修复了 EventManager.remove() 中可能对未定义目标调用事件侦听器删除的问题

安装

此预览版在 npm 和 CDN 中提供。

  • NPM：请参阅 azure-maps-control@3.0.0-preview.7 中的说明

  • CDN：在 HTML 文件的 <head> 元素中引用以下 CSS 和 JavaScript：

    <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（2023 年 3 月 31 日）

安装

此预览版在 npm 和 CDN 中提供。

  • NPM：请参阅 azure-maps-control@3.0.0-preview.6 中的说明

  • CDN：在 HTML 文件的 <head> 元素中引用以下 CSS 和 JavaScript：

    <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>

新功能

  • 优化了内部样式转换性能。

Bug 修复

  • 解决了第一个样式集请求未经身份验证以进行 AAD 身份验证的问题。

  • 消除了映射初始化期间和样式更改事件中的冗余请求。

3.0.0-preview.5（2023 年 3 月 15 日）

安装

此预览版在 npm 和 CDN 中提供。

  • NPM：请参阅 azure-maps-control@3.0.0-preview.5 中的说明

  • CDN：在 HTML 文件的 <head> 元素中引用以下 CSS 和 JavaScript：

    <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>

新功能

  • 支持通过 map.setServiceOptions({ mapConfiguration: 'MAP_CONFIG' }) 动态更新 mapConfiguration

3.0.0-preview.4（2023 年 3 月 10 日）

安装

此预览版在 npm 和 CDN 中提供。

  • Npm：请参阅 azure-maps-control@3.0.0-preview.4 中的说明

  • CDN：在 HTML 文件的 <head> 元素中引用以下 CSS 和 JavaScript：

    <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>

新功能

  • 扩大了中国、日本和韩国的地图覆盖范围。

  • 刷新地图样式预览（道路/夜间/混合/灰度深色/灰度浅色/地形/高对比度深色/高对比色浅色）。

  • 有关道路/建筑物轮廓/小径覆盖范围的更多详细信息。

  • “地形”样式的缩放级别范围更宽 (1~21)。

  • 有关公共交通的更多详细信息，包括渡轮、地铁和公共汽车站。

  • 有关山脉海拔高度和瀑布位置的其他信息。

更改

  • 流量数据现在仅支持相对模式。

  • 不推荐使用 StyleOptions 中的 showBuildingModels。

  • 将默认 minZoom 从 -2 更改为 1。

Bug 修复

  • 清理了 Map.dispose () 中的各种内存泄漏。

  • 改进了样式选取器的选项卡导航功能，以便支持列表布局中的辅助功能。

  • 通过避免深度克隆对象优化了样式切换。

  • 修复了使用非矢量或非光栅的源进行样式切换时 SourceManager 中发生的异常。

  • [重大]以前，只有在向样式添加新源时，才会发出 sourceadded 事件。 现在，当当前样式中的新源与原始源不相等时，即使它们具有相同的源 ID，也会发出 sourceremoved / sourceadded 事件。

3.0.0-preview.3（2023 年 2 月 2 日）

安装

此预览版在 npm 和 CDN 中提供。

  • Npm：请参阅 azure-maps-control@3.0.0-preview.3 中的说明

  • CDN：在 HTML 文件的 <head> 元素中引用以下 CSS 和 JavaScript：

    <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>

新功能

Bug 修复

  • 修复了语言映射中的问题，现在 zh-Hant-TW 不再还原为 en-US。

  • 修复了无法切换用户区域（视图）的问题。

  • 修复了渐进式层加载过程中样式切换时发生的异常。

  • 修复了地图图块标签层的辅助功能信息检索。

  • 修复了在通过 ImageSpriteManager.add() 添加图像后，矢量图块偶尔无法重新渲染的问题。

3.0.0-preview.2（2022 年 12 月 16日）

安装

此预览版在 npm 和 CDN 中提供。

  • NPM：请参阅 azure-maps-control@3.0.0-preview.2 中的说明

  • CDN：在 HTML 文件的 <head> 元素中引用以下 CSS 和 JavaScript：

    <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>

新功能

将 progressiveLoading 和 progressiveLoadingInitialLayerGroups 添加到 StyleOptions 以启用逐步加载地图层的功能。 此功能可改善感知的地图加载时间。 有关详细信息，请参阅 2.2.2 发行说明。

Bug 修复

  • 修复了调用 map.layers.move() 后用户层顺序未保留的问题。

  • 修复了当使用 new atlas.control.TrafficControl({incidents: false}) 时无法在 TrafficControlOptions 中禁用交通事故的问题。

  • 将 .atlas-map 添加到所有 css 选择器，以确定地图容器中的样式范围。 此修复可防止 css 意外地将不需要的样式添加到页面上的其他元素。

3.0.0-preview.1（2022 年 11 月 18 日）

安装

此预览版在 npm 中提供。

新功能

此更新是即将发布的 3.0.0 版本的第一个预览版。 基础 maplibre-gl 依赖项已从 1.14 升级到 3.0.0-pre.1，改进了稳定性和性能。

Bug 修复

  • 修复了阻止 IndoorManager 删除图块集的一个回归问题：

    indoorManager.setOptions({
    tilesetId: undefined
})

v2

2.3.7 （2024 年 2 月 22 日）

新功能

  • 添加了 fillAntialias 用于在多边形填充上启用 MSAA 抗锯齿的选项 PolygonLayer 。
  • 添加了一个新选项， enableAccessibilityLocationFallback用于启用或禁用辅助功能（屏幕阅读器）的反向地理编码 API 回退。

其他更改

  • 更新反馈图标和链接。

2.3.6 （2024 年 1 月 12 日）

新功能

  • 添加了一个新控件， atlas.control.ScaleControl用于在地图上显示缩放条。

  • 引入了用于访问、更新和删除功能状态的函数。

Bug 修复

  • 解决了样式更新后层排序的问题，即在其他用户层之前插入用户层时。

2.3.5 （2023 年 11 月 29 日）

其他更改

  • 屏幕阅读器的辅助功能已升级，以利用搜索 V2 API（反向地理编码）。

2.3.4（2023 年 11 月 1 日）

其他更改

  • 删除了样式、缩略图、子画面和字形请求中的授权标头，以增强静态资产的 CDN 缓存。

  • 更新了 map.clear() 和 layers.clear() 的文档。

2.3.3（2023 年 10 月 6 日）

Bug 修复

  • 已解决启用渐进式加载时动态归因的问题。

2.3.2（2023 年 8 月 11 日）

Bug 修复

  • 修复了调用 map.setServiceOptions 时可能导致与辅助功能相关的重复 DOM 元素的问题。

  • 修复了要考虑 CameraOptions 的maxBounds缩放控件。

其他更改

  • 添加了 mvc 参数以包含定义和样式请求中的地图控件版本。

2.3.1（2023 年 6 月 27 日）

Bug 修复

  • 在样式更改期间修复 ImageSpriteManager 图标图像可能会将其移除

其他更改

  • 安全性：UUID 生成中的不安全随机性修复。

2.3.0（2023 年 6 月 2 日）

新功能

  • [中断性变更] 重构了内部 StyleManager 以将 _stylePatch 替换为 transformStyle。 进行此变更后，道路防护图标在样式切换后可以正确更新和呈现。

Bug 修复

  • 修复了更新不再存在的布局属性时发生的异常。

  • 修复了修改数据源时 BubbleLayer 的可访问指示器不更新的问题。

其他更改

  • 更新了属性徽标和链接。

2.2.7（2023 年 5 月 2 日）

新功能

  • 除了映射配置外，Map.setServiceOptions () 现在还支持在运行时更改 domain、styleAPIVersion、styleDefinitionsVersion。

Bug 修复

  • 修复了在使用 Azure AD/共享令牌/匿名身份验证重新启动时令牌已到期的异常，方法是确保在请求样式定义之前解决身份验证

  • 修复了冗余样式定义和缩略图请求

  • 修复了对“缩小”控制按钮元素应用的 aria-label 不正确的问题

  • 修复了 RuleBasedAttribution 设置为 false 时可能未定义版权元素容器的问题

  • 修复了 EventManager.remove() 中对未定义目标调用事件侦听器删除的问题

2.2.6

Bug 修复

  • 解决了第一个样式集请求未经身份验证以进行 AAD 身份验证的问题。

  • 消除了映射初始化期间和样式更改事件中的冗余请求。

2.2.5

新功能

  • 支持通过 map.setServiceOptions({ mapConfiguration: 'MAP_CONFIG' }) 动态更新 mapConfiguration

2.2.4

Bug 修复

  • 清理了 Map.dispose () 中的各种内存泄漏。

  • 改进了样式选取器的选项卡导航功能，以便支持列表布局中的辅助功能。

2.2.3

新功能

Bug 修复

  • 修复了语言映射中的问题，现在 zh-Hant-TW 不再还原为 en-US。

  • 修复了无法切换用户区域（视图）的问题。

  • 修复了渐进式层加载过程中样式切换时发生的异常。

  • 修复了地图图块标签层的辅助功能信息检索。

  • 修复了在通过 ImageSpriteManager.add() 添加图像后，矢量图块偶尔无法重新渲染的问题。

2.2.2（2020 年 12 月 15 日）

新功能

将 progressiveLoading 和 progressiveLoadingInitialLayerGroups 添加到 StyleOptions 以启用逐步加载地图层的功能。 此功能可改善感知的地图加载时间。

  • progressiveLoading
    • 启用地图层的逐步加载。
    • 默认为 false。
  • progressiveLoadingInitialLayerGroups
    • 指定要首先加载的图层组。
    • 默认为 ["base"]。
    • 可能的值为 base、transit、labels、buildings 和 labels_places。
    • 其他图层组将被推迟，以便可以首先加载初始的图层组。

Bug 修复

  • 修复了调用 map.layers.move() 后用户层顺序未保留的问题。

  • 修复了当使用 new atlas.control.TrafficControl({incidents: false}) 时无法在 TrafficControlOptions 中禁用交通事故的问题。

后续步骤

探索展示了 Azure Maps 的示例：

Azure Maps 示例

随时掌握 Azure Maps 的最新信息：

Azure Maps 博客