uni-app 的 map 组件本身不渲染地图，需按平台配置对应地图服务。微信需开通腾讯位置服务并声明权限；H5 需开启高德模块并填 Web Key；App 需集成原生地图插件。坐标系必须匹配（GCJ-02/WGS-84/BD-09），markers 字段名须为 latitude/longitude。高级功能如弹窗、聚合、自定义图标需调用各端原生 SDK，不可依赖组件内置能力。
uni-app 中 map 组件不能直接显示地图？先确认基础条件
绝大多数“地图不显示”问题，不是代码写错了，而是没过平台准入门槛。微信小程序、支付宝、H5、App 各端的地图能力依赖不同 SDK 和配置，map 组件只是壳，背后必须有真实地图服务支撑。
常见错误现象：map 区域一片灰、控制台报 init map failed、缩放/标记无响应。
- 微信小程序：必须在
app.json的permission里声明scope.userLocation，且用户首次进入要手动授权；还需在微信公众平台开通「腾讯位置服务」并填写key - H5 端：默认用高德，但需在
manifest.json → 模块配置 → 地图（amap）打开，并填入高德 Web 端 key；若未填，map组件会静默降级为不可交互的占位图 - App 端（iOS/Android）：需在
nativePlugins中启用对应地图插件（如maps-amap或maps-baidu），仅配 key 不够，插件没集成等于没装驱动
标记点用 markers 数组，但点不显示或位置偏移？检查坐标系和字段名
uni-app 的 map 组件对坐标系很敏感，它不自动转换，也不校验格式。传进去的是 GCJ-02（国内加密坐标），但你手写的经纬度可能是 WGS-84（GPS 原始坐标），偏差能到 500 米。
使用场景：从后端接口取点、用手机 uni.getLocation 获取当前位置、导入第三方 POI 数据。
-
markers数组中每个对象必须含latitude和longitude字段（注意拼写，lat/lng无效） - 微信小程序要求坐标是 GCJ-02；高德 H5 默认接受 GCJ-02，但若传了 WGS-84，得自己调用
AMap.convertFrom转换 - App 端百度地图插件认 BD-09 坐标，传 GCJ-02 也会偏——别指望 uni-app 自动适配，各端地图底图坐标系不同，得按目标平台要求预处理数据
点击标记弹窗、自定义图标、聚合？原生 map 组件能力有限，别硬扛
uni-app 内置 map 组件只支持基础标记、路线、控件开关，没有点击事件透传、自定义 icon 渲染、热力图或聚合功能。想做这些，本质是绕过组件，直连原生地图 SDK。
性能 / 兼容性影响：强行用 cover-view + cover-image 模拟弹窗，会在 iOS 微信下遮挡地图手势；用 canvas 绘制图标，缩放时模糊且无法响应点击。
- 真需要弹窗详情：监听
markertap事件后，在页面层用普通view浮层展示，别试图在cover-view里放复杂结构 - 自定义图标：H5 可用高德 JS API 的
Marker实例替换；App 端得用maps-baidu插件提供的addMarker方法，传iconPath（本地路径，非网络图） - 聚合：放弃
map组件，改用@dcloudio/uni-ui的uni-map（仅 H5）或各端原生插件封装的聚合方法，uni-app 本身不提供
跨端地图行为不一致？别共用同一套 map 配置
同一个 map 组件，在微信里拖拽顺滑，H5 卡顿，App 里缩放失灵——不是 bug，是各端底层实现差异太大。uni-app 只做了属性映射，没做行为对齐。
参数差异最典型：show-location 在微信里打开会显示蓝点并请求定位权限；在 H5 高德地图里它只是个开关，是否真定位还得调 uni.getLocation；App 端甚至不识别这个属性。
- 缩放级别：
scale值范围不同（微信 3–20，高德 3–19，百度 3–19），设成 21 在微信会 fallback 到 20，H5 直接忽略 - 地图类型：
map-type的可选值各端不互通，微信支持satellite，H5 高德要设viewMode: '3D'才能切三维，App 百度用mapType: 1表示卫星图 - 最易被忽略的点：微信小程序
map组件不支持bindregionchange的causedBy字段判断触发来源（比如是用户拖拽还是setCenterOffset调用），而 App 插件支持——这意味着你写的“防抖逻辑”在微信里可能永远不生效
