# @advisr/v-mapbox 中文文档

规范地址：https://npmcn.com/package/%40advisr/v-mapbox/

版本：5\.1\.3
npm 元数据更新时间：2025-07-17T15:37:38.017Z
中文译文更新时间：2026-11-06T20:03:19.110Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：250 kB，47 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：0 个
- peer 依赖：maplibre-gl ^4\.0\.0，vue ^3\.4\.15
- 首次发布：2022-11-15T21:05:53.845Z
- 最新版本发布：2025-07-17T15:37:37.845Z
- 近 30 天下载量：2405（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 0 个）

## 中文简介

Maplibre (和 Mapbox) 有 Vue QQ

## 安装

```sh
npm install @advisr/v-mapbox
```

也可以使用：`pnpm add @advisr/v-mapbox`、`yarn add @advisr/v-mapbox`、`bun add @advisr/v-mapbox`

## README

# V-Mapbox QQ 地图框

 [![npm](https://img.shields.io/npm/v/v-mapbox?label=npm%40latest&logo=npm)](https://www.npmjs.com/package/v-mapbox "npm")[![GitHub release (latest by date including pre-releases)](https://img.shields.io/github/v/release/vinayakkulkarni/v-mapbox?include_prereleases&logo=github) ](https://github.com/vinayakkulkarni/v-mapbox/releases "GitHub Release")[![Total alerts](https://github.com/vinayakkulkarni/v-mapbox/workflows/ci/badge.svg) ](https://github.com/vinayakkulkarni/v-mapbox/actions?query=workflow%3Aci "CI Status")[![DeepScan grade](https://deepscan.io/api/teams/9381/projects/14423/branches/267899/badge/grade.svg) ](https://deepscan.io/dashboard#view=project&tid=9381&pid=14423&bid=267899 "DeepScan Grade")[![npm](https://img.shields.io/npm/dm/v-mapbox) ](http://npm-stat.com/charts.html?package=v-mapbox "downloads")[![](https://img.shields.io/badge/deploy-%F0%9F%9B%B3%20Ship.js-blue?style=flat) ](https://github.com/algolia/shipjs "deploy")[![GitHub last commit](https://img.shields.io/github/last-commit/vinayakkulkarni/v-mapbox) ](https://github.com/vinayakkulkarni/v-mapbox/commits/main "Last Commit")[![GitHub contributors](https://img.shields.io/github/contributors/vinayakkulkarni/v-mapbox) ](https://github.com/vinayakkulkarni/v-mapbox/graphs/contributors "Contributors")[![Maintenance](https://img.shields.io/maintenance/yes/2024) ](https://github.com/vinayakkulkarni/v-mapbox/commits/main "maintenance")[![](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fvinayakkulkarni%2Fv-mapbox.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2Fvinayakkulkarni%2Fv-mapbox?ref=badge_shield)

> 合并 [阴道](https://vuejs.org/) 财务报告和审定财务报表 [地图盒 GL JS](https://mapbox.com/mapbox-gl-js) (v3.x) (中文(简体) ) [地图libreGL](https://maplibre.org/maplibre-gl-js/docs/) (v4.x) 🗺

V-Mapbox 环绕 Mapbox GL JS 进行 >v1.x到 & Maplibre GL JS > v4.x 库,提供与地图互动的vueish-way.

[说明和文件](https://v-mapbox.netlify.app/)

## 安装

```sh
# For Vue 2
$ npm i v-mapbox@legacy
# For Vue 3
$ npm i v-mapbox
```

## 演示

[![Edit v-mapbox-vue-3](https://codesandbox.io/static/img/play-codesandbox.svg)](https://codesandbox.io/s/v-mapbox-uq9ri2?fontsize=14&hidenavigation=1&theme=dark)

## (原始内容存档于2013-10-13). Deck.gl QQ

[![Edit v-mapbox-with-deck-gl-geojson](https://codesandbox.io/static/img/play-codesandbox.svg)](https://codesandbox.io/s/v-mapbox-with-deck-gl-geojson-f8nn5q?fontsize=14&hidenavigation=1&theme=dark)

## 发展

```sh
git clone git@github.com:vinayakkulkarni/v-mapbox.git
cd v-mapbox
npm install
```

以 Dev 模式运行 :

```sh
npm run serve
```

用于生产的建筑:

```sh
npm run build
```

### 文档

以开发模式启动文档站点 :

```sh
npm run docs:dev
```

构建文档 :

```sh
npm run docs:build
```

受到科里加恩的启发 [Vue2 传单](https://github.com/KoRiGaN/Vue2Leaflet)。 。 。 .

## 捐款

1.  叉开它[https://github.com/vinayakkulkarni/v-mapbox/fork 页面存档备份,存于互联网档案馆](https://github.com/vinayakkulkarni/v-mapbox/fork)(中文(简体) )
2.  创建您的特性分支( E)`git checkout -b feat/new-feature`(中文(简体) )
3.  提交更改( E)`git commit -Sam 'feat: add feature'`(中文(简体) )
4.  推向分行(`git push origin feat/new-feature`(中文(简体) )
5.  创建新 [拉请求](https://github.com/vinayakkulkarni/v-mapbox/compare)

_说明_数字 :

1.  请使用 [GitHub 流量](https://web.archive.org/web/20191104103724/https://guides.github.com/introduction/flow/)
2.  提交 & PR 只有在承诺消息和 PR 标题跟随 [常规承诺标准](https://www.conventionalcommits.org/), (中文(简体) ), _读更多关于它 [这里](https://github.com/conventional-changelog/commitlint/tree/master/%40commitlint/config-conventional#type-enum)_
3.  P. 确保您的承诺被签署. _[看为什么](https://withblue.ink/2020/05/17/how-and-why-to-sign-git-commits.html)_

## 作者

**v 地图框** © [维那亚克语Name](https://github.com/vinayakkulkarni),在 [麻省理工学院](https://npmcn.com/package/%40advisr/v-mapbox/LICENSE) 执照.  
由维纳亚克·库尔卡尔尼在撰稿人的帮助下撰写并维护([列表](https://github.com/vinayakkulkarni/v-mapbox/contributors)) (中文(简体) ).

> [维那亚克库尔卡尔尼.dev](https://vinayakkulkarni.dev/) • GitHub 软件 [@ vinayakkulkarni (英语)](https://github.com/vinayakkulkarni) • 推特 [维纳亚克 k](https://twitter.com/_vinayak_k)

## 许可证

麻省理工学院

[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fvinayakkulkarni%2Fv-mapbox.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Fvinayakkulkarni%2Fv-mapbox?ref=badge_large)

## 常见问题

### @advisr/v-mapbox 是什么？

Maplibre \(和 Mapbox\) 有 Vue QQ

### 如何安装 @advisr/v-mapbox？

在项目目录运行 npm install @advisr/v-mapbox，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：maplibre-gl（^4\.0\.0）、vue（^3\.4\.15）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @advisr/v-mapbox 支持 TypeScript 吗？

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

### @advisr/v-mapbox 支持 ESM 还是 CommonJS？

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

### @advisr/v-mapbox 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @advisr/v-mapbox 可以商用吗？

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

### @advisr/v-mapbox 的下载量有多少？

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

### @advisr/v-mapbox 还在维护吗？

最新版本 5\.1\.3 发布于 2025/07/17（1\.3 年前）；至今共发布 4 个版本，其中过去 12 个月发布了 0 个；首次发布于 2022/11/16。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

