Mapbox迁移指南

本文档专门用于指导从 mapbox-gl 迁移到 maplibre-gl；

根据当前使用的 mapbox-gl 版本不同，本指南的准确性可能有所差异，但总体迁移过程应该相对简单；

这两个库非常相似，但从v2版本开始，随着Mapbox转为专有许可，两者开始在新功能上出现更多差异；

整体迁移过程是通过在Node包中卸载 mapbox-gl 并安装 maplibre-gl（或参见下方CDN链接），然后在您的TypeScript、JavaScript和HTML/CSS中将 mapboxgl 替换为 maplibregl；

-    var map = new mapboxgl.Map({
+    var map = new maplibregl.Map({

-    <button class="mapboxgl-ctrl">
+    <button class="maplibregl-ctrl">

兼容性分支

MapLibre GL JS v1与Mapbox GL JS v1完全向后兼容；这个兼容性分支（命名为1.x）在npm上标记为v1，其当前版本是1.15.3；

CDN链接

MapLibre GL JS通过unpkg.com分发；

-    <script src="https://api.mapbox.com/mapbox-gl-js/v#.#.#/mapbox-gl.js"></script>
-    <link
-      href="https://api.mapbox.com/mapbox-gl-js/v#.#.#/mapbox-gl.css"
-      rel="stylesheet"
-    />


+    <script src="https://unpkg.com/maplibre-gl@#.#.#/dist/maplibre-gl.js"></script>
+    <link
+      href="https://unpkg.com/maplibre-gl@#.#.#/dist/maplibre-gl.css"
+      rel="stylesheet"
+    />

请记得将上面的版本号 #.#.# 替换为您想使用的版本；您可以在本页右上角找到最新版本的版本号；