示例中心
功能在线体验
menu Created with Sketch. closed Created with Sketch.

高德 开发 高德地图车机版 开发指南 C++平台 信息透出

更新时间:2019年04月29日

1. 导航状态透出

  • 时序图
  • 补充说明

  1、导航侧会在不同的场景下主动透出自身状态给系统侧,该接口仅用于被动接收导航透出的状态,以下主动透出的状态并不是每一种都支持查询的,支持查询的接口会新增在该网站上。

  2、这个函数有两个透出的信息非常重要。一个是 ENAVI_STATUS_APP_RUN(见下表),表示导航开始运行的消息透出,用户收到这个信息之后,表示双方已经建立通信握手,双方的部分业务的交互时序会依赖这个握手建立,我们会在相关的API上标注出来。另一个是 ENAVI_STATUS_APP_INIT ,这个表示地图初始化完毕,所有语音交互业务在没有收到这个信息之前,导航都不会响应系统的请求,我们也会在每一个接口进行标注提醒。

 AmapApiRetCode AMapNaviStatRcvCbReg(FUNC_NaviStatRcv pFuncCb)

  • 函数说明

    用户使用本接口进行回调注册,用于接收导航侧主动透出的信息。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFuncCb

导航状态接收回调函数指针


 回调函数类型定义  typedef int (*FUNC_NaviStatRcv)(EAMapNaviStatus eStat, int n32Param)  

参数

参数说明

 eStat 

ENAVI_STATUS_APP_UNKNOW = -1, /**< 未知状态 */ 

ENAVI_STATUS_APP_RUN, /**< 开始运行,导航启动即为开始运行 */

ENAVI_STATUS_APP_INIT, /**< 初始化完成,每次创建地图完成通知 */

ENAVI_STATUS_APP_QUIT, /**< 运行结束,退出程序 */

ENAVI_STATUS_FORGROUND, /**< 导航在前台运行 */

ENAVI_STATUS_BACKGROUND, /**<  导航在后台运行 */

ENAVI_STATUS_CACULATING_START, /**< 开始算路 */

ENAVI_STATUS_CACULATING_SUCCESS, /**< 算路完成,成功 */

ENAVI_STATUS_CACULATING_FAILED, /**< 算路完成,失败 */

ENAVI_STATUS_GUIDE_START, /**< 开始导航 */

ENAVI_STATUS_GUIDE_STOP , /**< 导航结束 - 手动结束 */

ENAVI_STATUS_SIMULATE_START, /**< 开始模拟导航 */

ENAVI_STATUS_SIMULATE_PAUSE, /**< 暂停模拟导航 - 手动暂停 */

ENAVI_STATUS_SIMULATE_STOP, /**< 停止模拟导航 - 手动结束 */

ENAVI_STATUS_TTS_START, /**< 开始TTS播报 */

ENAVI_STATUS_TTS_STOP, /**< 停止TTS播报 */

ENAVI_STATUS_ZOOM_OUT, /**< 比例尺放大 */

ENAVI_STATUS_ZOOM_IN, /**< 比例尺缩小 */

ENAVI_STATUS_2D_HEAD, /**< 2D车首上 */

ENAVI_STATUS_2D_NORTH, /**< 2D北首上 */

ENAVI_STATUS_3D_HEAD, /**< 3D车首上 */

ENAVI_STATUS_TMC_ON, /**< TMC打开*/

ENAVI_STATUS_TMC_OFF, /**< TMC关闭 */

ENAVI_STATUS_ZOOM_MAX, /**< 达到最大比例尺 */

ENAVI_STATUS_ZOOM_MIN, /**< 达到最小比例尺 */

ENAVI_STATUS_CRUISE_MODE, /**< 进入巡航播报状态 */

ENAVI_STATUS_CRUISE_MODE_OFF, /**< 退出巡航播报状态 */

ENAVI_STATUS_FAVORITE_CHANGED, /**< 收藏夹家信息变更 */

ENAVI_STATUS_FAVORITE_CHANGED_COMPANY, /**< 收藏夹公司信息变更 */

ENAVI_STATUS_MENU_NEARBY, /**< 主图点击菜单--查周边通知 */

ENAVI_STATUS_MENU_SEARCH, /**< 主图点击菜单--搜地点通知 */

ENAVI_STATUS_STC_DLG_HIDE, /**< SEND TO CAR 卡片消失通知 */

ENAVI_STATUS_PARK_DLG_HIDE, /**< 停车场推送卡片消失通知 */

ENAVI_STATUS_CONTINUE_DLG_HIDE, /**< 续航通知对话框消失通知 */

ENAVI_STATUS_CACULATE_FAILED_DLG_HIDE, /**< 算路失败对话框消失通知 */

ENAVI_STATUS_MANUAL_QUIT_DLG_SHOW, /**< 导航中手动退出导航对话框弹出时通知 */

ENAVI_STATUS_MANUAL_QUIT_DLG_HIDE, /**< 导航中手动退出导航时对话框消失通知 */

ENAVI_STATUS_FAVOR_CHANGED_HC, /**< 普通收藏夹变化通知(不包括家和公司) */

ENAVI_STATUS_DAY_MODE, /**< 昼夜模式白天状态通知 */

ENAVI_STATUS_NIGHT_MODE, /**< 昼夜模式黑夜状态通知 */

ENAVI_STATUS_DESTINATION_ARRIVED, /**< 到达目的地导航结束通知 */

ENAVI_STATUS_MUTE_ON, /**< 导航开启静音通知*/

ENAVI_STATUS_MUTE_OFF, /**< 导航开启静音通知*/

ENAVI_STATUS_VOLUME_UP, /**< 导航音量调大通知*/

ENAVI_STATUS_VOLUME_DOWN, /**< 导航音量调小通知*/

ENAVI_STATUS_HEAD_DIRECTION, /**< 车头方向 */

ENAVI_STATUS_DB_READY, /**< 导航可以输出图像到仪表盘 */

ENAVI_STATUS_KEY_SOUND_PLAY, /**< 导航侧按钮点击声音播放*/

ENAVI_STATUS_AGREE_AUTONAVI_PROTOCOL,/**<  导航协议同意按钮被点击的通知 */

ENAVI_STATUS_AVOID_TRAFFIC_JAM_TRUE,    /**< 点击躲避拥堵窗口避开按钮的通知 */

ENAVI_STATUS_AVOID_TRAFFIC_JAM_FALSE,   /**< 点击躲避拥堵窗口忽略按钮的通知 */

ENAVI_STATUS_AVOID_TRAFFIC_JAM_HIDE, /**< 躲避拥堵弹窗消息的通知 */

 n32Param 

当 eStat 为 ENAVI_STATUS_HEAD_DIRECTION 时,这个参数表示的当前车头的方向,单位度,范围是0 - 360。车头方向是导航在定位的情况下主动透出的,透出的频率是1HZ。eStat为其它类型时该参数未定义。

2. Send to Car信息透出

 AmapApiRetCode AMapPoiInfoRcvCbReg(FUNC_PoiInfoRcv pFuncCb) 

  • 函数说明

    导航将从其它APP推送过来的POI信息传送给系统方。这里的其它APP必须要和高德的后台对接才可以实现该功能,比如高德地图。 

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFuncCb

POI信息接收回调函数指针


 回调函数类型定义   typedef int (*FUNC_PoiInfoRcv)(STSetDestInfo *pDest)

参数

参数说明

 pDest

char strName[MAX_POI_NAME_LEN]; /**< 目的地名称 */

STCoord stCoord; /**< 目的地经纬度 */

STCoord stShowCoord; /**< 目的显示纬度 */

EGRoutingPolicy eRoutingPolicy; /**< 算路策略 */

bool bMidWay; /**< 是否中途点 */

char strPoiId[MAX_POI_ID_LEN]; /**< POI id */

char strAddr[MAX_POI_ADDR_LEN]; /**< POI 地址 */

EPoiType ePoiType; /**< POI类型 */

char strTypeCode[16]; /**< POI TypeCode */

  • 相关函数        
  • 典型应用

3. 导航心跳透出

AmapApiRetCode AMapHeartBeatRcvCbReg(FUNC_HeartBeatRcv pFunc)

  • 函数说明

    导航以每10秒的频率主动对外透出心跳包, 使用者可以通过接收心跳包来判断导航是否依然正常运行。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFunc

心跳接收回调函数指针


 回调函数类型定义   typedef int (*FUNC_HeartBeatRcv)(unsigned int un32Count) 

参数

参数说明

 un32Count

心跳的计数

  • 相关函数        
  • 典型应用

导航可能因为死锁或者崩溃导致界面定屏,用该接口可以实现重新启动导航。

4. 导航TBT引导信息透出

AmapApiRetCode AMapTBTRcvCbReg(FUNC_TBTNotify pFuncCb)

  • 函数说明

    接收导航侧透出的TBT(turn-by-turn)信息。TBT信息主要包括转向信息、图标、路口距离、电子眼等重要引导信息。TBT只有在导航状态和模拟导航的状态才会主动透出。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFuncCb

TBT信息接收回调函数指针


 回调函数类型定义   typedef int (*FUNC_TBTRcv)(STGuideInfo* pGuideInfo)

参数

参数说明

 pGuideInfo   

unsigned int uType;//0:GPS导航//1:模拟导航

string szCurRoadName; /**< 当前道路名 */

string szNextRoadName;/**< 下一道路名 */

unsigned int u32SapaDistance;//距离最近服务区的距离,对应的值为int类型,单位:米

unsigned int u32SapaType;//服务区类型,0:高速服务区 1:其他服务器

unsigned int u32CameraDstance;//距离最近的电子眼距离,对应的值为int类型,单位:米

unsigned int u32CameraType;//电子眼类型 0 测速摄像头;  1为监控摄像头; 2为闯红灯拍照;3为违章拍照;4为公交专用道摄像头

unsigned int u32CameraSpeed;//电子眼限速度,对应的值为int类型,无限速则为0,单位:公里/小时           

unsigned int u32CameraIndex;//下一个将要路过的电子眼编号,若为-1则对应的道路上没有电子眼,对应的值为int类型            

unsigned int u32TurnId;//导航转向图标,对应的值为int类型      

unsigned int u32TotalRemainDis;//路径剩余距离,对应的值为int类型,单位:米

unsigned int u32TotalArrivalTime;//路径剩余时间,对应的值为int类型,单位:秒

unsigned int u32SegmentRemainDis;  //当前导航段剩余距离,对应的值为int类型,单位:米

unsigned int u32SegmentArrivalTime;  //当前导航段剩余时间,对应的值为int类型,单位:秒

unsigned int u32CarDirection;//自车方向,对应的值为int类型,单位:度,以正东为基准,逆时针增加

unsigned int u32LimitedSpeed;//当前道路速度限制,对应的值为int类型,单位:公里/小时

unsigned int u32SegmentNum;//当前自车所在Link,对应的值为int类型,从0开始

unsigned int u32CurPointNum;//当前位置的前一个形状点号,对应的值为int类型,从0开始

unsigned int u32Roung_About_Num;//环岛出口序号,对应的值为int类型,从0开始.//1.x版本:只有在icon为11和12时有效,其余为无效值0 2.x版本:只有在icon为11、12、17、18时有效,其余为无效值0

unsigned int u32TotalAllDis;//路径总距离,对应的值为int类型,单位:米

unsigned int u32TotalAllTime;//路径总时间,对应的值为int类型,单位:秒

unsigned int u32CarSpeed;//当前车速,对应的值为int类型,单位:公里/小时

unsigned int u32TrafficLightNum;//红绿灯个数,对应的值为int类型

unsigned int u32SapaNum;//服务区个数,对应的值为int类型

string srSapaName;//下一个服务区名称,对应的值为String类型

unsigned int u32CurRoadType;//当前道路类型,对应的值为int类型

//0:高速公路

//1:国道

//2:省道

//3:县道

//4:乡公路

//5:县乡村内部道路

//6:主要大街、城市快速道

//7:主要道路

//8:次要道路

//9:普通道路

//10:非导航道路

bool bArriveStatus;//是否到达目的地,对应的值为boolean类型

unsigned int u32NextDesRemainDis;  //下一个目的地的剩余距离,对应的值为int类型,单位:米

unsigned int u32NextDesArrivalTime;  //下一个目的地的剩余时间,对应的值为int类型,单位:秒

导航转向图标值说明:

2.x 图标名称

图标

自车图标

1

左转图标

2

右转图标

3

左前方图标

4

右前方图标

5

左后方图标

6

右后方图标

7

左转掉头图标

8

直行图标

9

到达途经点图标

10

进入环岛图标,右侧通行地区的逆时针环岛

11

驶出环岛图标,右侧通行地区的逆时针环岛

12

到达服务区图标

13

到达收费站图标

14

到达目的地图标

15

进入隧道图标

16

进入环岛图标,左侧通行地区的顺时针环岛

17

驶出环岛图标,左侧通行地区的顺时针环岛

18

右转掉头图标,左侧通行地区的掉头

19

顺行图标

20

绕环岛左转,右侧通行地区的逆时针环岛 

21

绕环岛右转,右侧通行地区的逆时针环岛 

22

绕环岛直行,右侧通行地区的逆时针环岛 

23

绕环岛调头,右侧通行地区的逆时针环岛 

24

绕环岛左转,左侧通行地区的顺时针环岛 

25

绕环岛右转,左侧通行地区的顺时针环岛 

26

绕环岛直行,左侧通行地区的顺时针环岛 

27

绕环岛调头,左侧通行地区的顺时针环岛 

28

 关于进出环岛图标的编号说明 

编号值

说明

TurnId  = 11

进入环岛图标,右侧通行地区(例:大陆)的逆时针环岛

TurnId  = 12

驶出环岛图标,右侧通行地区(例:大陆)的逆时针环岛

TurnId  = 17

进入环岛图标,左侧通行地区(例:港澳台)的顺时针环岛

TurnId  = 18

驶出环岛图标,左侧通行地区(例:港澳台)的顺时针环岛

Roung_About_Num =1

环岛第一出口

Roung_About_Num  = 10

环岛第十出口

TurnId =11 &  Roung_About_Num = 1

右侧通行地区的逆时针进入环岛,第1出口驶出

TurnId =12 &  Roung_About_Num  = 1

右侧通行地区的逆时针驶出环岛,第1出口驶出

TurnId =17 &  Roung_About_Num = 1

左侧通行地区的顺时针进入环岛,第1出口驶出

TurnId =18 &  Roung_About_Num = 1

左侧通行地区的顺时针驶出环岛,第1出口驶出

  • 环岛编号支持1~10

右侧通行的环岛编号图标示例


左侧通行的环岛编号图标示例

  • 相关函数        
  • 典型应用

  TBT信息一般用于仪表盘或者其它车载显示设备进行导航的简易显示。

5. 获取剩余距离和剩余时间  

AmapApiRetCode AMapGuideRemainReq()

  • 函数说明

    请求当前车位距离目标终点的剩余距离和时间。这个接口只有在有路径且处于导航状态下才有效。

  • 参数说明
  • 相关函数        

 AMapGuideRemainRcvCbReg 

  • 典型应用

 AmapApiRetCode AMapGuideRemainRcvCbReg(FUNC_GuideRemainRcv pFuncCb) 

  • 函数说明

   注册回调获取导航侧透出的剩余距离和时间信息。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFuncCb

剩余距离和时间接收回调函数指针


 回调函数类型定义   typedef int (*FUNC_GuideRemainRcv)(bool bRet, STGuideInfo *pGuideInfo);

参数

参数说明

 pGuideInfo   

unsigned int uType;//0:GPS导航//1:模拟导航

string szCurRoadName; /**< 当前道路名 */

string szNextRoadName;/**< 下一道路名 */

unsigned int u32SapaDistance;//距离最近服务区的距离,对应的值为int类型,单位:米

unsigned int u32SapaType;//服务区类型,0:高速服务区 1:其他服务器

unsigned int u32CameraDstance;//距离最近的电子眼距离,对应的值为int类型,单位:米

unsigned int u32CameraType;//电子眼类型 0 测速摄像头;  1为监控摄像头; 2为闯红灯拍照;3为违章拍照;4为公交专用道摄像头

unsigned int u32CameraSpeed;//电子眼限速度,对应的值为int类型,无限速则为0,单位:公里/小时           

unsigned int u32CameraIndex;//下一个将要路过的电子眼编号,若为-1则对应的道路上没有电子眼,对应的值为int类型            

unsigned int u32TurnId;//导航转向图标,对应的值为int类型      

unsigned int u32TotalRemainDis;//路径剩余距离,对应的值为int类型,单位:米

unsigned int u32TotalArrivalTime;//路径剩余时间,对应的值为int类型,单位:秒

unsigned int u32SegmentRemainDis;  //当前导航段剩余距离,对应的值为int类型,单位:米

unsigned int u32SegmentArrivalTime;  //当前导航段剩余时间,对应的值为int类型,单位:秒

unsigned int u32CarDirection;//自车方向,对应的值为int类型,单位:度,以正东为基准,逆时针增加

unsigned int u32LimitedSpeed;//当前道路速度限制,对应的值为int类型,单位:公里/小时

unsigned int u32SegmentNum;//当前自车所在Link,对应的值为int类型,从0开始

unsigned int u32CurPointNum;//当前位置的前一个形状点号,对应的值为int类型,从0开始

unsigned int u32Roung_About_Num;//环岛出口序号,对应的值为int类型,从0开始.//1.x版本:只有在icon为11和12时有效,其余为无效值0 2.x版本:只有在icon为11、12、17、18时有效,其余为无效值0

unsigned int u32TotalAllDis;//路径总距离,对应的值为int类型,单位:米

unsigned int u32TotalAllTime;//路径总时间,对应的值为int类型,单位:秒

unsigned int u32CarSpeed;//当前车速,对应的值为int类型,单位:公里/小时

unsigned int u32TrafficLightNum;//红绿灯个数,对应的值为int类型

unsigned int u32SapaNum;//服务区个数,对应的值为int类型

string srSapaName;//下一个服务区名称,对应的值为String类型

unsigned int u32CurRoadType;//当前道路类型,对应的值为int类型

//0:高速公路

//1:国道

//2:省道

//3:县道

//4:乡公路

//5:县乡村内部道路

//6:主要大街、城市快速道

//7:主要道路

//8:次要道路

//9:普通道路

//10:非导航道路

bool bArriveStatus;//是否到达目的地,对应的值为boolean类型

unsigned int u32NextDesRemainDis;  //下一个目的地的剩余距离,对应的值为int类型,单位:米

unsigned int u32NextDesArrivalTime;  //下一个目的地的剩余时间,对应的值为int类型,单位:秒

  • 相关函数

AmapApiRetCode AMapGuideRemainReq()

  • 典型应用

6. 获取当前车位信息

AmapApiRetCode AMapGetCppReq(bool bShow)

  • 函数说明

    请求当前车辆所在的位置信息,包括经纬度、位置名称、地址、电话、SP编码、行政编码。具体参见STCCPInfo声明。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 bShow

false - 缺省值,不将车位信息在地图图面上显示

true -  将车位信息在地图图面上显示


  • 相关函数        

  AMapCppInfoRcvCbReg

  • 典型应用

一般用于语音交互场合,比如用户通过VR说出“我在哪里”,这个时候可以调用该API去请求车辆当前的位置信息。

AmapApiRetCode AMapCppInfoRcvCbReg(FUNC_CppInfoRcv pFuncCb)

  • 函数说明

   注册回调获取导航侧透出的当前车辆的位置信息。只有在定位状态下且有地图数据才能正确的返回车辆的位置信息。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFuncCb

车位信息获取回调函数指针


 回调函数类型定义     typedef int (*FUNC_CppInfoRcv)(EGGetCppErr err, STCCPInfo *pInfo)

参数

参数说明

 err

EGGET_CPP_ERR_SUCCESS, /**< 获取当前车位成功 */

EGGET_CPP_ERR_NO_DATA, /**< 没有地图数据 */

EGGET_CPP_ERR_NO_GPS_LOC, /**< gps未定位 */

EGGET_CPP_ERR_NO_BASESTATION_LOC, /**< 基站未定位 */

 pInfo

float f32Lon;                             /**< 导航经度坐标, 如118.2346 */

float f32Lat;                             /**< 导航纬度坐标, 如39.2346 */

char szName[MAX_ADDR_NAME_LEN+1];         /**< 名称 */

char szAddr[MAX_ADDR_NAME_LEN+1];         /**< 地址 */

char szTel[MAX_ADDR_NAME_LEN+1];          /**< 电话号码 */

char szSpCode[64];                        /**< SP编码 */

char szProvince[MAX_ADDR_NAME_LEN+1];   /**< 省 */

char szCity[MAX_ADDR_NAME_LEN+1];         /**< 市 */

char szDistrict[MAX_ADDR_NAME_LEN+1];   /**< 区 */

  • 相关函数

AMapGetCppReq()

  • 典型应用

7. 最后一公里信息透出 

 AmapApiRetCode AMapLastMileInfoRcvCbReg(FUNC_LastMileRcv pFuncCb)

  • 函数说明

   当车辆距离目标终点的距离小于等于一公里的时候,导航会主动定时主动透出目的地的名称及经纬度信息。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFuncCb 

最后一公里地信息回调


 回调函数类型定义       typedef int (*FUNC_LastMileRcv)(STLastMileInfo *pInfo)

参数

参数说明

 pInfo

char strName[128]; /**< 目的地名称 */

STCoord stCoord; /**< 目的地经纬度 */

  • 相关函数
  • 典型应用

8. 卫星信息透出

 AmapApiRetCode AMapSatlliteInfoReq(bool bOpen) 

  • 函数说明

    请求或终止导航透出卫星信息,信息内容主要包括卫星的可用的个数、信噪比等信息。

  • 参数说明

参数

参数说明

是否必填

格式/样例

bOPen

true - 为默认值,请求透出   

false - 终止透出


  • 相关函数        

   AMapSatlliteInfoRcvReg 

  • 典型应用

一般用于工厂模式下用于检查车机设备的卫星定位是否正常。


 AmapApiRetCode AMapSatlliteInfoRcvReg(FUNC_SatilliteRcv pFunc) 

  • 函数说明

    设置回调用于接收导航透出的卫星信息。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFunc 

卫星信息接收回调函数指针


回调函数定义   typedef int (*FUNC_SatilliteRcv)(int n32Ret, STOutPutSatlliteProList *pInfo)

参数

参数说明

 n32Ret 

0 - 表示卫星信息正常透出

1 - 表示导航未开启该功能

 pInfo 

卫星信息结构体,具体成员如下:

int n32CountBeyond38Db;/**<大于等于38db的卫星个数 */

int n32CountBeyond40Db;/**<大于等于40db的卫星个数 */

int n32Count;                /**< 卫星个数 */

STOutPutSatllitePro info[MAX_OUT_SATELLITEINFO];/**< 卫星信息  */ -- MAX_OUT_SATELLITEINFO是最大支持的卫星个数,该值为24.

每一颗卫星的相关信息存储在STOutPutSatllitePro结构体中,具体的成员如下:

EGSatlliteType eType;  /**< 当前卫星类型 */ -- GPS,北斗,格洛纳斯

int PRNnum;         /**< 01--32卫星编号 */

int cNo;            /**< 信噪比(0~99dB)*/

  • 相关函数      

   AMapSatlliteInfoReq 

  • 典型应用

9. DR数据透出

 AmapApiRetCode AMapDrInfoReq(bool bOpen) 

  • 函数说明

    请求或终止导航透出DR信息,信息内容主要包括加速度计的三个轴向角信息(单位为g)、陀螺仪的三个轴向角信息(单位为度)、安装角信息(单位为度)。

  • 参数说明

参数

参数说明

是否必填

格式/样例

bOpen

true - 默认值,请求透出

false - 终止透出


  • 相关函数        

    AMapDrInfoRcvReg 

  • 典型应用

一般用于工厂模式下用于检查车机设备的DR模块是否正常。


 AmapApiRetCode AMapDrInfoRcvReg(FUNC_DrInfoRcv pFuncCb) 

  • 函数说明

    设置回调用于接收导航透出的DR信息。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFuncCb 

获取DR信息回调函数指针


回调函数定义    typedef int (*FUNC_DrInfoRcv)(int n32Ret,STOutPutDrInfo *pInfo)

参数

参数说明

 pInfo 

DR信息结构体指针,具体的成员信息如下:

double f64GroyRAngle;       /**< 陀螺仪-翻滚角 */

double f64GroyPAngle;           /**< 陀螺仪-俯仰角 */

double f64GroyYAngle; /**< 陀螺仪-偏航角/航向角 */

float f323dAcceZ;           /**< 加速度-Yaw,单位:米/秒^2 */

float f323dfAcceX;          /**< 加速度-Pitch,单位:米/秒^2 */

float f323dfAcceY;          /**< 加速度-Roll,单位:米/秒^2 */

double f64YawMountAngle; /**< 安装角-偏航角 */

double f64PitchMountAngle;  /**< 安装角-俯仰角 */

double f64RollMountAngle; /**< 安装角-翻滚角 */

n32Ret

0 - 表示正常透出

1 - 表示导航端未开启该功能

  • 相关函数      

   AMapDrInfoReq 

  • 典型应用

10. 原始NMEA数据透出

 AmapApiRetCode AMapNmeaReq(bool bOpen) 

  • 函数说明

    请求或终止导航透出原始NMEA(0183)数据。

  • 参数说明

参数

参数说明

是否必填

格式/样例

bOpen

true - 默认值,请求透出

false - 终止透出


  • 相关函数        

     AMapNemaRcvReg 

  • 典型应用

一般用于工厂模式下用于检查车机设备的GPS模块是否能正常的发出NMEA数据。


 AmapApiRetCode AMapNemaRcvReg(FUNC_NmeaDataRcv pFuncCb) 

  • 函数说明

    设置回调用于接收导航透出的NMEA信息。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFuncCb 

获取NMEA信息回调函数指针


回调函数定义      typedef int (*FUNC_NmeaDataRcv)(int n32Ret, char *pNmea)

参数

参数说明

n32Ret

0 - 表示正常透出

1 - 表示导航端未开启该功能

 pNmea 

原始NMEA数据指针,格式是UTF8

  • 相关函数      

   AMapNmeaReq 

  • 典型应用

11. 导航车速信息透出

 AmapApiRetCode AMapSpeedReq() 

  • 函数说明

    请求导航透出车速信息。 如果有车速脉冲,那么透出脉冲车速(单位:km/h),如果没有的话,透出GPS速度信息 (单位:km/h)。

  • 参数说明
  • 相关函数        

  AMapSpeedRcvReg

  • 典型应用

一般用于工厂模式下用于检查车机GPS速度和车速脉冲信号是否正常。


 AmapApiRetCode AMapSpeedRcvReg(FUNC_SpeedRcv pFuncCb) 

  • 函数说明

    设置回调用于接收导航透出的车速信息。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFuncCb 

获取车速信息回调函数指针


回调函数定义        typedef int (*FUNC_SpeedRcv)(float f32Speed)

参数

参数说明

 f32Speed 

车速信息,公里/小时

  • 相关函数      

   AMapSpeedReq 

  • 典型应用

12. 导航版本信息透出

AmapApiRetCode AMapAutoVersionRcvReg(FUNC_AutoVersionRcv pFuncCb)

  • 函数说明

    透出导航APP相关的版本信息,包括渠道号、软件版本号、地图数据版本号。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFuncCb 

版本信息回调函数指针


 回调函数定义        typedef int (*FUNC_AutoVersionRcv)(STNaviVerInfo *pVersion)

参数

参数说明

 pVersion 

版本信息结构体,具体成员如下:

char strSoftVer[64]; /**< 软件版本号 */

char strDataVer[64]; /**< 数据版本号 */

char strChannel[64]; /**< 渠道号 */

  • 相关函数
  • 典型应用

13. 导航比例尺状态查询

  •  时序图

 和“查询导航地图视图模式”一样。

  • 补充说明

 当导航在警告界面的时候,该请求导航不会响应。只有当导航进入地图界面的时候,导航会透出地图初始化完毕的消息 ENAVI_STATUS_APP_INIT(请参见“导航状态透出”),系统收到这个消息之后,发起本请求,导航才能响应。

AmapApiRetCode AMapMapScaleStatusReq()

  • 函数说明

  查询导航当前的比例尺状态。

  •  参数说明

AmapApiRetCode AMapMapScaleStatusRcvCbReg(FUNC_MapScaleStatusRcv pFuncCb)

  • 函数说明

    注册回调用于接收导航透出的比例尺状态。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFuncCb

比例尺状态回调函数指针


 回调函数定义    typedef int (*FUNC_MapScaleStatusRcv)(EMapScaleStatus eStatus)

参数

参数说明

 eStatus

E_MAP_SCALE_UNKNOW = -1,/**< 未知状态 */

E_MAP_SCALE_MAX = 0,  /**< 比例尺最大状态 */

E_MAP_SCALE_MIN,  /**< 比例尺最小状态 */

E_MAP_SCALE_NORMAL,  /**< 比例尺中间状态 */

14.获取当前城市名称

AmapApiRetCode AMapCurCityNameReq()

  • 函数说明

    系统主动向导航请求当前车辆所在的城市名称。

  • 参数说明
  • 相关函数

AMapCurCityNameRcvCbReg

  • 典型应用

  一般用于语音场景,收音机、天气APP用于查询和当前城市相关的信息。


AmapApiRetCode AMapCurCityNameRcvCbReg(FUNC_CurCityNameRcv pFuncCb)

  • 函数说明

    设置回调用于接收导航在接收到系统的请求后透出的当前城市名称。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFuncCb

接收当前城市名称的回调函数指针


回调函数定义    typedef int (*FUNC_CurCityNameRcv)(string &strCityName, string &strProvinceName, string &strAreaName)

参数

参数说明

 strCityName

当前城市名称

 strProvinceName

当前省份名称

 strAreaName

当前区/县名称

  • 相关函数

AMapCurCityNameReq

  • 典型应用

  一般用于语音场景,收音机、天气APP用于查询和当前城市相关的信息。

15. 查询导航地图视图模式

  • 时序图
  • 补充说明

  当导航在警告界面的时候,该请求导航不会响应。只有当导航进入地图界面的时候,导航会透出地图初始化完毕的消息 ENAVI_STATUS_APP_INIT(请参见“导航状态透出”),系统收到这个消息之后,发起本请求,导航才能响应。

  AmapApiRetCode AMapMapViewStatusReq()

  •   函数说明

   查询导航的地图视图状态。

  •  参数说明

 AmapApiRetCode AMapMapViewStatusRespcbReg(FUNC_MapViewStatusRespRcv pFuncCb)

  •   函数说明

  注册回调,接收导航地图视图状态的反馈。

  •  参数说明

参数

参数说明

是否必填

格式/样例

 pFuncCb

回调函数指针


回调函数定义    typedef int (*FUNC_MapViewStatusRespRcv)(EGMapViewStatus eStatus)

参数

参数说明

 eStatus

GMAPVIEW_NORTH, /**< 2D北首上 */

GMAPVIEW_CAR, /**< 2D车首上 */

GMAPVIEW_3D, /**< 3D车首上 */

GMAPVIE_CAR_HEAD,   /**车首上,不具体指明是2D的还是3D的 */

GMAPVIEW_CHANGE_WITH_NAVI, /**< 和主图的视图模式同步,指的是仪表盘等其他屏幕的视图模式与主屏的地图视图模式一致 */

16. 查询导航是否处于引导状态

  • 时序图

 和“查询导航地图视图模式”一样。

  • 补充说明

 引导状态指的是有规划路线成功且进入实际导航状态,模拟导航不算。当导航在警告界面的时候,该请求导航不会响应。只有当导航进入地图界面的时候,导航会透出地图初始化完毕的消息 ENAVI_STATUS_APP_INIT(请参见“导航状态透出”),系统收到这个消息之后,发起本请求,导航才能响应。

 AmapApiRetCode AMapIsNaviInGuideReq()

  • 函数说明

 查询导航是否处于引导状态。

  • 参数说明

 AmapApiRetCode AMapGuideStatusRespcbReg(FUNC_GuideStatusRespRcv pFuncCb)

  • 函数说明

  注册回调,接收导航透出的引导状态。

  • 参数说明

 

参数

参数说明

是否必填

格式/样例

 pFuncCb

回调函数指针


 回调函数定义 typedef int (*FUNC_GuideStatusRespRcv)(bool bInGuide)

参数

参数说明

 bInGuide

true - 处于引导状态

false - 处于非引导状态

17. 查询导航是否处于巡航状态

  • 时序图

 和“查询导航地图视图模式”一样。

  • 补充说明

 巡航状态指的是无路线引导且界面在巡航界面。当导航在警告界面的时候,该请求导航不会响应。只有当导航进入地图界面的时候,导航会透出地图初始化完毕的消息 ENAVI_STATUS_APP_INIT(请参见“导航状态透出”),系统收到这个消息之后,发起本请求,导航才能响应。

AmapApiRetCode AMapIsInCruisingReq()

  • 函数说明

 查询导航是否处于巡航状态。

  • 参数说明

 AmapApiRetCode AMapCruisingStatusRespcbReg(FUNC_CruisingStatusRespRcv pFuncCb)

  • 函数说明

  注册回调接收导航透出的巡航状态。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFuncCb

回调函数指针


回调函数定义  typedef int (*FUNC_CruisingStatusRespRcv)(bool bInCruising)

参数

参数说明

 bInCruising

true - 处于巡航状态

false - 处于非巡航状态

17. 查询实时路况的开关状态

  •  时序图

 和“查询导航地图视图模式”一样。

  • 补充说明

 当导航在警告界面的时候,该请求导航不会响应。只有当导航进入地图界面的时候,导航会透出地图初始化完毕的消息 ENAVI_STATUS_APP_INIT(请参见“导航状态透出”),系统收到这个消息之后,发起本请求,导航才能响应。

AmapApiRetCode AMapTrafficSwitchStatusReq()

  • 函数说明

 查询导航的路况开关状态。

  • 参数说明

 AmapApiRetCode AMapTrafficSwitchStatusRespcbReg(FUNC_TrafficSwitchStatusRespRcv pFuncCb)

参数

参数说明

是否必填

格式/样例

 pFuncCb

回调函数指针


回调函数定义 typedef int (*FUNC_TrafficSwitchStatusRespRcv)(bool bOpen)

参数

参数说明

 bOpen

true - 实时路况打开

false - 实时路况关闭

18. 查询导航在后台的巡航播报的开关状态

  •  时序图

 和“查询导航地图视图模式”一样。

  • 补充说明

导航处于后台的时候,巡航播报的状态可以进行开关控制,也可以支持查询。当导航在警告界面的时候,该请求导航不会响应。只有当导航进入地图界面的时候,导航会透出地图初始化完毕的消息 ENAVI_STATUS_APP_INIT(请参见“导航状态透出”),系统收到这个消息之后,发起本请求,导航才能响应。

AmapApiRetCode AMapCruisingPlayStatusReq()

  • 函数说明

 查询导航的路况开关状态。

  • 参数说明

 AmapApiRetCode AMapCruisingPlayStatusRespcbReg(FUNC_CruisingPlayStatusRespRcv pFuncCb)

参数

参数说明

是否必填

格式/样例

 pFuncCb

回调函数指针


回调函数定义 typedef int (*FUNC_CruisingPlayStatusRespRcv)(bool bOpen)

参数

参数说明

 bOpen

true - 后台巡航播报的状态是打开的

false - 后台巡航播报的状态是关闭的

19. 查询导航的昼夜模式的状态

  •  时序图

 和“查询导航地图视图模式”一样。

  • 补充说明

 当导航在警告界面的时候,该请求导航不会响应。只有当导航进入地图界面的时候,导航会透出地图初始化完毕的消息 ENAVI_STATUS_APP_INIT(请参见“导航状态透出”),系统收到这个消息之后,发起本请求,导航才能响应。

AmapApiRetCode AMapDayNightSettingReq()

  • 函数说明

 查询导航的昼夜模式设置状态。

  • 参数说明

 AmapApiRetCode AMapDayNightSettingRespcbReg(FUNC_DayNightSettingRespRcv pFuncCb)

  • 函数说明

  注册回调接收导航透出的昼夜模式的状态。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFuncCb

回调函数指针


 回调函数定义 typedef int (*FUNC_DayNightSettingRespRcv)(EDayNightMode eMode)

参数

参数说明

 eMode

E_MODE_AUTO, /**< 自动模式 */

E_MODE_DAY,     /**< 白天 */

E_MODE_NIGHT    /**< 黑夜 */


新用户
福利
功能
在线体验
常见
问题