JavaScript实现地图功能需集成第三方API（如高德、百度或Leaflet），核心步骤为引入SDK、初始化地图容器、设置中心点与缩放级别，并添加标记、弹窗等交互元素；注意坐标系适配，WGS-84需转GCJ-02或BD-09。
JavaScript 实现地图功能，核心是集成第三方地图 API（如高德、百度、腾讯或 Leaflet + OpenStreetMap），而不是从零手写地图渲染。关键在于引入 SDK、初始化地图容器、设置中心点与缩放级别，并按需添加标记、路线、信息窗等交互元素。
选择合适地图 API 并引入 SDK
国内常用的是高德地图（AMap）和百度地图（BMap），需先在对应平台注册账号、创建应用、获取 API Key。
- 高德：在 index.html 中通过 script 标签引入，例如：
<script src="https://webapi.amap.com/maps?v=2.0&key=您的KEY"></script> - 百度：类似方式引入，注意 v=3.0 版本更稳定，且需在 URL 中带上 ak 参数：
<script src="https://api.map.baidu.com/api?v=3.0&ak=您的AK"></script> - 若倾向开源轻量方案，可用 Leaflet + 免费瓦片（如 OpenStreetMap），只需引入 leaflet.css 和 leaflet.js，无需申请 key（但商用需留意服务条款）。
初始化地图容器并设置基础视图
确保页面有带 id 的 div 作为地图容器，并在 DOM 加载完成后初始化。
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 高德示例：
const map = new AMap.Map('map-container', {
center: [116.397428, 39.90923], // 经纬度数组 [lng, lat]
zoom: 13
}); - 百度示例：
const map = new BMap.Map('map-container');
map.centerAndZoom(new BMap.Point(116.404, 39.915), 13); - Leaflet 示例：
const map = L.map('map-container').setView([39.915, 116.404], 13);
L.tileLayer('https://{a-d}.tile.openstreetmap.org/{z}/{x}/{y}.png').addTo(map);
添加标记、弹窗与简单交互
用户常需要标出位置、点击查看详情。所有主流 API 都提供 Marker 类和事件绑定方法。
立即学习“Java免费学习笔记（深入）”；
- 高德添加标记：
const marker = new AMap.Marker({position: [116.404, 39.915]});
marker.setMap(map);
AMap.event.addListener(marker, 'click', () => { alert('这是北京！'); }); - 百度类似：
const marker = new BMap.Marker(new BMap.Point(116.404, 39.915));
map.addOverlay(marker);
marker.addEventListener('click', () => { ... }); - Leaflet 更简洁：
L.marker([39.915, 116.404]).addTo(map)
.bindPopup('欢迎来到北京').openPopup();
处理坐标系与数据适配问题
国内地图 API 对坐标系有严格要求：百度用 BD-09，高德和腾讯用 GCJ-02，WGS-84（GPS 原始坐标）直接使用会导致偏移。
- 若你的数据是 GPS 设备采集的 WGS-84 坐标，必须转换后再传给地图 API；高德 SDK 提供
AMap.convertFrom，百度提供BMap.Convertor（需异步调用）。 - Leaflet 默认支持 WGS-84，但若叠加国内商业瓦片（如天地图），也需确认其坐标系是否匹配，否则出现错位。
- 调试时可借助在线工具（如「坐标拾取器」）验证某地点在各平台显示是否一致。
