共用方式為

Web SDK 地圖控件版本資訊

  • 發行項

本檔包含地圖控件新功能和其他變更的相關信息。

v3 （最新版）

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

新功能

  • 新增全螢幕控制件的支援。

錯誤修正

  • 公開上的 PolygonExtrusionLayerOptions.fillPattern 新型態以支援 DataDrivenPropertyValueSpecification<string>。

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

新功能

  • 新增 PMTiles 的支援。

錯誤修正

  • 輔助功能：修正小型容器中樣式選擇器標籤的溢位問題。
  • 修正使用 GeoJSON 數據源變更樣式之後未更新的屬性。
  • 使用界限和最小/最大縮放來修正 setCamera 。
  • 使用 ResizeObserver 而非視窗重設大小事件。
  • 修正頁尾標誌寬度。

其他變更

  • 新增 @types/geojson 為相依性。
  • 將相依性 @microsoft/applicationinsights-web 更新為 ^3.3.0

3.3.0 （2024 年 8 月 8 日）

新功能

  • 更新著作權控件
    • 使版權文本更小，並確保它適合一行。
    • 針對不同的 CSS 主題使用不同類型的Microsoft標誌，以改善可見度。
    • 實作 RWD 以隱藏地圖畫布相對較小的元件部分（MS 標誌）。
  • 藉由新增抽象和setOptions函式getOptions來增強基底層類別。

錯誤修正

  • 複製用戶圖層時略過現有的來源。
  • [中斷] 解決中的 Position.fromLatLng()緯度和經度值順序不正確。
  • 修正控件按鈕上隱藏的可存取項目可見問題。

3.2.1 （2024 年 5 月 13 日）

新功能

  • 當設定為 false時renderWorldCopies限制水平移動流覽。
  • 當目標點接近限制時，讓 easeTo 和 flyTo 動畫更順暢：maxBounds、垂直世界邊緣或 antimeridian。

錯誤修正

  • 使用 'Show numbers' 命令時，更正隱藏控件的可存取數位。
  • 修正移除地圖時背景工作角色中的記憶體流失。
  • 修正移動瀏覽動作結尾不必要的縮放和移動瀏覽變更。

其他變更

  • 改善檔案中的內嵌程式代碼格式。

3.2.0 （2024 年 3 月 29 日）

其他變更

  • 將 MapLibre 升級至 V4。

  • 更正檔案中的預設值 HtmlMarkerOptions.pixelOffset from [0, -18] 到 [0, 0] 。

3.1.2 （2024 年 2 月 22 日）

新功能

  • 已將 fillAntialias 選項新增至 ， PolygonLayer 以在多邊形填滿上啟用 MSAA 反鋸齒功能。

其他變更

  • 更新意見反應圖示和連結。

3.1.1 （2024 年 1 月 26 日）

新功能

  • 已新增選項 enableAccessibilityLocationFallback，以啟用或停用輔助功能 （螢幕助讀程式） 的反向地理編碼 API 後援。

錯誤修正

  • 已解決 ApplicationInsights v3.0.5 可能傳送大量要求的問題。

3.1.0 （2024 年 1 月 12 日）

新功能

  • 已新增控制件 atlas.control.ScaleControl，以在地圖上顯示尺規列。

  • 引進了存取、更新和刪除功能狀態的函式。

錯誤修正

  • 解決樣式更新之後圖層排序的問題，在用戶層插入另一個用戶層之前。

  • [中斷] 對齊多邊形填滿圖樣行為與 Maplibre。 現在，選項 fillPattern 會一致地停用 fillColor 選項。 設定 fillColor 多邊形圖層時，請確定 fillPattern 設定為 undefined。

3.0.3 （2023 年 11 月 29 日）

新功能

  • 包含ESM支援。

其他變更

  • 螢幕助讀程式的輔助功能功能已升級為使用搜尋 V2 API（反向地理編碼）。

  • 指南針和投向控件中的增強輔助功能。

3.0.2 （2023 年 11 月 1 日）

錯誤修正

  • 解決了類型宣告檔案中的數個錯誤，並新增了的 @maplibre/maplibre-gl-style-spec相依性。

其他變更

  • 已從樣式、縮圖、Sprite 和圖像要求中移除授權標頭，以增強靜態資產的CDN快取。

  • 已更新和layers.clear()的檔map.clear()。

3.0.1 （2023 年 10 月 6 日）

錯誤修正

  • 各種輔助功能改善。

  • 解決啟用漸進式載入時動態屬性的問題。

  • 已修正中的 HtmlMarkerEvents遺漏事件名稱。

其他變更

  • 要針對縮放、音調和指南針控件保護的已修改成員方法。

  • Azure Government 雲端中預設會停用遙測。

3.0.0 （2023 年 8 月 18 日）

錯誤修正

  • 已修正縮放控件以納入 maxBounds CameraOptions。

  • 已修正在地圖容器上的 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 日）

錯誤修正

  • 基礎 maplibre-gl 相依性中固定的動態圖元比率。

  • 已修正在選項中使用 SymbolLayer 時，不會套用、 variableAnchor radialOffset的問題sortKey。

安裝

預覽可在 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()

  • 在 中自定義 maxPitch / minPitch 的能力 CameraOptions

錯誤修正

  • 已修正呼叫 輔助功能相關的重複 DOM 元素可能會導致 map.setServiceOptions 的問題

安裝

預覽可在 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 日）

錯誤修正

  • 已修正更新已不存在之版面配置屬性時所發生的例外狀況。

  • 已修正當數據源修改時，BubbleLayer 的可存取指標未更新的問題。

  • 已修正在樣式串行化事件回呼中擷取原始 Maplibre 樣式時stylechanged，後續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、 styleAPIVersionstyleDefinitionsVersion 。

錯誤修正

  • 已修正在使用 Azure AD/共用令牌/匿名驗證時重新啟動的令牌過期例外狀況，方法是確定驗證已在任何樣式定義要求之前解決

  • 已修正備援樣式定義和縮圖要求

  • 已修正套用至縮小控件按鈕元素的不正確aria-label

  • 已修正當withRuleBasedAttribution設為 false 時未定義的 copyright 元素容器的可能性

  • 已修正在 中未定義的目標上呼叫的事件接聽程式移除的可能性 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>

新功能

  • 優化內部樣式轉換效能。

錯誤修正

  • 已解決未驗證第一個樣式集要求以進行 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>

新功能

  • 支援透過 動態更新 mapConfiguration map.setServiceOptions({ mapConfiguration: 'MAP_CONFIG' })

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>

新功能

  • 中國、日本和韓國的地圖涵蓋範圍延伸。

  • 重新整理的地圖樣式預覽（路/夜/混合式/灰階深/灰階淺/Terra/高對比度深色/高對比度光線）。

  • 有關道路/建築足跡/小徑涵蓋範圍的詳細數據。

  • Terra 樣式的較寬縮放層級範圍 （1~21）。

  • 更詳細的公共交通，包括渡輪、地鐵和公共汽車站。

  • 關於山脈高度和瀑布位置的其他資訊。

變更

  • 流量數據現在僅支持相對模式。

  • StyleOptions 中已被showBuildingModels取代。

  • 將預設值 minZoom 從 -2 變更為 1。

錯誤修正

  • 清除 Map.dispose（）中各種記憶體流失。

  • 已改善清單配置中輔助功能的樣式選擇器索引標籤導覽。

  • 藉由避免深層複製對象來優化樣式切換。

  • 已修正當樣式切換不是向量或點陣的來源時，SourceManager 中發生的例外狀況。

  • [中斷]sourceadded先前的事件只會在新的來源新增至樣式時發出。 現在 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>

新功能

錯誤修正

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>

新功能

將 和 progressiveLoadingInitialLayerGroups 新增progressiveLoading至 StyleOptions，以啟用漸進式載入地圖層次的功能。 這項功能可改善地圖的感知載入時間。 如需詳細資訊，請參閱 2.2.2 版本資訊。

錯誤修正

  • 已修正在呼叫 map.layers.move()之後，不會保留用戶層順序的問題。

  • 已修正在使用 TrafficControlOptions 時new atlas.control.TrafficControl({incidents: false})無法停用流量事件。

  • 新增 .atlas-map 至所有 css 選取器，以限定地圖容器內的樣式範圍。 修正可防止 css 不小心將不必要的樣式新增至頁面上的其他元素。

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

安裝

預覽可在 npm 上取得。

  • 將 azure-maps-control@next安裝至您的相依性：

    npm i azure-maps-control@next

新功能

此更新是即將推出的 3.0.0 版的第一個預覽版本。 基礎 Maplibre-gl 相依性已從 1.14 升級為 3.0.0-pre.1，提供穩定性和效能的改善。

錯誤修正

  • 已修正導致 IndoorManager 無法移除磚集的回歸問題：

    indoorManager.setOptions({
    tilesetId: undefined
})

v2

2.3.7 （2024 年 2 月 22 日）

新功能

  • 已將 fillAntialias 選項新增至 ， PolygonLayer 以在多邊形填滿上啟用 MSAA 反鋸齒功能。
  • 已新增選項 enableAccessibilityLocationFallback，以啟用或停用輔助功能 （螢幕助讀程式） 的反向地理編碼 API 後援。

其他變更

  • 更新意見反應圖示和連結。

2.3.6 （2024 年 1 月 12 日）

新功能

  • 已新增控制件 atlas.control.ScaleControl，以在地圖上顯示尺規列。

  • 引進了存取、更新和刪除功能狀態的函式。

錯誤修正

  • 解決樣式更新之後圖層排序的問題，在用戶層插入另一個用戶層之前。

2.3.5 （2023 年 11 月 29 日）

其他變更

  • 螢幕助讀程式的輔助功能功能已升級為使用搜尋 V2 API（反向地理編碼）。

2.3.4 （2023 年 11 月 1 日）

其他變更

  • 已從樣式、縮圖、Sprite 和圖像要求中移除授權標頭，以增強靜態資產的CDN快取。

  • 已更新和layers.clear()的檔map.clear()。

2.3.3 （2023 年 10 月 6 日）

錯誤修正

  • 解決啟用漸進式載入時動態屬性的問題。

2.3.2 （2023 年 8 月 11 日）

錯誤修正

  • 已修正呼叫 輔助功能相關的重複 DOM 元素可能會導致 map.setServiceOptions 的問題。

  • 已修正縮放控件以納入 maxBounds CameraOptions。

其他變更

  • mvc已新增 參數，以同時包含定義和樣式要求中的對應控件版本。

2.3.1 （2023 年 6 月 27 日）

錯誤修正

  • 修正 ImageSpriteManager 在樣式變更期間可能會移除圖示影像

其他變更

  • 安全性：UUID 產生中的不安全隨機性修正。

2.3.0 （2023 年 6 月 2 日）

新功能

  • [中斷] 重構內部 StyleManager，以 取代 _stylePatch 為 transformStyle。 這項變更可讓道路防護圖示在樣式切換之後正確更新和轉譯。

錯誤修正

  • 已修正更新已不存在之版面配置屬性時所發生的例外狀況。

  • 已修正當數據源修改時，BubbleLayer 的可存取指標未更新的問題。

其他變更

  • 已更新屬性標誌和連結。

2.2.7 （2023 年 5 月 2 日）

新功能

  • 除了對應組態之外，Map.setServiceOptions（） 現在還支援在運行時間變更 domain、 styleAPIVersionstyleDefinitionsVersion 。

錯誤修正

  • 已修正在使用 Azure AD/共用令牌/匿名驗證時重新啟動的令牌過期例外狀況，方法是確定驗證已在任何樣式定義要求之前解決

  • 已修正備援樣式定義和縮圖要求

  • 已修正套用至縮小控件按鈕元素的不正確aria-label

  • 已修正當withRuleBasedAttribution設為 false 時未定義的 copyright 元素容器的可能性

  • 已修正 EventManager.remove 中未定義目標上呼叫的事件接聽程式移除的可能性。

2.2.6

錯誤修正

  • 已解決未驗證第一個樣式集要求以進行 AAD 驗證的問題。

  • 在對應初始化期間和樣式變更事件時，已排除備援要求。

2.2.5

新功能

  • 支援透過 動態更新 mapConfiguration map.setServiceOptions({ mapConfiguration: 'MAP_CONFIG' })

2.2.4

錯誤修正

  • 清除 Map.dispose（）中各種記憶體流失。

  • 已改善清單配置中輔助功能的樣式選擇器索引標籤導覽。

2.2.3

新功能

  • 允許在 Map.setCamera（options） 中使用 CameraBoundsOptions 設定音調和軸承。

錯誤修正

2.2.2 （2022 年 12 月 15 日）

新功能

將 和 progressiveLoadingInitialLayerGroups 新增progressiveLoading至 StyleOptions，以啟用漸進式載入地圖層次的功能。 這項功能可改善地圖的感知載入時間。

  • progressiveLoading
    • 啟用地圖層次的漸進式載入。
    • 預設為 false。
  • progressiveLoadingInitialLayerGroups
    • 指定要先載入的圖層群組。
    • 預設為 ["base"]。
    • 可能的值為 base、、transitlabels、 buildings和 labels_places。
    • 其他圖層群組會延遲，以便先載入初始圖層群組。

錯誤修正

  • 已修正在呼叫 map.layers.move()之後，不會保留用戶層順序的問題。

  • 已修正在使用 TrafficControlOptions 時new atlas.control.TrafficControl({incidents: false})無法停用流量事件。

下一步

探索展示 Azure 地圖服務 範例：

Azure 地圖服務範例

掌握 Azure 地圖服務的最新動態：

Azure 地圖服務部落格