bmap-jsapi-v4listed

# 百度地图 JavaScript API 4.0 ## 核心原则 聚焦通过 `v=4.0` 加载器和全局 `BMap` 命名空间开发浏览器地图应用，不系统介绍其他版本。 ## 固定约束 - 加载地址使用 `https://api.map.baidu.com/api?v=4.0&ak=YOUR_BAIDU_MAP_AK`。 - 新代码使用全局 `BMap`，不要混用其他版本的命名空间和加载参数。 - 示例中的 `YOUR_BAIDU_MAP_AK` 需要替换为开发者自己的 AK；共享代码和日志中不要暴露真实密钥。 - 依赖 AK、在线服务、CORS、WebGL 或真实数据的结果需要在浏览器中验证。 - 创建监听器、覆盖物、控件、图层、服务渲染结果、动画、全景或 Map 时，同时给出对应的解绑、移除、取消或销毁路径。 ## 工作流 1. 确认任务确实使用 `v=4.0` 和 `BMap`。 2. 只读取与需求直接相关的 reference；跨模块任务按“接入 → Map/几何 → 业务模块 → 生命周期 → 排障”加载。 3. 从 reference 选择满足需求的最小 API 组合。 4. TypeScript 安装、配置、类型报错或 `.d.ts` 补充任务同时读取 TypeScript 专页。 5. 检查版本参数、容器尺寸、异步状态、事件引用和资源清理。 6. 对网络和渲染相关结果进行真实浏览器验证。 ## Reference 路由 ### 接入与基础 | 任务 | 读取 | |---|---| | 页面加载、AK、同步/异步入口、空白地图 | [project-setup.md](references/project-setup.md) | | Map 初始化、视野、交互、样式、旋转与倾斜 | [map-core.md](references/map-core.md) | | 控件主题、深色模式、主题变量 | [ui-version-and-theme.md](references/ui-version-and-theme.md) | | Point、Pixel、Size、Bounds、坐标换算 | [coordinates-and-geometry.md](references/coordinates-and-geometry.md) | | 事件监听、解绑、组件销毁 | [events-and-lifecycle.md](references/events-and-lifecycle.md) | | 内置/自定义控件与右键菜单 | [controls-and-context-menu.md](references/controls-and-context-menu.md) | ### 覆盖物 | 任务 | 读取 | |---|---| | Marker、Icon、Symbol、拖拽与事件 | [marker.md](references/marker.md) | | Label、InfoWindow、内容更新与关闭 | [label-and-info-window.md](references/label-and-info-window.md) | | Polyline、Polygon、Rectangle、Circle 与编辑 | [vector-overlays.md](references/vector-overlays.md) | | CustomOverlay、GroundOverlay、Prism、Bez