| java.lang.Object | ||
| ↳ | com.tencent.map.navi.TencentNaviManager | |
| ↳ | com.tencent.map.navi.car.TencentCarNaviManager | |
Class Overview
驾车导航控制类。 用于实现驾车算路，开启导航，停止导航，设置导航状态回调， 设置路口放大图、车道线等导航功能的开关。
Summary
| Public Constructors | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
|
TencentCarNaviManager(Context context)
导航管理类初始化方法
| |||||||||||
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| void |
addNaviView(INaviView iNaviView)
添加导航面板数据更新协议（INaviView），添加后可通过该协议获取
导航面板所需数据（如道路名称、转向箭头、路口放大图等）。
使用导航SDK提供的默认导航界面CarNaviView（包括地图和导航面板），
需要将其通过本方法传入；若需要自定义导航面板，则可实现INaviView并通过本方法传入。
| ||||||||||
| void |
addTencentNaviCallback(TencentNaviCallback tencentNaviCallback)
注册导航状态回调。
可注册多个。 | ||||||||||
| void |
changeDestination(NaviPoi naviPoi)
修改导航终点。
仅导航中生效。 | ||||||||||
| void |
changeDestinationAndWays(NaviPoi end, List<NaviPoi> ways)
同时修改目的地和途径点。
| ||||||||||
| void |
changeNaviRoute(int reason)
切换道路。用户调用此接口后，SDK会自动发起重算、切换道路并重新开启导航。
| ||||||||||
| void |
changeRouteByRouteId(String routeID)
导航过程中使用webservice api得到的路线id进行重新算路。
| ||||||||||
| void |
changeSearchOptions(CarRouteSearchOptions options)
调整算路配置。
| ||||||||||
| int |
changeToFollowedRoute(String routeID)
切换⾄备选路线。
| ||||||||||
| void |
changeWayPoints(List<NaviPoi> ways)
修改导航途径点。
| ||||||||||
| int |
deleteFollowedRoute(String routeID)
导航过程中删除某备选路线。
| ||||||||||
| boolean |
isNavigating()
当前是否处在导航中
| ||||||||||
| void |
parseRawData(byte[] rawData, CarRouteSearchRequest searchRequest, TencentRouteSearchCallback searchCallback)
解析原始路线数据，解析成功后可开启导航。
| ||||||||||
| void |
removeAllNaviViews()
移除所有导航面板数据更新协议
| ||||||||||
| void |
removeNaviView(INaviView iNaviView)
移除导航面板数据更新协议
| ||||||||||
| void |
removeTencentNaviCallback(TencentNaviCallback tencentNaviCallback)
移除导航注册回调。
| ||||||||||
| void |
requestTts()
请求Tts播报
| ||||||||||
| void |
searchRoute(NaviPoi from, NaviPoi to, ArrayList<NaviPoi> wayPoints, CarRouteSearchOptions carSearchOptions, CalcRouteCallback tencentSearchCallback)
发起驾车导航的路线规划接口通过传入起点、终点、途径点、配置参数发起路线规划。
可以通过设置回调参数获取路线。
| ||||||||||
| void |
setCarNavTtsMode(NavTtsMode mode)
设置导航播报模式。
| ||||||||||
| void |
setEnlargedIntersectionEnabled(boolean enabled)
是否开启路口放大图。若关闭，则不再触发图片下载和INaviView中显示路口放大图的回调。
| ||||||||||
| void |
setGuidedLaneEnabled(boolean enabled)
是否开启车道线。若关闭，则不再触发INaviView中显示车道线的回调。
| ||||||||||
| void |
setInternalTtsEnabled(boolean enabled)
设置是否开启内置语音播报，默认为关闭。
| ||||||||||
| void |
setIsDefaultRes(boolean isDefaultRes)
设置是否使用SDK自带资源。开发者若想使用自定义资源，可以设置为false，
同时在assets根目录下放置同名资源。若加载自定义资源失败，则仍会使用默认资源。
| ||||||||||
| void |
setMulteRoutes(boolean multeRoutes)
设置是否开启伴随路线，默认不开启。
| ||||||||||
| void |
setNaviAdapter(TencentNaviAdapter adapter)
设置导航的适配对象。
| ||||||||||
| void |
setNaviCallback(TencentNaviCallback tencentNaviCallback)
设置导航状态回调。回调事件包括开启导航、停止导航、偏航、语音播报、经过途径点等。
| ||||||||||
| void |
setWaypointRemovedStrategy(WaypointRemovedStrategy strategy)
途径点移除策略，默认为Default：经过途径点自动移除
| ||||||||||
| void |
startNavi(int routeIndex)
开启导航。需要在路线规划成功后发起。
| ||||||||||
| void |
startNaviWithRouteID(String routeID)
开启导航。需要在路线规划成功后发起。
| ||||||||||
| void |
startSimulateNavi(int routeIndex, int simulateSpeedMPS)
开启模拟导航
| ||||||||||
| void |
startSimulateNavi(int routeIndex)
开启模拟导航
| ||||||||||
| void |
stopNavi()
停止导航
| ||||||||||
| void |
stopSimulateNavi()
停止模拟导航
| ||||||||||
| void |
switchParallelRoadType(int roadType)
平行路切换方法。在导航过程中有效.
| ||||||||||
| void |
updateGpsStatus(String provider, int status, String description)
更新GPS状态.可与腾讯定位SDK配合使用，直接获取该方法所需数据。
| ||||||||||
| void |
updateLocation(GpsLocation location, int error, String reason)
This method is deprecated.
No replacement.
| ||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class
com.tencent.map.navi.TencentNaviManager
| |||||||||||
|
From class
java.lang.Object
| |||||||||||
|
From interface
com.tencent.map.navi.NaviMapActionCallback
| |||||||||||
Public Constructors
public TencentCarNaviManager (Context context)
导航管理类初始化方法
Parameters
| context | 上下文 |
|---|
Public Methods
public void addNaviView (INaviView iNaviView)
添加导航面板数据更新协议（INaviView），添加后可通过该协议获取 导航面板所需数据（如道路名称、转向箭头、路口放大图等）。 使用导航SDK提供的默认导航界面CarNaviView（包括地图和导航面板）， 需要将其通过本方法传入；若需要自定义导航面板，则可实现INaviView并通过本方法传入。
Parameters
| iNaviView | 导航面板数据更新协议 |
|---|
public void addTencentNaviCallback (TencentNaviCallback tencentNaviCallback)
注册导航状态回调。
可注册多个。
Parameters
| tencentNaviCallback | 导航状态回调 |
|---|
public void changeDestinationAndWays (NaviPoi end, List<NaviPoi> ways)
同时修改目的地和途径点。
Parameters
| end | 修改之后的目的地 |
|---|---|
| ways | 修改之后的途径点，可为null |
public void changeNaviRoute (int reason)
切换道路。用户调用此接口后，SDK会自动发起重算、切换道路并重新开启导航。
Parameters
| reason | 切换道路的原因。参见ChangeRouteReason
|
|---|
public void changeRouteByRouteId (String routeID)
导航过程中使用webservice api得到的路线id进行重新算路。
Parameters
| routeID | webservice api得到的路线id |
|---|
public int changeToFollowedRoute (String routeID)
切换⾄备选路线。
Parameters
| routeID | 备选路线id |
|---|
Returns
- 结果状态码:
- 0 : 切换成功
- 1 : 此路线已经是导航主路线
- 2 : 没找到对应的路线
- 3 : 当前非导航状态，无法切换
public int deleteFollowedRoute (String routeID)
导航过程中删除某备选路线。
Parameters
| routeID | 备选路线id |
|---|
Returns
- 结果状态码:
- 0 : 删除成功
- 1 : 导航主路线不支持删除
- 2 : 没找到对应的路线
- 3 : 当前非导航状态，无法切换
public boolean isNavigating ()
当前是否处在导航中
Returns
- true: 在导航中，false: 不在导航中
public void parseRawData (byte[] rawData, CarRouteSearchRequest searchRequest, TencentRouteSearchCallback searchCallback)
解析原始路线数据，解析成功后可开启导航。
Parameters
| rawData | 路线规划原始数据 |
|---|---|
| searchRequest | 路线规划请求 |
| searchCallback | 解析完成回调 |
Throws
| Exception |
|---|
public void removeAllNaviViews ()
移除所有导航面板数据更新协议
public void removeTencentNaviCallback (TencentNaviCallback tencentNaviCallback)
移除导航注册回调。
Parameters
| tencentNaviCallback | 待移除回调 |
|---|
public void requestTts ()
请求Tts播报
public void searchRoute (NaviPoi from, NaviPoi to, ArrayList<NaviPoi> wayPoints, CarRouteSearchOptions carSearchOptions, CalcRouteCallback tencentSearchCallback)
发起驾车导航的路线规划接口通过传入起点、终点、途径点、配置参数发起路线规划。 可以通过设置回调参数获取路线。
Parameters
| from | 起点经纬度（必填） |
|---|---|
| to | 终点经纬度（必填） |
| wayPoints | 途经点（可选） |
| carSearchOptions | 路线规划配置参数（必填） |
| tencentSearchCallback | 路线规划回调（可选） |
Throws
| Exception |
|---|
public void setCarNavTtsMode (NavTtsMode mode)
设置导航播报模式。
Parameters
| mode | 导航播报模式类型 |
|---|
public void setEnlargedIntersectionEnabled (boolean enabled)
是否开启路口放大图。若关闭，则不再触发图片下载和INaviView中显示路口放大图的回调。
Parameters
| enabled | true:开启，false:关闭，默认为true |
|---|
public void setGuidedLaneEnabled (boolean enabled)
是否开启车道线。若关闭，则不再触发INaviView中显示车道线的回调。
Parameters
| enabled | true:开启，false:关闭，默认为true |
|---|
public void setInternalTtsEnabled (boolean enabled)
设置是否开启内置语音播报，默认为关闭。
Parameters
| enabled | 是否启用内部语音播报，true:开启，false:关闭。 |
|---|
public void setIsDefaultRes (boolean isDefaultRes)
设置是否使用SDK自带资源。开发者若想使用自定义资源，可以设置为false， 同时在assets根目录下放置同名资源。若加载自定义资源失败，则仍会使用默认资源。
Parameters
| isDefaultRes | true:使用默认资源，false:不使用默认资源, 默认为true。 |
|---|
public void setMulteRoutes (boolean multeRoutes)
设置是否开启伴随路线，默认不开启。
Parameters
| multeRoutes | true：开启伴随路线，false：不开启 |
|---|
public void setNaviCallback (TencentNaviCallback tencentNaviCallback)
设置导航状态回调。回调事件包括开启导航、停止导航、偏航、语音播报、经过途径点等。
public void setWaypointRemovedStrategy (WaypointRemovedStrategy strategy)
途径点移除策略，默认为Default：经过途径点自动移除
Parameters
| strategy | Default: 自动移除； Manually: 调用Api手动移除 |
|---|
public void startNavi (int routeIndex)
开启导航。需要在路线规划成功后发起。
Parameters
| routeIndex | 路线索引。用户在算路完成后，会获得路线数据RouteData的数组， 这里需要传入的routeIndex指的就是RouteData在数组中的index。 |
|---|
Throws
| Exception |
|---|
public void startNaviWithRouteID (String routeID)
开启导航。需要在路线规划成功后发起。
Parameters
| routeID | 需要导航的路线ID |
|---|
Throws
| Exception |
|---|
public void startSimulateNavi (int routeIndex, int simulateSpeedMPS)
开启模拟导航
Parameters
| routeIndex | 路线索引。用户在算路完成后，会获得路线数据RouteData的数组， 这里需要传入的routeIndex指的就是RouteData在数组中的index。 |
|---|---|
| simulateSpeedMPS | 模拟导航速度，米每秒 |
Throws
| Exception |
|---|
public void startSimulateNavi (int routeIndex)
开启模拟导航
Parameters
| routeIndex | 路线索引。用户在算路完成后，会获得路线数据RouteData的数组， 这里需要传入的routeIndex指的就是RouteData在数组中的index。 |
|---|
Throws
| Exception |
|---|
public void stopNavi ()
停止导航
public void stopSimulateNavi ()
停止模拟导航
public void switchParallelRoadType (int roadType)
平行路切换方法。在导航过程中有效. since 5.2.8.
Parameters
| roadType | 切换到的道路类型. |
|---|
public void updateGpsStatus (String provider, int status, String description)
更新GPS状态.可与腾讯定位SDK配合使用，直接获取该方法所需数据。
Parameters
| provider | 定位点来源。“gps”表示为GPS定位点，“network”表示为网络定位点。 |
|---|---|
| status | 状态码。0表示GPS模块关闭,1表示GPS模块打开，2表示定位权限被禁止， 3表示GPS可用，4表示GPS不可用。 |
| description | 描述信息。 |
public void updateLocation (GpsLocation location, int error, String reason)
This method is deprecated.
No replacement.
更新定位点。用户在获取到定位点后，将相关数据通过该方法传入导航SDK。 推荐使用腾讯定位SDK获取所需定位数据.所传定位点必须为GCJ02坐标系。
Parameters
| location | 定位点信息。需要用户自行创建，并传入定位相关数据。 |
|---|---|
| error | 错误码。 仅当error为0时代表定位成功，其他数字代表定位失。 |
| reason | 错误描述。简要描述错误信息. |