更新记录

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

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

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

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

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

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

平台兼容性

uni-app(4.71)

le-map 天地图 Canvas 跨端地图组件

le-map 是面向 uni-app 的天地图地图组件，主打 Canvas 跨端渲染，适用于 H5、App 和微信小程序。插件支持天地图底图、业务覆盖物、标绘编辑、热力图、海量点、GeoJSON、托管天地图 API 和授权管理。

在线入口

• 官方示例：https://le-map.chuyangzhihu.com/#/
• 授权平台：https://adminmap.chuyangzhihu.com/auth/login

授权平台用于注册账号、领取 3 天试用 licenseKey、购买正式授权、绑定应用白名单、查看授权信息及 API 文档。

功能一览

托管天地图 API 返回统一外层结构 { success, code, message, data, meta }，其中 data 直接包含天地图官方返回的数据，便于业务侧按官方文档读取字段。

快速开始

试用期内也必须传入业务方自己的天地图 tk / tdt-key，用于验证地图初始化和核心能力：

<template>
  <view class="map-page">
    <le-map
      ref="mapRef"
      renderer="canvas"
      license-key="lem_live_xxx"
      tk="你的天地图 tk"
      app-id="__UNI__XXXXXX"
      :center="[116.39747, 39.90882]"
      :zoom="12"
      @mapLoaded="handleMapLoaded"
      @error="handleError"
    />
  </view>
</template>

正式上线建议始终传入业务方自己的天地图 tk / tdt-key：

<template>
  <view class="map-page">
    <le-map
      ref="mapRef"
      renderer="canvas"
      license-key="lem_live_xxx"
      tk="你的天地图 tk"
      app-id="__UNI__XXXXXX"
      :center="[116.39747, 39.90882]"
      :zoom="12"
      @mapLoaded="handleMapLoaded"
      @overlayClick="handleOverlayClick"
      @error="handleError"
    />
  </view>
</template>

const handleMapLoaded = () => {
  mapRef.value?.setMarker('device-layer', {
    points: [
      {
        id: 'device-1',
        lonlat: [116.39747, 39.90882],
        text: '设备 1',
        icon: 'https://example.com/marker/device-online.png',
        popup: {
          title: '设备 1',
          content: '点击点位查看详情'
        }
      }
    ]
  });
};

托管天地图 API 示例

import { createTdtClient } from '@/uni_modules/le-map';

const tdt = createTdtClient({
  licenseKey: 'lem_live_xxx',
  appId: '__UNI__XXXXXX',
  tk: '你的天地图 tk'
});

const result = await tdt.search.keyword({
  keyword: '天安门',
  regionCode: '110000',
  page: 1,
  pageSize: 10
});

console.log(result.code, result.data);

已封装的 API：

• 搜索：keyword、bounds、nearby、polygon、region、category、statistics、suggest
• 编码：geocode、regeocode
• 行政区：district.search、district.byCode、district.children、district.boundary
• 路线与公交：route.drive、route.transit、bus.lineDetail、bus.stationLines
• 静态图：staticMap.url、staticMap.withMarkers、staticMap.withPaths、staticMap.image
• 批量：batch.geocode、batch.regeocode、batch.search

完整参数说明见 docs/api-reference.md 和 docs/tdt-api.md。

获取授权

1. 打开授权平台：https://adminmap.chuyangzhihu.com/auth/login
2. 注册账号，系统自动发放 3 天试用 licenseKey。
3. 在 uni-app 项目中传入 license-key、业务方自己的天地图 tk / tdt-key 和 app-id 进行试用。
4. 正式上线前购买套餐并绑定应用白名单。
5. 生产环境传入 license-key、业务方天地图 tk / tdt-key 和当前应用 app-id。

白名单支持英文逗号分隔：

• uni-app AppID：__UNI__XXXXXX,__UNI__YYYYYY
• H5 域名：example.com,h5.example.com
• Android 包名：com.example.app
• iOS Bundle ID：com.example.ios
• 微信小程序 AppID：wx1234567890abcdef

平台支持

注意事项

• 公开包固定请求 le-map 官方授权服务；私有化部署需要使用单独私有包。
• 3 天试用授权加载地图和调用托管 API 仍必须传入业务方自己的天地图 tk / tdt-key。
• 正式生产使用必须传入业务方自己的天地图 tk / tdt-key。
• 小程序端需要配置 le-map 服务、天地图 API、瓦片和业务图片域名。
• 点位图标建议使用可公开访问的 HTTPS 图片。