@esri/maplibre-arcgis

中文文档
1.3.3发布于 2026/11/02Apache-2.0TypeScriptESM + CJS近 30 天下载 2.5万

将ArcGIS数据源与MapLibre GL JS整合的包装器

中文使用文档
文档目录11 节
  1. 目录
  2. 快开始
  3. 特征
  4. 教学和API 参考
  5. 问题
  6. 依赖关系
  7. 捐款
  8. 发展指示
  9. 版本
  10. 信贷
  11. 许可证发放

NPM Version apache 2.0 licensed

@esri/ maplibre-arcgis (中文(简体) )

一个MapLibre GL JS插件,用于集成ArcGIS服务,包括basemaps,矢量平板和特征层.

这个项目由埃斯里的居民维持,但是我们不保证个人特征,也不提供传统产品生命周期来支持规划.

Trails and parks styled with MapLibre ArcGIS.

目录

快开始

MapLibre ArcGIS通过CDN和国家预防机制提供。 导入后,库可以用于显示底图样式并添加地层.

  import maplibregl from 'maplibre-gl';
  import maplibreArcGIS from '@esri/maplibre-arcgis';

  // Initialize MapLibre GL JS map
  const map = new maplibregl.Map({
    container: "map",
    zoom: 5,
    center: [138.2529, 36.2048],
  });

  // Apply an ArcGIS basemap style to the map
  const basemapStyle = maplibreArcGIS.BasemapStyle.applyStyle(map, {
    style: 'arcgis/navigation',
    token: apiKey
  });

  // Listen for the map 'load' event.
  map.on('load', async () => {
    // Add a vector tile layer using an ArcGIS Item ID.
    const vectorLayer = await maplibreArcGIS.VectorTileLayer.fromPortalItem('b8f6941ceb874d72a7c37418c3e8108d');
    vectorLayer.addSourcesAndLayersTo(map);
  });

例如,请到开发者指南: Maplibre ArcGIS 快速启动。 。 。 .

特征

MapLibre ArcGIS在一个 MapLibre GL JS 应用程序中为获取ArcGIS资源提供地层和公用设施. 除了ArcGIS提供的种类繁多的基础映射风格之外,这个软件包还允许您使用MapLibre GL JS访问并显示自己的主机数据. 支助了下列资源:

教学和API 参考

教学、样本和API参考文献可见于 开发者.com/maplibre-gl-js。 。 。 .

问题

找到窃听器了吗? 想要个新角色吗? 通过提交 问题。 。 。 .

如欲获得更多帮助,您可在 Official website 埃斯里社区 或联系人 Esri 技术支持。 。 。 .

依赖关系


捐款

Esri欢迎所有人的贡献。 请看我们的 提交文件的准则。 。 。 .

发展指示

开始在当地开发:

  1. 叉子和复制此还原。 。 。 .
  2. cd 输入 maplibre-arcgis 文件夹.
  3. 安装构建依赖性 npm install。 。 。 .
  4. 使用 npm run build:dev 用于建立本地文件以促进发展。 输出保存到 /dist 文件夹.
  5. 或者,使用 npm run start:dev 启动开发服务器。 当对源代码进行修改时,文件会自动重建.
  6. 按需要修改图书馆并使用 npm run test 以验证.

如果你愿意为这个寄存器做贡献, 创建一个 拉动请求 包含你的工作.

版本

为了在发行周期中保持透明度并努力保持后向相容性,Esri MapLibre在语义版准则下得到了维护并尽可能地遵守这些规则.

关于SemVer的更多信息,请访问 http://semver.org/ (中文(简体) )。 。 。 .

信贷

这个项目受到若干现有工作的启发,其中包括:

概念和编程模式被用于启发,但所有代码都是独创的.

许可证发放

版权:2025 Esri

根据 Apache 许可证, 版本 2. 0 (“ License ”) 获得许可; 您不能使用此文件, 除非符合许可证 。 您可在下列地点获得许可证副本:

http://www.apache.org/licenses/LICENSE-2.0 (中文(简体) )

除非适用的法律要求或书面同意,根据许可证分发的软件在 " AS IS " BASIS上分发,没有任何明示或默示的WARANTIES或CONDITION。 见《许可证》关于许可和许可证限制的具体语言.

许可证副本可到存放处索取 自由主义 文档.

版本与发布记录

@esri/maplibre-arcgis 共发布 14 个版本,首次发布于 2025/09/10;过去 12 个月发布了 7 个版本。

版本发布日期距今
1.3.3latest2026/11/0211 天前
1.3.22026/10/3014 天前
1.3.12026/08/113 个月前
1.3.02026/06/025 个月前
1.2.02026/03/108 个月前
1.1.02025/12/2710 个月前

其他发布通道:beta → 1.0.0-beta.3。

关于 @esri/maplibre-arcgis 的常见问题

@esri/maplibre-arcgis 是什么?

将ArcGIS数据源与MapLibre GL JS整合的包装器

如何安装 @esri/maplibre-arcgis?

在项目目录运行 npm install @esri/maplibre-arcgis,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:maplibre-gl(^5.24.0 || ^6.3.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@esri/maplibre-arcgis 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@esri/maplibre-arcgis 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@esri/maplibre-arcgis 可以商用吗?

@esri/maplibre-arcgis 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@esri/maplibre-arcgis 的下载量有多少?

根据 npm 官方下载统计,@esri/maplibre-arcgis 在 2026/10/14 – 2026/11/12 这 30 天内被下载 24,924 次,日均约 831 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@esri/maplibre-arcgis 还在维护吗?

最新版本 1.3.3 发布于 2026/11/02(11 天前);至今共发布 14 个版本,其中过去 12 个月发布了 7 个;首次发布于 2025/09/10。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。