# @esri/maplibre-arcgis 中文文档

规范地址：https://npmcn.com/package/%40esri/maplibre-arcgis/

版本：1\.3\.3
npm 元数据更新时间：2026-11-02T06:21:07.366Z
中文译文更新时间：2026-11-13T22:46:23.317Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40esri/maplibre-arcgis
原文对照：https://npmcn.com/package/%40esri/maplibre-arcgis/?lang=original
项目主页：https://github.com/Esri/maplibre-arcgis#readme
源码仓库：https://github.com/Esri/maplibre-arcgis

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：11.6 MB，102 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：6 个
- peer 依赖：maplibre-gl ^5\.24\.0 \|\| ^6\.3\.0
- 首次发布：2025-09-10T15:10:27.556Z
- 最新版本发布：2026-11-02T06:21:07.131Z
- 近 30 天下载量：24924（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：14（近 12 个月 7 个）

## 中文简介

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

## 安装

```sh
npm install @esri/maplibre-arcgis
```

也可以使用：`pnpm add @esri/maplibre-arcgis`、`yarn add @esri/maplibre-arcgis`、`bun add @esri/maplibre-arcgis`

## README

![NPM Version](https://img.shields.io/npm/v/%40esri%2Fmaplibre-arcgis?style=flat-square&color=blue) [![apache 2.0 licensed](https://img.shields.io/badge/license-Apache%202.0-orange.svg?style=flat-square)](https://npmcn.com/package/%40esri/maplibre-arcgis/#readme-licensing)

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

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

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

![Trails and parks styled with MapLibre ArcGIS.](https://npmcn.com/package/%40esri/maplibre-arcgis/examples/trails-parks-styled.png)

## 目录

-   [@esri/ maplibre-arcgis (中文(简体) )](https://npmcn.com/package/%40esri/maplibre-arcgis/#readme-esrimaplibre-arcgis)
    -   [快开始](https://npmcn.com/package/%40esri/maplibre-arcgis/#readme-quick-start)
    -   [特征](https://npmcn.com/package/%40esri/maplibre-arcgis/#readme-features)
    -   [教学和API 参考](https://npmcn.com/package/%40esri/maplibre-arcgis/#readme-tutorials-and-api-reference)
    -   [问题](https://npmcn.com/package/%40esri/maplibre-arcgis/#readme-issues)
    -   [依赖关系](https://npmcn.com/package/%40esri/maplibre-arcgis/#readme-dependencies)

## 快开始

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

```js
  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 快速启动](https://developers.arcgis.com/maplibre-gl-js/get-started/)。 。 。 .

## 特征

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

-   Basemap 样式 ([`BasemapStyle`](https://npmcn.com/)(中文(简体) )
-   GeoJSON 的地物层和地物服务[`FeatureLayer`](https://npmcn.com/)(中文(简体) )
-   矢量平面层([`VectorTileLayer`](https://npmcn.com/)(中文(简体) )
-   ArcGIS 基础映射样式的会话符号认证( E)[`BasemapSession`](https://npmcn.com/)(中文(简体) )

## 教学和API 参考

教学、样本和API参考文献可见于 [开发者.com/maplibre-gl-js](https://developers.arcgis.com/maplibre-gl-js/)。 。 。 .

## 问题

找到窃听器了吗? 想要个新角色吗? 通过提交 [问题](https://github.com/Esri/maplibre-arcgis/issues)。 。 。 .

如欲获得更多帮助,您可在 Official website [埃斯里社区](https://community.esri.com/t5/open-source-mapping-libraries/ct-p/open-source-mapping-libraries) 或联系人 [Esri 技术支持](https://support.esri.com/en-us/contact)。 。 。 .

## 依赖关系

-   [映射- gl- js](https://github.com/maplibre/maplibre-gl-js/) 是一个必要的同伴依赖.
-   内部使用ArcGIS REST JS:
    -   [阿尔克吉斯-后卫请求](https://github.com/Esri/arcgis-rest-js/tree/main/packages/arcgis-rest-request)
    -   [rcgis-resst-fetature-service (英语)](https://github.com/Esri/arcgis-rest-js/tree/main/packages/arcgis-rest-feature-service)
    -   [阿尔基斯-后端门户](https://github.com/Esri/arcgis-rest-js/tree/main/packages/arcgis-rest-portal)
    -   [弧形-后基图-会话](https://github.com/Esri/arcgis-rest-js/tree/main/packages/arcgis-rest-basemap-sessions)

* * *

## 捐款

Esri欢迎所有人的贡献。 请看我们的 [提交文件的准则](https://npmcn.com/CONTRIBUTING.md)。 。 。 .

### 发展指示

开始在当地开发:

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

如果你愿意为这个寄存器做贡献, 创建一个 [拉动请求](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) 包含你的工作.

### 版本

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

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

## 信贷

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

-   这个 [ArcGIS x MapLibre GL JS 开发者指南](https://developers.arcgis.com/maplibre-gl-js/)
-   这个 [地图盒- gl- esri 源码](https://github.com/frontiersi/mapbox-gl-esri-sources) 财务报告和审定财务报表 [地图盒- gl- arcgis- features 服务器](https://github.com/rowanwins/mapbox-gl-arcgis-featureserver) 插件
-   这个 [JavaScript 的 ArcGIS 地图 SDK](https://developers.arcgis.com/javascript/latest/)

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

## 许可证发放

版权:2025 Esri

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

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

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

许可证副本可到存放处索取 [自由主义](https://npmcn.com/LICENSE) 文档.

## 常见问题

### @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 和提交记录判断。