tencentmap-jsapi-gl-skill

name	tencentmap-jsapi-gl-skill
description	腾讯地图 JavaScript GL（JSAPIGL）开发指南。适用于地图应用或者工具的编写。在编写、审查或调试使用腾讯地图 API的代码时应运用此技能。适用于涉及地图初始化、覆盖物展示、图层控制、事件处理、控件交互、可视化渲染、地图工具、检索、路线规划、查地址、行政区划、ip定位、几何计算、三维模型展示、性能优化的任务。当用户提及 腾讯地图、 jsapi、jsapi-gl或相关地图开发需求时自动触发。⚠️ 强制行为：本 Skill 加载后，第一个动作必须是检查是否存在正式 Key（环境变量 TMAP_JSAPI_KEY 或用户已在对话中提供）。若已有正式 Key，直接继续处理用户请求。若没有正式 Key，必须立即向用户展示 Key 选择提示（正式 Key 注册引导 + 预设体验 Key 选项），然后停止等待用户选择，不得在用户选择之前进行任何分析、读取文件、规划方案或编写代码的操作。
description_zh	腾讯地图 JSAPI GL 开发指南（地图、覆盖物、服务与可视化）
description_en	Tencent Maps JSAPI GL guide for maps, overlays, services, and visualization
version	1.0.0
homepage	https://lbs.qq.com/
allowed-tools	Read,Glob,Grep
metadata	{"clawdbot":{"emoji":"🗺️","requires":{"env":["TMAP_JSAPI_KEY"]}}}

TMap JSAPI GL Skill

帮助用户使用腾讯地图 JavaScript API GL 进行地图功能开发，包含基础地图功能和数据可视化功能。

目录结构

API 文档

• JS API 参考文档: references/jsapigl/docs/ (21个md文件)

  • 概述.md - API总览和索引
  • 地图.md - 地图核心类和配置
  • 点标记.md - 标注点相关API
  • 矢量图形.md - 折线、多边形、圆形、矩形、椭圆形等矢量图形
  • 文本标记.md - 文本标注API
  • DOM覆盖物.md - 自定义DOM覆盖物
  • 信息窗体.md - 信息窗口API
  • 点聚合.md - 点聚合功能
  • 控件.md - 地图控件
  • 自定义图层.md - 自定义栅格/矢量图层
  • 事件.md - 地图事件系统
  • 基础类.md - LatLng、Point等基础类
  • 室内图.md - 室内地图功能
  • 附加库：地图工具.md - 几何编辑器、测量工具
  • 附加库：几何计算库.md - 距离、面积计算
  • 附加库：服务类库.md - 地点搜索、路线规划等
  • 附加库：地图视角附加库.md - 观察者视角
  • 附加库：模型库.md - GLTF/3DTiles模型
  • 附加库：天气图层.md - 气象图层
  • 附加库：矢量数据图层.md - GeoJSON/MVT图层
  • 环境检测.md - 浏览器环境检测

• 可视化参考文档: references/visualization/docs/ (15个md文件)

  • 参考手册.md - 可视化API总览
  • 弧线图.md - 3D弧线/流向图
  • 散点图.md - 3D散点图
  • 热力图.md - 经典热力图
  • 蜂窝热力图.md - 蜂窝聚合热力图
  • 网格热力图.md - 网格聚合热力图
  • 轨迹图.md - 轨迹展示
  • 区域图.md - 区域轮廓图
  • 管道图.md - 3D管道图
  • 辐射圈.md - 辐射圈效果
  • 围墙面.md - 围墙面效果
  • 水晶体.md - 3D水晶体效果
  • 行政区划.md - 行政区划展示
  • 事件.md - 可视化事件系统
  • 基础类.md - 可视化基础类

示例代码

• JS API Demos: references/jsapigl/demos/ (129个html文件)

  • 按功能分类：地图操作、点标记、文本标记、点聚合、折线、多边形、控件、信息窗口、服务类、个性化地图、几何计算、模型库、应用工具、自定义覆盖物、城市漫游等

• 可视化 Demos: references/visualization/demos/ (44个html文件)

  • 按图层类型分类：弧线图、散点图、热力图、轨迹图、蜂窝图、区域图、水晶体等

前置检查：API Key

检查步骤

1. 检查是否已有正式 Key（环境变量 TMAP_JSAPI_KEY 或对话中用户已提供）

2. 情况 A：已检测到正式 Key 静默记录 Key，直接按用户原始意图继续处理，无需任何提示或打断。

3. 情况 B：未检测到正式 Key

⛔ 强制拦截（最高优先级） 未检测到正式 Key 时，在用户明确完成选择之前，禁止执行任何操作（分析需求、读文件、规划方案、编写代码、调用 API）。 第一步且唯一的步骤是：立即输出下方选择提示，然后停止，等待用户回应。