本地数据安装

本章节说明 Onboard 模式下本地地图数据的获取、安装与配置。Onboard/Hybrid 场景下，Search 与导航能力依赖本地数据，需在 SDK 初始化前完成数据部署，并通过 setSdkDataDir 指定数据目录。

数据获取

• Onboard 数据在编译打包后，会按 OEM 项目 单独发放，不同项目的数据包内容可能不同。
• Search 与导航相关数据通常 打包为同一个压缩包 交付。
• 具体版本、下载方式及校验信息以项目发布说明为准。

安装步骤

1. 从项目交付渠道获取 Onboard 数据压缩包。
2. 将压缩包解压至设备或车机上的目标目录。该目录需满足：
3. 应用进程具备 读 权限；
4. 剩余空间满足数据包大小要求；
5. 路径在应用生命周期内保持稳定（避免使用易被清理的临时目录）。 3 在 SDK 初始化时，将上述目录的路径传入 setSdkDataDir。

示例：

val mapDataRoot = "/sdcard/map/TelenavMapData"  // 假设数据压缩包解压到 ”sdcard/map“ 路径，并更名为 TelenavMapData 

val sdkOptions = SDKOptions.builder()
    .setApiKey("<YOUR_API_KEY>")
    .setApiSecret("<YOUR_API_SECRET>")
    .setSdkDataDir(mapDataRoot)
    // ... 其它参数
    .build()

完整初始化流程请参考 初始化。

目录结构

解压后的典型目录结构如下（部分子目录或文件名可能与实际发版不一致，以实际数据包为准）：

<sdkDataDir>/
└── TelenavMapData/
    ├── junction/
    ├── landmarks_3_d/
    ├── map/
    └── index/

注意事项

• 首次安装或升级数据包后，建议重启应用并验证 Search、算路、导航等 Onboard 能力是否正常。
• 若初始化失败或无法加载地图，请优先检查：setSdkDataDir 路径是否正确、目录权限是否足够、TelenavMapData 结构是否完整。