让开源，少一点语言距离。
npm包中文文档

2gis-maps

中文文档
4.2.2发布于 2026/10/02SEE LICENSE IN FILECommonJS近 30 天下载 5793

Interactive 2GIS maps API, based on Leaflet

原始使用文档
中文原文

API карт 2GIS npm

При помощи API карт вы сможете:

  • создавать интерактивные карты на веб-странице;
  • показывать на карте различные объекты (маркеры, балуны, геометрические фигуры);
  • производить поиск на карте: определять координаты геообъектов по их названиям и названия по координатам.

Чтобы начать использовать API карт нужно получить ключ, для этого напишите на почту [email protected], далее перейдите в раздел Быстрый старт.

Если вы решили внести свой вклад в развитие продукта, ознакомьтесь с инструкцией для контрибьюторов.

Также мы открыты для общения и готовы ответить на ваши вопросы, чтобы связаться с нами перейдите в раздел Обратная связь.

Дополнительная информация:

  • текущая версия API карт — 2.0;
  • работает с использованием библиотеки Leaflet;
  • правовая информация доступна на сайте 2ГИС.

Релиз

См. RELEASE.md

版本与发布记录

2gis-maps 共发布 57 个版本，首次发布于 2016/05/17；过去 12 个月发布了 10 个版本。

版本发布日期距今
4.2.2latest2026/10/021 个月前
4.2.12026/09/171 个月前
4.1.12026/09/012 个月前
4.1.02026/08/242 个月前
4.0.162026/08/242 个月前
4.0.142026/08/102 个月前

其他发布通道：beta → 0.0.20。

关于 2gis-maps 的常见问题

2gis-maps 是什么？

Interactive 2GIS maps API, based on Leaflet

如何安装 2gis-maps？

在项目目录运行 npm install 2gis-maps，或使用 pnpm add / yarn add / bun add。

2gis-maps 支持 TypeScript 吗？

该包的 package.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/2gis-maps 是否存在。

2gis-maps 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require()；在 ES Module 项目中也可以用 import 引入（Node.js 会把 module.exports 作为默认导出）。

2gis-maps 可以商用吗？

2gis-maps 使用 SEE LICENSE IN FILE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

2gis-maps 的下载量有多少？

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

2gis-maps 还在维护吗？

最新版本 4.2.2 发布于 2026/10/02（1 个月前）；至今共发布 57 个版本，其中过去 12 个月发布了 10 个；首次发布于 2016/05/17。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。