腾讯地图测距功能需先完成定位（实心蓝点）才可启用，网页端须右键选择“测量距离”，移动端需开启精确位置权限，微信H5页面不支持该功能。
腾讯地图测距功能在PC端或移动端点击后无响应、不弹出距离输入框、拖动线段无数值显示，多数情况并非软件崩溃，而是定位未就绪或操作路径未触发测距模块的激活条件。
确认是否已进入可测距状态
打开腾讯地图网页版或App后，先等待右下角定位图标变为实心蓝色圆点并显示“已定位”，【若仍显示“定位中”或灰色图标，测距按钮将完全失效】。GPS信号弱、Wi-Fi未开启、浏览器未授予权限都会卡在这一步。
网页端需额外检查地址栏左侧的锁形图标是否为绿色并显示“连接安全”，否则地理API被浏览器拦截，测距无法初始化。
网页版测距功能启用步骤
第一步：在地图空白处单击右键→选择“测量距离”（不是点击工具栏图标）。
第二步：地图上会出现带数字的蓝色起点标记，此时鼠标移动会实时生成虚线并显示当前长度；若未出现该标记，说明右键菜单未加载完成，刷新页面重试。
第三步：单击左键添加第二个点，两点间即显示直线距离；继续单击可叠加折线，顶部自动累加总长。中途按ESC键可取消当前测距流程。
腾讯地图 JavaScript GL（JSAPIGL）开发指南。适用于地图应用或者工具的编写。在编写、审查或调试使用腾讯地图 API的代码时应运用此技能。适用于涉及地图初始化、覆盖物展示、图层控制、事件处理、控件交互、可视化渲染、地图工具、检索、路线规划、查地址、行政区划、ip定位、几何计算、三维模型展示、性能优化的任务。当用户提及 腾讯地图、 jsapi、jsapi-gl或相关地图开发需求时自动触发。⚠️ 强制行为：本 Skill 加载后，第一个动作必须是检查是否存在正式 Key（环境变量 TMAP_J
移动端测距失败的典型原因
方法一：iOS用户需检查「设置→隐私与安全性→定位服务→腾讯地图」是否设为“使用期间”——设为“永不”会导致测距按钮灰显且点击无反应。
方法二：安卓用户若使用MIUI或OriginOS系统，需进入「应用设置→腾讯地图→权限管理→位置信息」，手动开启“精确位置”，仅开“大致位置”会导致测距启动后立刻中断。
方法三：微信内嵌的腾讯地图H5页面默认禁用测距功能，必须跳转至独立App或浏览器访问 map.qq.com 才能使用。
清除缓存强制重载测距模块
网页端按 Ctrl+Shift+R（Windows）或 Cmd+Shift+R（Mac）硬刷新，绕过CDN缓存加载最新JS逻辑。
App端进入「我的→设置→清理缓存」，注意不要勾选“保留收藏地点”，清理后重启App，首次打开地图时等待3秒再尝试右键测距。
