# @geoman-io/maplibre-geoman-free 中文文档

规范地址：https://npmcn.com/package/%40geoman-io/maplibre-geoman-free/

版本：0\.10\.8
npm 元数据更新时间：2026-11-06T16:25:25.894Z
中文译文更新时间：2026-11-16T04:29:32.604Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：4 MB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：34 个
- peer 依赖：maplibre-gl \>=6\.0\.0 \<7\.0\.0
- 首次发布：2024-09-17T21:32:35.167Z
- 最新版本发布：2026-11-06T16:25:25.546Z
- 近 30 天下载量：69496（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：64（近 12 个月 26 个）

## 中文简介

绘图和编辑几何图层的 MapLibre 插件

## 安装

```sh
npm install @geoman-io/maplibre-geoman-free
```

也可以使用：`pnpm add @geoman-io/maplibre-geoman-free`、`yarn add @geoman-io/maplibre-geoman-free`、`bun add @geoman-io/maplibre-geoman-free`

## README

[![Geoman Logo](https://geoman-static.onrender.com/assets/logo_white_bg.svg)](https://geoman.io/)

# 马普利布雷-吉奥曼

**用于创建和编辑几何图层的 MapLibre 插件**  
绘制、编辑、拖放、剪切、旋转、分块、缩放、度量、收缩和平面图层  
支持标记、 CircleMarkers 、 多线、 多边形、 圆形、 矩形、 图像覆盖、 层组、 GeoJSON、 多线串和多波利根

 [![npm version](https://badge.fury.io/js/%40geoman-io%2Fmaplibre-geoman-free.svg)](https://badge.fury.io/js/%40geoman-io%2Fmaplibre-geoman-free)[![NPM Downloads](https://img.shields.io/npm/dt/@geoman-io/maplibre-geoman-free.svg)](https://www.npmjs.com/package/@geoman-io/maplibre-geoman-free)

![Demo](https://github.com/geoman-io/maplibre-geoman/raw/master/geoman-maplibre-demo.png)

## 安装

```shell
npm install @geoman-io/maplibre-geoman-free
```

## 所需资源

此软件包需要 **MapLibre GL 联合来文6** (单位:千美元)`maplibre-gl >=6.0.0 <7.0.0`并且现在 **仅限无害环境管理**, (中文(简体) ), 跟着MapLibre v6本身。 没有UMD建筑,没有 `require` 进入点.

MapLibre v6 一旦库被捆绑,它不再解决自己的网络工人,所以 **您的应用程序必须 在创建地图前将其指向一个** - 这是MapLibre的要求,不是Geoman的要求,而是 运行时未创建地图失败 。 您如何获得 URL 取决于您的捆绑器; 见 [MapLibre 捆绑指南](https://maplibre.org/maplibre-gl-js/docs/guides/bundlers/)。 。 。 .

```typescript
// Vite
import workerUrl from 'maplibre-gl/dist/maplibre-gl-worker.mjs?worker&url';
ml.setWorkerUrl(workerUrl);

// Webpack 5 / Rspack (or any bundler supporting `new URL(..., import.meta.url)`)
ml.setWorkerUrl(new URL('maplibre-gl/dist/maplibre-gl-worker.mjs', import.meta.url).href);

// No bundler — serve the file yourself and pass its path
ml.setWorkerUrl('/vendor/maplibre-gl-worker.mjs');
```

## 使用量

```typescript
import * as ml from 'maplibre-gl';
import workerUrl from 'maplibre-gl/dist/maplibre-gl-worker.mjs?worker&url';
import { Geoman, type GmOptionsPartial } from '@geoman-io/maplibre-geoman-free';

import 'maplibre-gl/dist/maplibre-gl.css';
import '@geoman-io/maplibre-geoman-free/dist/maplibre-geoman.css';

// See "Requirements" above — must run before the first `new ml.Map()`.
ml.setWorkerUrl(workerUrl);

const map = new ml.Map({
  container: 'dev-map',
  style: {
    version: 8,
    glyphs: 'https://fonts.openmaptiles.org/{fontstack}/{range}.pbf',
    sources: {
      'osm-tiles': {
        type: 'raster',
        tiles: ['https://tile.openstreetmap.org/{z}/{x}/{y}.png'],
        tileSize: 256,
        attribution: '© OpenStreetMap contributors',
      },
    },
    layers: [
      {
        id: 'osm-tiles-layer',
        type: 'raster',
        source: 'osm-tiles',
        minzoom: 0,
        maxzoom: 19,
      },
    ],
  },
  center: [0, 51],
  zoom: 5,
});

const geoman = new Geoman(map);

map.on('gm:loaded', () => {
  console.log('Geoman fully loaded');
});
```

## 文档

访问 [地理人.io/docs/地图](https://www.geoman.io/docs/maplibre) 要开始.

## 演示

请检查access-date=中的日期值 (帮助) Maplibre-Geoman Pro 上的全能 [地质学家.io/demo/地图](https://geoman.io/demo/maplibre)

## 链接

-   [GitHub 仓库](https://github.com/geoman-io/maplibre-geoman)
-   [报告问题](https://github.com/geoman-io/maplibre-geoman/issues)
-   [支持版本定价](https://geoman.io/pricing)

## 许可证

麻省理工学院

## 常见问题

### @geoman-io/maplibre-geoman-free 是什么？

绘图和编辑几何图层的 MapLibre 插件

### 如何安装 @geoman-io/maplibre-geoman-free？

在项目目录运行 npm install @geoman-io/maplibre-geoman-free，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：maplibre-gl（\>=6\.0\.0 \<7\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @geoman-io/maplibre-geoman-free 支持 TypeScript 吗？

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

### @geoman-io/maplibre-geoman-free 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @geoman-io/maplibre-geoman-free 可以商用吗？

@geoman-io/maplibre-geoman-free 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @geoman-io/maplibre-geoman-free 的下载量有多少？

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

### @geoman-io/maplibre-geoman-free 还在维护吗？

最新版本 0\.10\.8 发布于 2026/11/07（9 天前）；至今共发布 64 个版本，其中过去 12 个月发布了 26 个；首次发布于 2024/09/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

