示例中心
功能在线体验
控制台

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

更新时间:2018年06月21日

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

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

编号值

说明

ICON = 11

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

ICON = 12

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

ICON = 17

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

ICON = 18

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

ROUND_ABOUT_NUM = 1

环岛第一出口

ROUND_ABOUT_NUM = 10

环岛第十出口

ICON=11 && ROUND_ABOUT_NUM = 1

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

ICON=12 && ROUND_ABOUT_NUM = 1

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

ICON=17 && ROUND_ABOUT_NUM = 1

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

ICON=18 && ROUND_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    /**< 黑夜 */


示例中心 功能
在线体验
常见问题