场景图

特别说明

IGuideService::SetNaviPath接口在>=500的版本存在接口变更。

// < 500的 老接口,mainIndex入参的类型在底层cpp为int32_t\npublic boolean setNaviPath(NaviPath naviPath, long mainIndex);\n\n// >= 500之后的新接口,mainIndex入参的类型在底层cpp为uint32_t\npublic boolean setNaviPath(NaviPath naviPath, long mainIndex);\n\n// >= 610之后的新接口,mainIndex入参被合并到NaviPath中\npublic boolean setNaviPath(NaviPath naviPath);

对于>=550且<610版本的接口，由于备选路重算时，算路结果只返回备选路线，HMI需要保留旧的主引导路线，并把onNewRoute下发的新路线结果（里面只有备选路线）和旧的主引导路线合并，放在同一个NaviPath当中，并设置正确的mainIndex，指向NaviPath中的旧的主引导路线。通过GuideService.setNaviPath( naviPath, mainIndex)设置给GuideService。

对于>=610版本的接口，延续了550的变更之外。把mainIndex参数合并到了接口的第一个入参NaviPath中，增加setNaviPath接口的简洁性&兼容性。同时，备选路重算通知的OnNewRoute结果，已自动包含了当前主引导路线，当前主引导路线在路线结果集合中排在第0条，最前面。HMI无需再像老版本一样，把备选路重算的结果和当前主引导路线融合。

<550老版本接口使用详情如下：

500之前的版本，备选路重算的结果，算路结果只返回备选路线，HMI需要保留旧的主引导路线，并且将onNewRoute下发的新路线结果（里面只有备选路线）通过GuideService.setNaviPath( naviPath, -1)设置给GuideService。【这种setNaviPath传入-1的用法已废弃】

行中备选路重算，SDK内聚，在非多屏一致性产品形态下，优先建议开启SDK自动发起被动重算。参考：《行中SDK自动发起被动重算》

时序图

核心接口

设置导航路线给引导服务

boolean com.autonavi.gbl.guide.GuideService.setNaviPath(NaviPath naviPath)

通知引导服务更新主路线

void com.autonavi.gbl.guide.GuideService.selectMainPathID(long pathID)

导航过程中通知建议用户切备选路线，TMC更新，备选路线更优。

void com.autonavi.gbl.guide.observer.INaviObserver.onSuggestChangePath(long newPathID,long oldPathID,SuggestChangePathReason reason)

导航过程中通知用户切换主导航路线状态

void com.autonavi.gbl.guide.observer.INaviObserver.onSelectMainPathStatus(long pathID,@ChangeNaviPathResult.ChangeNaviPathResult1 int result )

定位检测到自车走到备选路线，回调通知切换路线。透出参数表示从id为oldPathId路线切换到id为pathId的路线。

void com.autonavi.gbl.guide.observer.INaviObserver.onChangeNaviPath(long oldPathId , long pathID)

图层中的路线绘制内容，详见【路线绘制】，下面仅提供部分图层接口提示。

图层更新引导路线数据

void com.autonavi.gbl.layer.BizGuideRouteControl.setPathInfos(ArrayList<BizPathInfoAttrs> pathInfo,int selectIndex)

图层设置选中路线

void com.autonavi.gbl.layer.BizGuideRouteControl.setSelectedPathIndex(int index)

路径线图层更新

void com.autonavi.gbl.layer.BizGuideRouteControl.updatePaths()

说明：函数详情，请复制函数名称到在线API搜索。