更新记录

1.0.0（2026-06-27） 下载此版本

1.0.0

• 新增 le-map 跨端地图组件，支持 H5、App、微信小程序基础地图能力。
• 支持点位、线、面、GeoJSON、聚合、热力图、海量点等地图覆盖物能力。
• 新增内置弹窗、弹窗 action 回调、点位呼吸动画和跳动动画。
• 新增托管天地图 API：搜索、地理编码、逆地理编码、行政区、路线、静态地图和批量接口。
• 增加 license 授权校验、应用绑定、套餐能力控制和服务端调用统计。
• 要求接入方必须传递自己的天地图 tk，插件不内置默认 tk。
• 补充详细使用文档、API 文档和 TypeScript 类型声明。
• 发布包启用 JS 压缩混淆，并配置 uni_modules.encrypt 加密声明。

平台兼容性

uni-app(4.71)

le-map

le-map 是面向 uni-app 和 Vue Web 的跨端地图插件。H5/App 使用 WebView 加载 OpenLayers + 天地图运行时，微信小程序使用原生 map 适配统一 API。

快速使用

<template>
  <view class="map-page">
    <le-map
      ref="mapRef"
      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('points', {
    points: [
      {
        id: 'p-1',
        lonlat: [116.39747, 39.90882],
        text: '点位 1',
        icon: 'https://example.com/marker.png',
        popup: {
          title: '点位 1',
          content: '点击点位打开弹窗'
        }
      }
    ]
  });
};

必填配置

• license-key：le-map 授权 key。
• tk / tdt-key：必须传递业务方自己的天地图 tk，插件不内置默认 tk；未传会触发 MISSING_TDT_KEY。
• 点位图标必须使用 http:// 或 https:// 网络图片。

获取授权

1. 进入 le-map 授权管理平台：https://adminmap.chuyangzhihu.com/。
2. 注册或登录账号，进入“我的授权”。
3. 创建应用，填写应用名称和平台白名单。
4. 选择套餐并完成支付，支付成功后在授权列表复制 licenseKey。
5. 在 <le-map /> 中传入 license-key、业务方自己的天地图 tk 和当前应用 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

常用能力

• 地图初始化、中心点、缩放、fitBounds
• marker / polyline / polygon
• 图层显隐、删除、清空、批量更新
• 内置弹窗、弹窗 action 回调
• 点位呼吸动画、跳动动画
• label marker、cluster、GeoJSON、heatmap、mass marks、底图切换
• 托管天地图 API：搜索、地理编码、逆地理编码、行政区、路线、静态地图、批量接口

详细文档

• 注册管理平台查看详细开发文档