Skip to content

NavOne 4.29.0 Release Notes

Behavior Changes

  • POI 设施（facets.amenities）：Google 路径下仅详情（getDetailRequest()，operation == "detail"，provider == "google"）在 Place Details 布尔字段为 true 时写入 Entity.facets.amenities[]（DataField：id 为 TN Amenity ID，label 为 Google 展示名 googleLabel）。文本/分类/框选等列表搜索不返回该 facet。映射规则与全量字段表见 谷歌搜索 — 快速接入 §4.1。
  • Hybrid fallback 诊断：Google 未成为最终交付结果（超时、失败、不可用或未参与）时，服务仍自动 fallback TN；集成方可通过新增旁路字段查看 Google 侧 code/message，无需自行重试。读取约定见 快速接入 §2.3.1。

API Changes

  • 备选路 API 变更：改为 SDK 持续检测（详见 备选路。
  • 新增 AudioPromptType.HIGHWAY_EXIT_KEEP（类型值 221）：用于高速出口保持提示（靠左/靠右行驶且请勿驶出高速）。详见 播报。
  • 废弃后方 Alert：AlertEvent.behindAlertItems、HighwayInfo.behindHighwayItems 已标记废弃，后续版本将移除。请仅使用前方字段 aheadAlertItems、aheadHighwayItems。详见 沿途信息。
  • AlertType.SECTION_SPEED_CAMERA 类型重构。详见 一般道路信息。
  • 新增 SearchResponse.alternateAttempt（AlternateSearchAttempt?，包名 com.telenav.searchservice.api）：仅描述 Google 侧尝试结果（provider 恒为 "google"，含 code、message、responseTime）。Hybrid 中 Google 未单独成功、或本次未执行 Google（接口不支持 / 服务不可用）时有值；Google 成功且为顶层结果时为 null。业务成败仍以顶层 SearchResponse.code 判断，不要用 alternateAttempt.code 替代。常见码值见 快速接入 §5.1 — Google 旁路。
  • Entity.facets.amenities：非新增 SDK 类型，为 Entity SDK 既有 DataField 数组；Google 详情路径按 UI Kit 映射填充（见上 Behavior）。响应结构说明见 返回对象。