Baidu Map Rtos Skills（百度地图官方rtos SKills）

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

百度地图 RTOS SDK（mapsdk-rtos）应用层集成规范与代码生成。帮助应用开发者对接 mapsdk-rtos，开发类似 rtos-mac-simulator（mapAPP）的应用层，包含初始化鉴权、地图组件控制、覆盖物（Marker/Polyline）、检索路线、离线地图、导航、Canvas 适配层等能力。当用户提到：对接 RTOS 地图 SDK、集成 mapsdk-rtos、RTOS 地图初始化、MapComponentApi、AuthLicenseApi、SearchApi、NaviApi

mapsdk-rtos 应用层集成规范

功能概述

mapsdk-rtos 应用层集成规范是一项面向实际任务的技能，主要用于目标与边界；目标：帮助应用开发者正确集成 mapsdk-rtos，生成符合 SDK 公开 API 规范的业务代码；

核心要点

负责：鉴权与 License、地图组件初始化、地图状态控制、覆盖物（Marker/Polyline）、检索与路线规划、离线地图、导航、Canvas 适配层要点、macOS 模拟器（mapAPP）扩展新 Demo；
不负责：SD。
它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

使用与执行

从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

mapsdk-rtos 应用层集成规范

目标与边界

目标：帮助应用开发者正确集成 mapsdk-rtos，生成符合 SDK 公开 API 规范的业务代码。
负责：鉴权与 License、地图组件初始化、地图状态控制、覆盖物（Marker/Polyline）、检索与路线规划、离线地图、导航、Canvas 适配层要点、macOS 模拟器（mapAPP）扩展新 Demo。
不负责：SDK 内部实现修改；若需改 SDK 源码，阅读 mapsdk-rtos 工程后再操作。

使用时机

满足其一即启用：

集成 outputIncludes/ 下的 *_api.h 头文件
调用 MapComponentApi / AuthLicenseApi / SearchApi / NaviApi / MapOfflineApi
实现或调试 Canvas 适配层（drawImage、measureText、stroke 等）
在 rtos-mac-simulator（mapAPP）工程中扩展新 Demo
排查地图不渲染、覆盖物不可见、鉴权失败、离线列表为空等问题

对外头文件（`outputIncludes/`）

头文件	职责
`map_component_api.h`	地图组件（`MapComponentApi`）
`auth_license_api.h`	鉴权与 License（`AuthLicenseApi`）
`base_api.h`	基础能力（包名、缓存路径、版本）
`search_api.h`	检索聚合入口（POI、路线、逆地理）
`navi_api.h`	导航（`NaviApi`）
`offline/map_offline_api.h`	离线地图（`MapOfflineApi`）

非 *_api.h 文件多为类型/枚举/结构体，按 *_api.h include 关系引用即可。

快速参考

详细 API 及注意事项按需阅读参考文件：

init-auth.md — 鉴权、初始化顺序、Canvas 适配、联调验收清单、排障关键字。
adapter-build.md — 平台 Adapter 接口清单（C 函数桩 + C++ 适配类）、MapCanvasImpl 实现要点与绑定流程。
overlay-map-control.md — 地图状态控制、Marker、Polyline（点集 / GeoJSON）、触摸事件、路线瓦片预加载。
search-navi-offline.md — 检索（POI/逆地理/路线规划）、导航、离线地图、mapAPP Demo 扩展。
demo.md — 全流程可运行示例（main 初始化、地图状态与覆盖物、触摸、POI 搜索、离线、路线瓦片、导航）。

常见问题速查

现象	首先检查
折线 / Marker 有数据不可见	显式设置线宽与颜色；确认已 `showOverlay` + `updateLayer` + `RequestRender`
地图白屏 / 不渲染	确认 `Authenticate` 成功、`MarkComponentAlive(true)`、`SetCanvas`、`InitMap` 顺序
步行 / POI 无结果	检查鉴权 token、网络层实现、坐标顺序（纬度, 经度）
离线列表为空	先 `RequestVersion`，确认 callback 成功后再 `GetDownloadableCityList`
路线瓦片 progress=-1	瓦片数量超限
实机与模拟器绘制不一致	查 Canvas 后端 stroke/clip/transform，不要先怀疑 GeoJSON 数据丢点
MSVC LNK2038	SDK 与 mapAPP 须同为 Debug 或 Release