Skip to content

可调整参数

HDMapSDK 的公共运行配置可以调整缓存、下载、查询等待、几何处理、预取和导航支持更新行为。下表列出默认值、边界和配置影响。

缓存、下载与查询

参数 默认值 边界或特殊值 配置影响
map_data_cache_space_limit 4096 MB 已有默认值，用户无需显式设置；需要调整时单位为 MB 设置下载地图数据的缓存容量上限
concurrent_download_file_count 5 大于 20 时按 20 使用 设置前台地图文件的并行下载数量
timeout 10 秒 单位为秒 设置一般服务接口的等待上限
build_thread_cpu_usage_percentage 0 0 表示自动，100 表示满负载；其他无效值回到自动模式 设置数据构建线程的处理器工作负载期望；实际占用受平台和运行负载影响
enable_cpu_usage_profile false 开启后通过 Info 级日志输出结果 调用系统接口采集 SDK 处理器使用信息，并产生额外处理器开销
interpolate_interval 0.0 m 不大于 0 时不插值；非默认值需随交付包确认 设置几何插值间距；交付实现可能同时改变返回的参考线、ADAS Values 与最左侧车道边界线
区域数据更新 关闭 通过 enableHomeAreaOta(...) 控制 控制交付定义的区域数据更新

fetchLaneGroups(...) 的查询半径是调用参数，不属于 HDMapServiceOptions。公共接口建议不超过 10 km；应用使用与当前业务区域对应的局部范围。

Lane Group 输出结构

参数 默认值 边界或特殊值 配置影响
enable_use_link_bifurcation true 实验性；是否开放调整随项目交付确认 控制道路段分支信息是否参与 Lane Group 切分；开启后可能增加数据预取、处理时间和内存占用
enable_merge_lane_group_with_similar_link true 布尔值 控制是否合并道路段关联信息相同的连续 Lane Group
tiny_lane_group_threshold_in_cm 100 cm 0 关闭短 Lane Group 合并 设置可尝试合并的短 Lane Group 长度阈值

这些参数会改变 SDK 输出的 Lane Group 切分、合并、拓扑关系和运行时 ID。只有在项目交付明确要求时调整；应用仍只读取返回对象，不参与 Lane Group 的生产过程。

导航支持

参数 默认值 边界或特殊值 配置影响
ahead_links_along_route_distance 2500 m 实际输出受剩余路线和可用数据影响 设置沿路线输出的前方道路段距离
along_route_prefetch_distance 5000 m 0 表示不请求沿路线预取；能力是否启用随交付包确认 设置已启用预取链路的沿路线目标距离
along_route_prefetch_width 100 m 0 表示不请求沿路线预取；能力是否启用随交付包确认 设置已启用预取链路的路线两侧目标宽度
nearby_prefetch_radius 1000 m 0 表示不请求车辆附近预取；能力是否启用随交付包确认 设置已启用预取链路的车辆周边目标半径
navigation_status_notify_interval 1000 ms 单位为毫秒 设置 HDMapSDK 输出 NavigationStatus 的间隔
max_navigation_message_wait_time 2000 ms 单位为毫秒 设置导航系统输入消息的最大等待时间；超过后 is_navigation_sdk_notify_working 变为 false
enable_output_along_route_link_geometry false 开启后在 NavigationStatus 中返回道路段几何 控制沿路线道路段几何输出

这些参数只影响导航支持能力。通信模块未配置或不可用时，车道级地图数据仍按自身可用性工作。

缓存空间

map_data_cache_space_limit 只限定下载地图数据的缓存容量。persistent_path 还保存激活回执、地图元数据和运行状态；数据升级或回滚也可能需要临时空间。因此，持久目录的可用空间不能直接等同于该缓存上限。

未显式设置 map_data_cache_space_limit 时使用 4096 MB 默认值。项目只有在容量规划需要不同上限时才调整该参数；快速开始示例保留默认值。

持久目录遵循以下使用边界：

  • 每个服务实例使用专用目录，不与其他进程共享写入；
  • 目录在服务创建前存在且可写；
  • SDK 运行期间不直接替换或清理其中的文件；
  • 清理只处理交付说明列出的缓存子目录，并保留激活回执和项目要求的元数据。

参数关系

  • concurrent_download_file_count 控制下载并发，不改变地图覆盖范围或地图版本；
  • timeout 控制一般调用的等待上限，不改变 DataNotFound、授权失败或数据损坏的含义；
  • 预取距离、宽度和半径只在交付包启用相应预取链路时控制目标范围，不改变显式查询的输入范围；未确认启用前，不使用这些参数估算网络或资源负载；
  • navigation_status_notify_interval 控制 HDMapSDK 输出节奏，max_navigation_message_wait_time 控制导航系统输入心跳判断；两者不表示交通数据内容年龄；
  • enable_output_along_route_link_geometry 只控制道路段几何是否随 NavigationStatus 输出；
  • enable_cpu_usage_profile 依赖 Info 级日志，并产生额外处理器开销；诊断结束后关闭该开关并恢复项目使用的日志级别；
  • interpolate_interval 保持默认值时不插值；启用前确认交付实现的作用对象，并重新验证参考线、ADAS Values、车道边界线与相关渲染结果。
  • Lane Group 输出结构参数会改变返回对象结构和运行时 ID，不作为性能调节开关。

配置字段的创建位置与示例见快速开始，地图版本、预取与数据更新行为见数据与版本管理。