百度地图JS API无法跨端通用：H5需HTTPS+坐标转换用BMapGL，小程序强制用腾讯地图，App须用原生插件或web-view；因各端环境缺失window/document或DOM支持，直接引入会报错或白屏。
不能直接调用百度地图 JS API，必须按端分离处理：H5 可用 BMapGL（需 HTTPS + 坐标转换），小程序只能用腾讯地图（wx.chooseLocation），App 端必须用原生插件（如 uni-baidu-map）或 web-view 嵌套 HTML。
为什么直接引入 baidu-map-js-api 会报错
百度地图 JS API 依赖 window、document 和 DOM 操作，而 uni-app 的 App 端运行在 WebView 或原生渲染层，小程序端完全屏蔽了这些全局对象。常见错误包括：ReferenceError: window is not defined、undefined is not a function、控制台静默无输出但地图白屏。
社区封装的 vue-baidu-map 或 uni-baidu-map（非 DCloud 官方）多数未适配 nvue 渲染和小程序 polyfill，iOS info.plist 权限缺失、安卓签名不匹配时也会直接 fail。
- 别在
main.js或pages.json里 importbaidu-map-js-api - 禁用任何 npm install 的“百度地图 Vue 组件”
- HBuilderX 云打包默认不含百度 SDK，App 真机调试必须用“自定义基座”
H5 端用 BMapGL.Map 要过三关
H5 是唯一能跑官方 JS SDK 的端，但极易卡在初始化失败——表面没报错，地图就是不显示。根本原因是协议、坐标系、注入时机三者不满足。
- 页面必须是 HTTPS，HTTP 下
BMapGL.Map初始化静默失败，Network 面板可见 403 -
manifest.json中填入"baidu_map": {"ak": "你的AK"}，HBuilderX 3.9+ 才会自动注入全局BMapGL对象（注意不是BMap） -
uni.getLocation({type: 'gcj02'})在 H5 不支持，必须手动调用百度坐标转换：BMapGL.Convertor.translate([lng, lat], 1, 5, callback)，其中1是 WGS84 输入，5是转 BD09LL -
LocalSearch必须传bounds参数，否则默认全国搜索，结果极不准
微信小程序端根本不能用百度地图界面
微信强制使用 wx.chooseLocation，它底层是腾讯地图，不接受 provider: 'baidu' 参数，写进去也静默忽略。你无法在小程序里展示百度地图 UI、发起百度 POI 搜索或调用百度路线规划。
百度地图 RTOS SDK（mapsdk-rtos）应用层集成规范与代码生成。帮助应用开发者对接 mapsdk-rtos，开发类似 rtos-mac-simulator（mapAPP）的应用层，包含初始化鉴权、地图组件控制、覆盖物（Marker/Polyline）、检索路线、离线地图、导航、Canvas 适配层等能力。当用户提到：对接 RTOS 地图 SDK、集成 mapsdk-rtos、RTOS 地图初始化、MapComponentApi、AuthLicenseApi、SearchApi、NaviApi
返回坐标是 GCJ02（火星坐标），不是 BD09；百度官方没有提供 GCJ02 → BD09 的 JS 接口，强行转换误差达百米级。
- 定位用
uni.getLocation({type: 'gcj02'})（小程序支持该 type） - 选点统一走
uni.chooseLocation()，不要传 provider - 若需跨端 POI 检索，建议后端用百度 Web 服务 API（需 server-type AK），前端只传经纬度
App 端必须用原生插件或 web-view
App 端有两个可行路径，但都不能混用：
-
原生插件方案：用
uni-baidu-map（社区主流），需在manifest.json的app-plus.distribute.android.metaData中配置com.baidu.lbsapi.API_KEY，iOS 还得补NSLocationWhenInUseUsageDescription；调用uni.openLocation({provider: 'baidu'})才生效 -
web-view 方案：在
static/html/map.html中完整写百度 JS API，通过uni.postMessage和uni.onMessage传参 - 两种方案返回的坐标都是 BD09，后续叠加百度 POI 或路线规划时必须保持坐标系一致
最容易被忽略的是：App 端真机测试时，HBuilderX 默认“运行到浏览器”或“云打包”不会包含百度 SDK，必须勾选“自定义基座”并选择已集成百度 SDK 的基座，否则 uni.openLocation 直接静默失败。
