场景图

Amap推送路线消息是Amap推送分享到车机的导航路线消息。

时序图

前序文档

消息推送服务初始化

注意： Amap推送路线消息的接收必须开启消息监听，开启监听之前需要是登录状态，并且与Amap登录同一个账号。

关键参数

com.autonavi.gbl.user.msgpush.model.AimRoutePushMsg 路线推送消息

content 消息内容

com.autonavi.gbl.user.msgpush.model.AimRoutePushInfo 路线推送消息内容

location 起点标签信息
destination 终点标签信息
path.startPoints 起点信息，第一个为起点显示点，第二个为投影在路线上的投影点。一个点有两个坐标。
path.viaPoints 途经点信息，第一个为途经点显示点，第二个为投影在路线上的投影点。一个点有两个坐标。
path.endPoints 终点信息，第一个为终点显示点，第二个为投影在路线上的投影点。一个点有两个坐标。
【AimRoutePushInfo.routeParam内部也有起点、终点、途经点信息，请不要使用。要使用AimRoutePushInfo.path内部的起点、终点、途经点信息】
naviId 导航naviId。

【AimRoutePushInfo中的naviId字段，HMI需要填写到发起路线还原请求的RouteService.requestRouteRestoration.setNaviId接口中】

核心接口

void com.autonavi.gbl.user.msgpush.observer.IMsgPushServiceObserver.notifyMessage(AimRoutePushMsg)

ArrayList<AimRoutePushMsg> com.autonavi.gbl.user.msgpush.MsgPushService.getAimRoutePushMessages()

int com.autonavi.gbl.user.msgpush.MsgPushService.updateAimRouteEndPoiName(long, String)

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

调用示例

PushPresenter 的实现参见时序&初始化

public class PushPresenter implements IMsgPushServiceObserver {\n    // 路线消息通知\n    @Override\n    public void notifyMessage(AimRoutePushMsg aimRoutePushMsg) {\n        // 路线还原\n        RouteRestorationOption routeRestorationOption = RouteRestorationOption.create();\n        \n        RoutepathrestorationPathInfo path = aimRoutePushMsg.content.path;\n        routeRestorationOption.setPaths(path.paths);\n        routeRestorationOption.setStartPoints(path.startPoints.points);\n        // routeRestorationOption.setViaPoints(path.viaPoints.points); // 目前开放项目不支持途径点设置\n        routeRestorationOption.setEndPoints(path.endPoints.points);\n\n        MobileRouteParam routeParam = aimRoutePushMsg.content.routeParam;\n        routeRestorationOption.setEndName(routeParam.destination.name);\n        routeRestorationOption.setContentOption(routeParam.contentOption);\n\n        routeRestorationOption.setRouteVer(RouteService.getRouteVersion());\n        routeRestorationOption.setSdkVer(RouteService.getEngineVersion());\n\n        MobileVehicleInfo vehicle = routeParam.vehicle;\n        routeRestorationOption.setCarType(vehicle.type);\n        routeRestorationOption.setCarSize(vehicle.size);\n        routeRestorationOption.setCarHeight(vehicle.height);\n        routeRestorationOption.setCarWidth(vehicle.width);\n        routeRestorationOption.setCarLoad(vehicle.load);\n        routeRestorationOption.setCarWeight(vehicle.weight);\n        routeRestorationOption.setCarAxis(vehicle.axis);\n        routeRestorationOption.setCarPlate(vehicle.plate);\n        routeRestorationOption.setNaviId(aimRoutePushMsg.content.naviId);\n\n        int i = mRouteService.requestRouteRestoration(routeRestorationOption);\n        routeRestorationOption.delete();//销毁\n    }\n}\n\n// 获取路线消息\nArrayList<AimRoutePushMsg> autoPoiMsgList = PushPresenter.getInstance().getAimRoutePushMessages();\n\n// 修改手机推送的路线终点POI的名称\nlong msgId = 0; // 消息ID, SDK推送消息透出 对应字段 MsgPushItem.messageId\nString newName = ""; // 修改后的POI名称\nPushPresenter.getInstance().updateAimRouteEndPoiName(msgId, newName);\n

存档路线消息路线还原流程

路线消息中保存的是手机端算路时的路网场景对应的LinkId，路网更新后将对应的LinkId也就失效了，需要通过算路的方式还原路线。