百度地图JS API仅支持bd09ll坐标系，WGS84或GCJ02坐标直接使用会导致500–700米偏移；必须通过百度官方接口转换，且需确保地图容器尺寸正确、高精度定位启用、错误处理完备。
确认坐标系是否误用 WGS84 或 GCJ02 直接喂给百度地图
百度地图 JS API 只认 bd09ll 坐标（经纬度），但你从 GPS 设备、OpenStreetMap、Leaflet 默认输出或后端数据库查出来的，大概率是 WGS84；国内安卓手机系统定位服务返回的常是 GCJ02。直接把这两种坐标传给 BMapGL.Point 或 map.centerAndZoom，蓝点会整体偏移 500–700 米，且偏移方向随位置变化——这不是“不准”，是“错系”。
- 必须调用百度官方转换接口
http://api.map.baidu.com/geoconv/v1/批量转成bd09ll，不能靠民间公式硬算（精度差、无保障） - 前端若用
BMapGL.Convertor.translate，注意它只支持WGS84 → bd09ll，不支持GCJ02 → bd09ll；GCJ02 必须先转 WGS84 再转，或走服务端统一转换 - 检查
new BMapGL.Map初始化时是否传了enableHighAccuracy: true，否则可能降级为 IP 定位，误差达几公里
高精度定位未启用或权限链断裂
HTML 页面调用 navigator.geolocation.getCurrentPosition 获取的原始坐标，本身精度就依赖系统设置。如果手机系统禁用了 GPS、或浏览器没拿到“精确位置”授权，accuracy 字段可能高达 2000 米，再怎么转坐标也白搭。
- 安卓用户需在系统设置里打开“位置信息 → 模式 → 高精度”，并确保“WLAN 扫描”和“蓝牙扫描”开启（辅助室内定位）
- iOS 用户需在
设置 → 隐私与安全性 → 定位服务 → Safari 浏览器中设为“使用期间”，且开启“精确位置”开关 - 网页中调用前务必检查
GeolocationPositionOptions.enableHighAccuracy === true，否则浏览器可能默认用网络定位
地图容器尺寸未正确初始化导致坐标映射错乱
百度地图 JS API 渲染依赖容器元素的宽高。如果容器初始 display: none、或父级 flex/grid 未设明确尺寸、或 CSS 加了 transform: scale()，会导致地图图层像素坐标与地理坐标的映射关系失准，表现为拖动后定位点“粘不住”、点击事件位置偏移。
- 确保地图容器有确定的
width和height（非auto或%且父级未定高） - 若容器动态显示（如 Tab 切换后才显示地图），需在显示后手动触发
map.centerAndZoom或map.refresh（v3.0+ 推荐map.setCenter后跟map.panTo） - 避免对地图容器或其父级使用
transform、filter等会创建新层叠上下文的 CSS 属性
未监听 positionerror 或 fallback 逻辑缺失
真实场景中，getCurrentPosition 失败不是小概率事件：用户拒权、GPS 信号弱、浏览器超时（默认 60s）、甚至某些国产浏览器静默降级为 IP 定位。一旦失败却没兜底，地图就卡在默认中心点，看起来像“偏移”。
立即学习“前端免费学习笔记（深入）”；
- 必须传入 error 回调，捕获
error.code === 1（用户拒绝）、2（位置不可用）、3（超时）等状态 - fallback 方案建议两级：一级用
map.centerAndZoom(new BMapGL.Point(116.404, 39.915), 11)（北京天安门粗略中心）；二级可尝试调用百度 IP 定位接口https://api.map.baidu.com/location/ip - 别依赖
watchPosition的首次回调——它可能比getCurrentPosition更慢、更不稳定
