更新记录

2.1.3（2026-09-06） 下载此版本

变更

• 同步 @lee_lubing/le-map 2.1.3 的 Trial 动态地图水印和服务端功能权限。
• 补齐与 npm 根入口一致的 core、授权、能力查询和 uni 平台辅助类型导出。
• 保留现有组件和 SDK API；Trial 静态地图由服务端功能权限拒绝，购买后刷新授权即可去除动态水印。

2.1.1（2026-09-01） 下载此版本

更新日志

2.1.1 - 2026-09-01

新增

• 新增基于 @lee_lubing/le-map 2.1.1 的独立 uni_modules 插件包。
• 新增支持 easycom 的 <le-map> Canvas 地图组件。
• 新增 uni-app Vue 3 运行时适配，可在 H5、App Vue 和微信小程序中使用。
• 新增与 npm SDK 保持一致的 Map、core、sdk 及相关地图服务 API 导出。
• 新增授权校验、坐标转换、天地图客户端、绘制编辑和距离面积测量等 SDK 类型声明。
• 新增 DCloud 插件市场所需的插件元数据、平台兼容性声明、使用文档和许可说明。

构建与安全

• 发布产物使用生产模式构建。
• JavaScript 运行时代码已压缩，发布包不包含 source map。
• 插件运行时依赖已打包到 js_sdk/le-map，使用方无需额外安装 npm SDK。

兼容性说明

• 当前版本面向经典 uni-app Vue 3，不适用于 uni-app x/UTS、Vue 2 或 nvue。
• 使用地图服务和授权服务前，需要按目标平台配置网络请求域名和有效 license key。

0.2.1（2026-07-03） 下载此版本

• 全端统一渲染，H5、App、微信小程序保持同一套地图命令和事件。
• 微信小程序端支持热力图、海量点、内置弹窗、点位动画、动态标绘和矢量编辑。
• 完善 天地图底图、点线面、GeoJSON、聚合、热力图、海量点和对象式覆盖物 API。
• 托管天地图 API 返回结构统一为 { success, code, data, meta }，其中 data 直接保留天地图官方返回数据。

平台兼容性

uni-app(4.75)

其他

le-map 地图组件与 SDK

le-map 是面向经典 uni-app Vue 3 的 Canvas 地图插件，同时提供可直接使用的地图组件和 JavaScript SDK。插件基于当前 @lee_lubing/le-map SDK 独立构建，安装到 uni-app 项目后无需再安装 npm SDK，组件、运行时和类型声明均包含在插件包内。

插件简介

• 基于 Canvas 的跨端地图组件，适用于 H5、App Vue 和微信小程序。
• 支持地图初始化、平移缩放、覆盖物、标记点、弹窗、绘制、编辑和测量等能力。
• 通过 easycom 自动注册组件，可直接使用 <le-map>。
• 提供与 npm SDK 一致的 Map、core、sdk 及授权、坐标转换、天地图请求等 JavaScript API。
• 内置 uni-app 运行时适配和 TypeScript 类型声明，减少项目侧配置和重复封装。
• 发布包使用生产构建，JavaScript 代码已压缩且不包含 source map。

快速使用

插件安装到项目的 uni_modules/le-map 后，可以直接使用组件：

<template>
  <le-map
    license-key="YOUR_LICENSE_KEY"
    :center="[116.397, 39.908]"
    :zoom="12"
    style="width: 100%; height: 420px"
    @ready="onReady"
  />
</template>

组件支持 easycom，也可以显式引入组件或 SDK API：

import LeMap, {
  Map,
  createTdtClient,
  createUniTransport
} from '@/uni_modules/le-map';

const client = createTdtClient({
  transport: createUniTransport(uni)
});

主要能力

地图组件

• 地图容器初始化与 ready、error 等生命周期事件。
• 中心点、缩放级别、地图尺寸和交互状态配置。
• 标记点、线面覆盖物、信息弹窗及覆盖物更新与移除。
• 绘制、编辑、距离测量和面积测量。
• 统一的事件别名和错误码，便于在不同平台处理异常。

JavaScript SDK

• Map 地图控制器及 core 核心能力。
• sdk 命名空间下的授权客户端、传输层、天地图客户端和坐标转换工具。
• createUniTransport、createWxTransport 等跨端网络适配器。
• WGS84、GCJ-02 等常用坐标系转换。
• TypeScript 类型声明和错误类型，便于在 Vue 3 项目中获得类型提示。

平台与使用前提

• 目标平台：经典 uni-app Vue 3。
• 已验证平台：H5、App Vue、微信小程序。
• 不适用于 uni-app x/UTS 项目，也不支持 Vue 2 和 nvue。
• 运行地图服务、授权校验、地图接口和远程图片时，需要配置对应平台的网络请求域名及合法域名。
• 生产环境需要配置有效的 le-map license key；授权服务和地图服务的可用性取决于项目配置及服务端状态。

获取授权与平台说明

请访问 le-map 地图服务官网 获取 license key，并查看授权申请、平台支持范围、域名配置和接入说明。不同平台的网络请求、远程图片和地图服务配置要求可能不同，请以官网的最新说明为准。

与 npm SDK 的关系

uni-app 插件和 @lee_lubing/le-map npm 包基于同一套 SDK 能力，公共 API 名称保持一致。uni-app 项目优先从 @/uni_modules/le-map 引入；npm 项目继续从 @lee_lubing/le-map 引入。

反馈与许可

问题反馈和版本信息请查看项目仓库：https://gitee.com/heart-le/le-map。

本插件通过 DCloud 插件市场分发，具体授权范围、license key 使用要求及再分发限制以 license.md 和插件市场页面为准。