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

高德 开发 高德地图车机版 开发指南 C++平台 主图业务

更新时间:2018年06月21日

1. 回地图/回车位

 AmapApiRetCode AMapGotoMapReq(EGGoToCppType eType) 

  • 函数说明

 回地图 - 将当前车标的位置显示在地图图面的中心。如果当前HMI界面处于有路径的导航状态或者无路径的巡航状态,会将车位拉回到当前界面的地图中心;如果当前的HMI界面既不在巡航态也不在导航态,那么会先将界面跳转到巡航界面,并将车位拉回地图中心。如果导航APP处于后台的话,导航在做回地图之前还会向系统请求切换至前台显示。

回车位 - 此功能暂未实现

  • 参数说明

参数

参数说明

是否必填

格式/示例

eType

E_FUNC_TYPE_UNKNOW = -1 /**< 未知类型 */

E_FUNC_TYPE_CPP /**< 回车位 */

E_FUNC_TYPE_MAP /**< 回地图界面 */


  •  相关函数      

 AMapGotoMapRcvCbReg

  •  典型应用

 一般用于语音交互场景,比如VR说“我的位置”,这个时候使用者就可以调用这个API并传入E_FUNC_TYPE_MAP实现显示当前车位的功能。


 AmapApiRetCode AMapGotoMapRcvCbReg(FUNC_GoToMapRcv pFuncCb) 

  • 函数说明

   设置获取回车位/回地图执行结果的回调函数,用来知道导航侧回车位/回地图执行是否成功。

  • 参数说明

参数

参数说明

是否必填

格式/示例

 pFuncCb  

  回车位/回地图回调函数指针


回调函数类型定义   typedef int (*FUNC_GoToMapRcv)(EGGoToCppType, bool);

参数

参数说明

格式/示例

 bRet 

true - 成功

false - 失败


  •  相关函数      

 AMapGotoMapReq

  •  典型应用

这个使用者根据实际需要调用该接口进行回调注册。

2. 地图缩放

 AmapApiRetCode AMapZoomMapReq(bool bEnlarge) 

  • 函数说明

   控制地图图面放大/缩小 。使用前提是当前导航必须处于地图界面。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 bEnlarge

true - 放大

false - 缩小


  •  相关函数      

  AMapZoomMapRcvCbReg 

  •  典型应用

 一般用于语音交互场景,比如VR说"放大地图",调用该API并传入true就可以实现地图放大。也可以用于车机硬按钮,比如点击按钮“+”,也可以调用该API传入true实现地图的放大。

 AmapApiRetCode AMapZoomMapRcvCbReg(FUNC_ZoomMapRcv pFuncCb) 

  • 函数说明

    设置获取地图放大/缩小执行结果的回调函数,用来知道导航侧地图缩放是否成功。

  • 参数说明

参数

参数说明

是否必填

格式/示例

 pFuncCb 

  导航控制指令回调函数指针


回调函数类型定义  typedef int (*FUNC_ZoomMapRcv)(bool bZoom,bool bRet,unsigned int un32Scale) 

参数

参数说明

 bZoom

true - 放大

false - 缩小

 bRet

true - 缩放成功

false - 缩放失败

 un32Scale

当前地图的比例尺等级(目前该参数不起作用,不要用这个参数去做相关的判断)

  •  相关函数      

  AMapZoomMapReq 

  •  典型应用

这个使用者根据实际需要调用该接口进行回调注册。

3. 地图视图模式切换

 AmapApiRetCode AMapMapViewChangeReq(EGMapViewStatus eViewStat) 

  • 函数说明

   控制地图图面的视图模式。 导航地图的视图模式有三种,分别是2D正北,2D车首北,3D。默认的是2D车首北。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 eViewStat

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

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

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

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

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


  •  相关函数      

  AMapViewSwitchRespcbReg

  •  典型应用

 一般用于语音交互场景,比如VR说"切换3D",调用该API并传入 GMAPVIEW_3D 就可以实现将地图的视图模式切换为3D模式。

 AmapApiRetCode AMapViewSwitchRespcbReg(FUNC_ViewSwitchRespRcv pFuncCb)

  • 函数说明

   VR发地图视图切换指令之后,导航反馈切换是否成功,成功之后的地图视图状态。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFuncCb

回调函数指针


回调函数类型定义 typedef int (*FUNC_ViewSwitchRespRcv)(EGCOMMERR eErr, EGMapViewStatus eStatus)

参数

参数说明

 eErr

E_COMM_ERR_OK = 0, /**< 成功 */

E_COMM_ERR_FAILED = 1,/**< 失败 */

 eStatus

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

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

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

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

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

  •  相关函数      

  AMapMapViewChangeReq 

  •  典型应用

4. 设置相关

4.1 开关设置

 AmapApiRetCode AMapOnOffReq(EGFunctionConfig eFuncStat,bool bOpen) 

  • 函数说明

    控制导航实时交通、前方路况播报、电子眼、安全提醒功能的开启/禁用。 

  • 参数说明

参数

参数说明

是否必填

格式/样例

 eFuncStat

E_FUNC_CFG_UNKNOW = -1, /**<  未知操作类型 */

E_FUNC_CFG_TRAFFIC, /**< 实时交通 */

E_FUNC_CFG_TRAFFIC_VOICE, /**< 前方路况播报 */

E_FUNC_CFG_ELECTRONIC_POLICE, /**< 电子眼 */

E_FUNC_CFG_SAFT_DRIVING, /**< 安全提醒 */

E_FUNC_CFG_CRUISE_BROADCAST, /**< 巡航播报 */


 bOpen

true - 打开

false - 禁用


  •  相关函数      

   AMapFuncOnOffResponseCbReg  

  •  典型应用

 一般用于语音交互场景,比如VR说"关闭实时交通",调用该API并传入 E_FUNC_CFG_TRAFFIC 就可以关闭实时交通。


 AmapApiRetCode AMapFuncOnOffResponseCbReg(FUNC_OnOffRcv pFuncCb) 

  • 函数说明

     设置获取开关设置执行结果的回调函数,用来知道导航侧开关设置执行是否成功。

  • 参数说明

参数

参数说明

是否必填

格式/示例

 pFuncCb 

  导航控制指令回调函数指针


回调函数类型定义   typedef int (*FUNC_OnOffRcv)(EGFunctionConfig eConfig, EGFuncRetCode eRet) 

参数

参数说明

 eConfig

E_FUNC_CFG_TRAFFIC, /**< 实时交通 */

E_FUNC_CFG_TRAFFIC_VOICE, /**< 前方路况播报 */

E_FUNC_CFG_ELECTRONIC_POLICE, /**< 电子眼 */

E_FUNC_CFG_SAFT_DRIVING, /**< 安全提醒 */

E_FUNC_CFG_CRUISE_BROADCAST, /**< 巡航播报 */

 eRet

E_FUNC_RET_SUCCESS, /**< 成功 */

E_FUNC_RET_NET_UNAVAILABLE, /**< 网络不可用 */

E_FUNC_RET_ALREADY_OPEN, /**< 开关已开启 */

E_FUNC_RET_ALREADY_CLOSED, /**< 开关已关闭 */

E_FUNC_RET_NOT_INT_CRUISE, /**< 未在巡航状态*/

E_FUNC_RET_UNKNOW, /**< 未知原因的失败 */

  •  相关函数      

  AMapOnOffReq 

  •  典型应用

这个使用者根据实际需要调用该接口进行回调注册。

4.2 导航恢复出厂设置

AmapApiRetCode AMapFactoryResetReq()

  • 函数说明

    导航APP恢复出厂设置 。

  • 参数说明
  •  相关函数      
  •  典型应用

一般车机的主界面上会做一个恢复导航出厂设置的按钮,使用者点击该按钮可以调用该API,就可以让导航恢复出厂设置。

4.3 其它设置指令

 AmapApiRetCode AMapNaviOperateNotify(ENaviOpeType eType) 

  • 函数说明

     该接口提供了一些导航控制命令给系统侧,涵盖工厂模式、声音、引导相关的操作,详见下面的参数说明。  

  • 参数说明

参数

参数说明

是否必填

格式/示例

  eType  

ENAVI_OPE_UNKNOW = -1, 未知操作类型

ENAVI_OPE_QUIT  -  导航退出

ENAVI_OPE_CACULATING_STOP - 导航算路停止

ENAVI_OPE_MUTE_ON - 静音

ENAVI_OPE_MUTE_OFF - 取消静音

ENAVI_OPE_VOLUME_UP - < 音量调高

ENAVI_OPE_VOLUME_DOWN - 音量调低

ENAVI_OPE_DATA_RECOVERY - 用于工厂模式下,用于数据清除

ENAVI_OPE_FATORY_SIMU_START - 电检模式下模拟导航开始

ENAVI_OPE_FATORY_SIMU_STOP - 电检模式下模拟导航结束

ENAVI_OPE_FATORY_SOUND_TEST - 电检模式下声音测试

ENAVI_OPE_TEMP_CANCEL_MUTE -  取消临时静音

ENAVI_OPE_TEMP_MUTE - 临时静音

ENAVI_OPE_ENTER_FACTORY - 跳过激活直接进入工厂模式

ENAVI_OPE_SAVE_NAVI_CFG, /**< 保存导航的配置 */


  •  相关函数      

   AMapFuncOnOffResponseCbReg  

  •  典型应用

 一般用于语音交互场景,比如VR说"退出导航",调用该API并传入  ENAVI_OPE_QUIT  就可以退出导航APP。


AmapApiRetCode AMapNaviOperateNotifyRcvCbReg(FUNC_NaviOperateRcv pFuncCb)

  • 函数说明

     设置控制导航指令执行结果的回调函数,用来知道导航侧指令执行是否成功。

  • 参数说明

参数

参数说明

是否必填

格式/示例

 pFuncCb 

  导航控制指令回调函数指针


回调函数类型定义    typedef int (*FUNC_NaviOperateRcv)(ENaviOpeType eType, int n32Param)  

参数

参数说明

格式/示例

   eType 

ENAVI_OPE_QUIT  -  导航退出(导航进程退出)

ENAVI_OPE_CACULATING_STOP - 导航算路停止

ENAVI_OPE_MUTE_ON - 静音

ENAVI_OPE_MUTE_OFF - 取消静音

ENAVI_OPE_VOLUME_UP - < 音量调高

ENAVI_OPE_VOLUME_DOWN - 音量调低

ENAVI_OPE_DATA_RECOVERY - 用于工厂模式下,用于数据清除

ENAVI_OPE_FATORY_SIMU_START - 电检模式下模拟导航开始

ENAVI_OPE_FATORY_SIMU_STOP - 电检模式下模拟导航结束

ENAVI_OPE_FATORY_SOUND_TEST - 电检模式下声音测试

ENAVI_OPE_TEMP_CANCEL_MUTE -  取消临时静音

ENAVI_OPE_TEMP_MUTE - 临时静音

ENAVI_OPE_ENTER_FACTORY - 跳过激活直接进入工厂模式

ENAVI_OPE_SAVE_NAVI_CFG, /**< 保存导航的配置 */


   n32Param  

当操作类型为 ENAVI_OPE_TEMP_CANCEL_MUTE,   ENAVI_OPE_TEMP_MUTE,  ENAVI_OPE_MUTE_ON,  ENAVI_OPE_MUTE_OFF,  ENAVI_OPE_VOLUME_UP,  ENAVI_OPE_VOLUME_DOWN,ENAVI_OPE_FATORY_SOUND_TEST 时,该参数返回1 - 代表指令执行成功 0 - 代表指令执行失败。当操作类型为 ENAVI_OPE_FATORY_SIMU_START,  ENAVI_OPE_FATORY_SIMU_STOP 时,该参数的意义如下

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

G_ROUTING_SUCCESS, /**< 算路成功 */

G_ROUTING_NO_DATA, /**< 没有数据 */

G_ROUTING_NO_NET, /**< 未联网*/

G_ROUTING_NO_ROUTE, /**< 当前没有路径 */

G_ROUTING_NO_SET_HOME, /**< 家未设置 */

G_ROUTING_NO_SET_WORK, /**< 公司未设置 */

G_ROUTING_MID_POINT_EXIST, /**< 途经点存在 */

G_ROUTING_MID_POINT_FULL, /**< 途经点满了,无法继续添加 */

G_ROUTING_FAIL, /**< 其他算路失败原因 */


  •  相关函数      

  AMapNaviOperateNotify 

  •  典型应用

这个使用者根据实际需要调用该接口进行回调注册。


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