高德和百度地图JS API在加载方式、权限配置、坐标系、地理编码、覆盖物事件及异步加载判断等方面均不兼容。高德需带v=2.0且开通Web端权限，坐标系为GCJ-02；百度v=3.0兼容性更宽但需勾选JavaScript API服务，且坐标经GCJ-02偏移处理导致点位偏移100–500米；两者地理编码结构、事件绑定语法（on vs addEventListener）、信息窗打开方式及加载完成监听事件均不同。
高德和百度地图 JS API 的加载方式不同
高德用 https://webapi.amap.com/maps?v=2.0&key=你的key，必须带 v=2.0 版本号，不填或填错会白屏；百度是 https://api.map.baidu.com/api?v=3.0&ak=你的ak，v=3.0 是当前稳定版，但兼容性略宽（比如 v=3 也能加载）。高德的 key 必须在控制台开通「Web端」权限，百度的 ak 要勾选「JavaScript API」服务，否则控制台报 Invalid key 或 Referer matching failed。
初始化地图对象的构造函数参数不兼容
高德用 new AMap.Map('container', {center: [116.397428, 39.90923], zoom: 13})，坐标是 [lng, lat]（经度在前）；百度用 new BMap.Map('container') + map.centerAndZoom(new BMap.Point(116.397428, 39.90923), 13)，BMap.Point 是 (lng, lat)，但注意：百度内部对坐标做了 GCJ-02 偏移处理，而高德默认就是 GCJ-02，所以直接套用同一组经纬度，百度地图上点位会偏移 100–500 米（尤其在非城市区域）。
地理编码和逆地理编码返回结构差异大
高德的 AMap.Geocoder 回调里，成功时走 status === 'complete'，结果在 result.geocodes[0].location（字符串 "116.397428,39.90923"）；百度的 BMap.Geocoder 成功回调直接给 point 对象，point.lng 和 point.lat 是数字。更关键的是：高德逆地理编码（IP 定位、坐标转地址）默认返回多条匹配，百度只返回最可能的一条，且百度不支持纯 IP 逆查（需配合 BMap.LocalCity()）。
覆盖物事件绑定语法不一致
高德给 marker 绑定点击： marker.on('click', () => {...})，事件名是小写英文；百度是 marker.addEventListener('click', () => {...})，且必须用 addEventListener，onclick 属性无效。另外，高德的 infoWindow 需手动 open(map, position)，百度的 InfoWindow 可直接 map.openInfoWindow(infoWnd, point)，参数顺序和对象类型都不同。稍不注意就会出现“点了没反应”或“窗口飞到地图外”。
立即学习“前端免费学习笔记（深入）”；
高德和百度看似都是“加个地图”，但连坐标系理解、错误码含义、甚至异步加载完成的判断方式（高德靠AMap.event.addListener(map, 'load', ...)，百度靠 map.addEventListener('tilesloaded', ...)）都得单独适配——换接口不是改个 URL 就完事的。 
