高德地图SDK(导航)  V11.1.000
AMapNaviRideView Class Reference

#import <AMapNaviRideView.h>

Inheritance diagram for AMapNaviRideView:
<AMapNaviRideDataRepresentable> <AMapNaviEleBikeDataRepresentable>

Instance Methods

(BOOL showSensorHeading) - __attribute
 
(void) - setCustomMapStyleOptions:
 自定义地图样式设置,可以支持分级样式配置,如控制不同级别显示不同的颜色(自6.6.0开始使用新版样式,旧版样式无法在新版接口setCustomMapStyleOptions:(MAMapCustomStyleOptions *)styleOptions中使用,请到官网(lbs.amap.com)更新新版样式文件) Custom map style settings can support hierarchical style configurations, such as controlling different levels to display different colors (starting from version 6.6.0, the new style is used, and the old style cannot be used in the new interface setCustomMapStyleOptions:(MAMapCustomStyleOptions *)styleOptions, please update the new style file on the official website (lbs.amap.com)) More...
 
(UIImage *normalTexture) - __attribute
 
(UIImage *greyTexture) - __attribute
 
(void) - setStartPointImage:
 设置路径起点图标 Set route start point icon More...
 
(void) - setEndPointImage:
 设置路径终点图标 Set route end point icon More...
 
(void) - setCarImage:
 设置自车图标 Set vehicle icon More...
 
(void) - setCarImageWithSize:
 设置自车图标,保持图片大小 Set the ego vehicle icon and maintain the image size More...
 
(void) - setCarCompassImage:
 设置自车罗盘图标 Set vehicle compass icon More...
 
(void) - setWayPointImage:
 设置路径途经点图标 since 9.3.5 Set route waypoint icon More...
 
(void) - addCustomOverlay:
 在导航地图中添加自定义overlay. since 9.7.0 Add custom overlay to navigation map More...
 
(void) - removeCustomOverlay:
 移除导航地图中的自定义overlay. since 9.7.0 Remove custom overlay from navigation map More...
 
(void) - updateRoutePolylineInTheVisualRangeWhenTheShowModeIsOverview
 在全览状态下调用此函数能够让路线显示在可视区域内(排除EdgePadding后剩余的区域),保证路线不被自定义界面元素遮挡. 比如showUIElements为NO时(自定义界面)横竖屏切换后,可以调用此函数. since 8.0.0 Calling this function in the overview state allows the route to be displayed within the visible area (the remaining area after excluding EdgePadding), ensuring that the route is not obscured by custom UI elements. For example, when showUIElements is set to NO (custom interface), this function can be called after switching between portrait and landscape modes More...
 
- Instance Methods inherited from <AMapNaviRideDataRepresentable>
(void) - rideManager:updateNaviMode:
 导航模式更新回调 Navigation mode update callback More...
 
(void) - rideManager:updateNaviRouteID:
 路径ID更新回调. 注意:请不要在此回调中调用 -selectNaviRouteWithRouteID: 接口,否则会出现死循环调用. Route ID update callback. Note: Please do not call the -selectNaviRouteWithRouteID: interface in this callback, otherwise it will cause an infinite loop call. More...
 
(void) - rideManager:updateNaviRoute:
 路径信息更新回调. 注意:请不要在此回调中调用 -selectNaviRouteWithRouteID: 接口,否则会出现死循环调用. Path Information Update Callback. Note: Please do not call the -selectNaviRouteWithRouteID: interface in this callback, otherwise it will cause an infinite loop call. More...
 
(void) - rideManager:updateNaviInfo:
 导航信息更新回调 Navigation Information Update Callback More...
 
(void) - rideManager:updateNaviLocation:
 自车位置更新回调 Self-Vehicle Position Update Callback More...
 
- Instance Methods inherited from <AMapNaviEleBikeDataRepresentable>
(void) - rideManager:updateNaviMode:
 导航模式更新回调 Navigation mode update callback More...
 
(void) - rideManager:updateNaviRouteID:
 路径ID更新回调. 注意:请不要在此回调中调用 -selectNaviRouteWithRouteID: 接口,否则会出现死循环调用. Route ID update callback. Note: Do not call the -selectNaviRouteWithRouteID: interface in this callback, otherwise it will cause an infinite loop call More...
 
(void) - rideManager:updateNaviRoute:
 路径信息更新回调. 注意:请不要在此回调中调用 -selectNaviRouteWithRouteID: 接口,否则会出现死循环调用. Route information update callback. Note: Do not call the -selectNaviRouteWithRouteID: interface in this callback, otherwise it will cause an infinite loop call More...
 
(void) - rideManager:updateNaviInfo:
 导航信息更新回调 Navigation information update callback More...
 
(void) - rideManager:updateNaviLocation:
 自车位置更新回调 Vehicle position update callback More...
 

Class Methods

(UIImage *) + rideViewTurnIconImageWithIconType:
 

Properties

id< AMapNaviRideViewDelegatedelegate
 
id< MAMapViewDelegatemapViewDelegate
 
BOOL isLandscape
 
AMapNaviViewTrackingMode trackingMode
 
AMapNaviRideViewShowMode showMode
 
BOOL showUIElements
 
BOOL showBrowseRouteButton
 
BOOL showMoreButton
 
BOOL showTurnArrow
 
AMapNaviViewMapModeType mapViewModeType
 
CGFloat autoZoomMinLevel
 
CGFloat autoZoomMaxLevel
 
AMapNaviRouteAnnoState showRouteAnnotation
 
BOOL showCompass
 
CGFloat cameraDegree
 
BOOL showScale
 
CGPoint scaleOrigin
 
CGPoint screenAnchor
 
CGPoint compassOrigin
 
BOOL autoZoomMapLevel
 
CGFloat mapZoomLevel
 
CGFloat lineWidth
 
BOOL showGreyAfterPass
 
AMapNaviPolylineGreyColorrouteGreyColor
 
AMapNaviPolylineTrafficStatusColorrouteStatusColor
 

Detailed Description

骑行导航界面.该类实现AMapNaviRideDataRepresentable协议,可通过 AMapNaviRideManager 的addDataRepresentative:方法进行注册展示骑行导航过程. Bike navigation interface, This class implements the AMapNaviRideDataRepresentable protocol and can be registered to display the bike navigation process through the addDataRepresentative: method of AMapNaviRideManager.

Method Documentation

◆ __attribute [1/3]

- (UIImage* greyTexture) __attribute ((deprecated("Deprecated, please use routeGreyColor instead. since 10.0.900"))) 

路线纹理部分走过后置灰的纹理图片,设置nil恢复默认纹理. 纹理图片需满足:长宽相等,且宽度值为2的次幂. since 7.4.0 The texture image of the route texture after being partially traveled, set nil to restore default texture. The texture image must meet: equal length and width, and the width value must be a power of 2.

◆ __attribute [2/3]

- (UIImage* normalTexture) __attribute ((deprecated("Deprecated, please use routeStatusColor instead. since 10.0.900"))) 

标准路线Polyline的纹理图片,设置nil恢复默认纹理.纹理图片需满足:长宽相等,且宽度值为2的次幂 Texture image for standard route Polyline, set nil to restore default texture. The texture image must meet: equal length and width, and the width value must be a power of 2.

◆ __attribute [3/3]

- (BOOL showSensorHeading) __attribute ((deprecated("Deprecated, the direction of the self-vehicle icon will be displayed as the device direction, and setting is no longer supported. since 10.0.900"))) 

是否显示传感器方向信息,默认NO.设置为YES后,自车图标方向将显示为设备方向 Whether to display sensor orientation information, default NO. After setting to YES, the direction of the self-car icon will display as the device orientation

◆ addCustomOverlay:

- (void) addCustomOverlay: (id< AMapNaviCompositeOverlay >_Nonnull)  overlay

在导航地图中添加自定义overlay. since 9.7.0 Add custom overlay to navigation map

Parameters
overlay具体参考 官方Demo中 DriveViewWithCustomOverlayViewController . Refer to the official Demo DriveViewWithCustomOverlayViewController

◆ removeCustomOverlay:

- (void) removeCustomOverlay: (id< AMapNaviCompositeOverlay >_Nonnull)  overlay

移除导航地图中的自定义overlay. since 9.7.0 Remove custom overlay from navigation map

Parameters
overlay具体参考 AMapNaviCompositeOverlay . Refer to AMapNaviCompositeOverlay

◆ rideViewTurnIconImageWithIconType:

+ (UIImage *) rideViewTurnIconImageWithIconType: (AMapNaviIconType iconType

将骑行的iconType转换为对应的图标资源, Convert the cycling iconType to the corresponding icon resource, 注意:在AMapNaviRideDataRepresentable和AMapNaviEleBikeDataRepresentable的回调方法@selector(rideManager:updateNaviInfo:)中可以获取AMapNaviInfo对象 Note: The AMapNaviInfo object can be obtained in the callback method @selector(rideManager:updateNaviInfo:) of AMapNaviRideDataRepresentable and AMapNaviEleBikeDataRepresentable. iconType取自AMapNaviInfo中的iconType字段 iconType is taken from the iconType field in AMapNaviInfo

Parameters
iconType转向图标枚举 Turn icon enumeration
Since
10.0.820

◆ setCarCompassImage:

- (void) setCarCompassImage: (nullable UIImage *)  carCompassImage

设置自车罗盘图标 Set vehicle compass icon

Parameters
carCompassImage自车罗盘图标 Vehicle compass icon

◆ setCarImage:

- (void) setCarImage: (nullable UIImage *)  carImage

设置自车图标 Set vehicle icon

Parameters
carImage自车图标 Vehicle icon

◆ setCarImageWithSize:

- (void) setCarImageWithSize: (nullable UIImage *)  carImage

设置自车图标,保持图片大小 Set the ego vehicle icon and maintain the image size

Parameters
carImage自车图标,设置nil为默认图标 Vehicle icon. Set to nil to use the default icon.

◆ setCustomMapStyleOptions:

- (void) setCustomMapStyleOptions: ((deprecated("Custom View no longer supports custom map style. Since 11.1.000")))  __attribute

自定义地图样式设置,可以支持分级样式配置,如控制不同级别显示不同的颜色(自6.6.0开始使用新版样式,旧版样式无法在新版接口setCustomMapStyleOptions:(MAMapCustomStyleOptions *)styleOptions中使用,请到官网(lbs.amap.com)更新新版样式文件) Custom map style settings can support hierarchical style configurations, such as controlling different levels to display different colors (starting from version 6.6.0, the new style is used, and the old style cannot be used in the new interface setCustomMapStyleOptions:(MAMapCustomStyleOptions *)styleOptions, please update the new style file on the official website (lbs.amap.com))

Parameters
styleOptions自定义样式options. since 6.6.0 Custom style options

◆ setEndPointImage:

- (void) setEndPointImage: (nullable UIImage *)  endPointImage

设置路径终点图标 Set route end point icon

Parameters
endPointImage终点图标 End point icon

◆ setStartPointImage:

- (void) setStartPointImage: (nullable UIImage *)  startPointImage

设置路径起点图标 Set route start point icon

Parameters
startPointImage起点图标 Start point icon

◆ setWayPointImage:

- (void) setWayPointImage: (nullable UIImage *)  wayPointImage

设置路径途经点图标 since 9.3.5 Set route waypoint icon

Parameters
wayPointImage途经点图标 Waypoint icon

◆ updateRoutePolylineInTheVisualRangeWhenTheShowModeIsOverview

- (void) updateRoutePolylineInTheVisualRangeWhenTheShowModeIsOverview

在全览状态下调用此函数能够让路线显示在可视区域内(排除EdgePadding后剩余的区域),保证路线不被自定义界面元素遮挡. 比如showUIElements为NO时(自定义界面)横竖屏切换后,可以调用此函数. since 8.0.0 Calling this function in the overview state allows the route to be displayed within the visible area (the remaining area after excluding EdgePadding), ensuring that the route is not obscured by custom UI elements. For example, when showUIElements is set to NO (custom interface), this function can be called after switching between portrait and landscape modes

Property Documentation

◆ autoZoomMapLevel

- (BOOL) autoZoomMapLevel
readwritenonatomicassign

锁车模式下是否为了预见下一导航动作自动缩放地图,默认为NO. since 10.0.820 Whether to automatically zoom the map to predict the next navigation action in locked vehicle mode. Default: NO. Since 10.0.820.

◆ autoZoomMaxLevel

- (CGFloat) autoZoomMaxLevel
readwritenonatomicassign

自动比例尺的最大zoomLevel,默认为18,设置有效范围[autoZoomMinLevel,18] The maximum zoomLevel for the automatic scale. Default: 18. Valid range: [autoZoomMinLevel, 18].

Since
10.0.820

◆ autoZoomMinLevel

- (CGFloat) autoZoomMinLevel
readwritenonatomicassign

自动比例尺的最小zoomLevel,默认为14,设置有效范围[14,autoZoomMaxLevel] The minimum zoomLevel for auto-scaling, default is 14, valid range is [14, autoZoomMaxLevel]

Since
10.0.820

◆ cameraDegree

- (CGFloat) cameraDegree
readwritenonatomicassign

非锁车状态下地图cameraDegree,锁车态下内部会处理,默认35.0,范围[0,60]。since 10.0.900 Map cameraDegree in the unlocked state, it will be handled internally in the locked state, default is 35.0, range [0,60]

◆ compassOrigin

- (CGPoint) compassOrigin
readwritenonatomicassign

指南针原点位置. since 8.0.0 The origin position of the compass

◆ delegate

- (id<AMapNaviRideViewDelegate>) delegate
readwritenonatomicweak

实现了 AMapNaviRideViewDelegate 协议的类指针 Implements the class pointer of the AMapNaviRideViewDelegate protocol

◆ isLandscape

- (BOOL) isLandscape
readnonatomicassign

目前是否为横屏状态. since 7.4.0 内部会自行监听 UIDeviceOrientationDidChange 进行横竖屏切换,无需再设置此值,但用户要自行保证 AMapNaviRideView.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight,让 AMapNaviRideView 能够跟着父View一起变化. 可通过回调 -rideView:didChangeOrientation: 获取横竖屏切换时机 Whether it is currently in landscape mode. Since 7.4.0, the system automatically monitors UIDeviceOrientationDidChange for landscape/portrait switching, no need to set this value anymore. However, users must ensure that AMapNaviRideView.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight allows AMapNaviRideView to change along with the parent View. The timing of screen orientation changes can be obtained through the callback -rideView:didChangeOrientation:

◆ lineWidth

- (CGFloat) lineWidth
readwritenonatomicassign

路线polyline的宽度,设置0恢复默认宽度 The width of the route polyline, set to 0 to restore the default width.

◆ mapViewDelegate

- (id<MAMapViewDelegate>) mapViewDelegate
readwritenonatomicweak

可获得和 MAMapView 原始 Delegate 同样的能力. Can obtain the same capabilities as the original Delegate of MAMapView.

◆ mapViewModeType

- (AMapNaviViewMapModeType) mapViewModeType
readwritenonatomicassign

导航界面中的地图样式类型,默认为 AMapNaviViewMapModeTypeDay(白天模式) 。注意只支持AMapNaviViewMapModeTypeDay,AMapNaviViewMapModeTypeCustom,且自定义地图只在非导航状态下可正常工作。since 10.1.200 The map style type in the navigation interface, default is AMapNaviViewMapModeTypeDay (day mode). Note: Only AMapNaviViewMapModeTypeDay and AMapNaviViewMapModeTypeCustom are supported, and the custom map only works properly in non-navigation mode

◆ mapZoomLevel

- (CGFloat) mapZoomLevel
readwritenonatomicassign
当前地图的zoomLevel;可设置锁车下地图缩放等级(配合在关闭了动态比例尺下生效)

The current map zoomLevel; can set the map zoom level in locked mode (applies only when dynamic scale is disabled).

Parameters
zoom缩放等级,取值范围[14-18],默认18 Zoom level. Valid range: [14–18]. Default: 18. modified since 10.5.2.02

◆ routeGreyColor

- (AMapNaviPolylineGreyColor*) routeGreyColor
readwritenonatomicstrong

◆ routeStatusColor

- (AMapNaviPolylineTrafficStatusColor*) routeStatusColor
readwritenonatomiccopy

路线的颜色,在调用 addDataRepresentative 前设置,status 设置为 AMapNaviRouteStatusDefault since 10.0.900 The color of the route should be set before calling addDataRepresentative, with the status set to AMapNaviRouteStatusDefault

◆ scaleOrigin

- (CGPoint) scaleOrigin
readwritenonatomicassign

当前地图比例尺的原点位置,默认(10,10)。注意:只有showUIElements为NO时,设置此值才有效. The origin position of the current map scale, default is (10,10). Note: This value only takes effect when showUIElements is NO.

◆ screenAnchor

- (CGPoint) screenAnchor
readwritenonatomicassign

地图的视图锚点. (0, 0)为左上角,(1, 1)为右下角. 可通过设置此值来改变自车图标的默认显示位置. 注意:只有showUIElements为NO时,设置此值才有效 since 8.0.0 The view anchor point of the map. (0, 0) is the top-left corner, (1, 1) is the bottom-right corner. You can change the default display position of the vehicle icon by setting this value. Note: This value only takes effect when showUIElements is NO.

◆ showBrowseRouteButton

- (BOOL) showBrowseRouteButton
readwritenonatomicassign

是否显示全览按钮,默认YES Whether to display the overview button, default is YES

◆ showCompass

- (BOOL) showCompass
readwritenonatomicassign

是否显示指南针,默认NO Whether to display the compass, default is NO

◆ showGreyAfterPass

- (BOOL) showGreyAfterPass
readwritenonatomicassign

走过的路线是否置灰,默认为NO. since 7.4.0 Whether the traveled route is grayed out, default is NO.

◆ showMode

- (AMapNaviRideViewShowMode) showMode
readwritenonatomicassign

导航界面显示模式,默认AMapNaviRideViewShowModeCarPositionLocked Navigation interface display mode, default is AMapNaviRideViewShowModeCarPositionLocked

◆ showMoreButton

- (BOOL) showMoreButton
readwritenonatomicassign

是否显示更多按钮,默认YES Whether to display the more button, default is YES

◆ showRouteAnnotation

- (AMapNaviRouteAnnoState) showRouteAnnotation
readwritenonatomicassign

是否显示起终途点\步行轮渡扎点\禁行限行图标\封路图标等,默认为全显示.(本View,不支持轮渡点、禁限行、封路图标) Whether to display start/end points, pedestrian/ferry stop points, prohibited driving restriction icons, closed road icons, etc. Defaults to all displayed. (Note: This View does not support ferry points, traffic restriction icons, or closed road icons.)

Since
10.0.820

◆ showScale

- (BOOL) showScale
readwritenonatomicassign

当前地图是否显示比例尺,默认NO。注意:只有showUIElements为NO时,设置此值才有效。 Whether the current map displays the scale, default is NO. Note: This value only takes effect when showUIElements is NO.

◆ showTurnArrow

- (BOOL) showTurnArrow
readwritenonatomicassign

是否显示转向箭头,默认YES Whether to display the turn arrow, default is YES

◆ showUIElements

- (BOOL) showUIElements
readwritenonatomicassign

是否显示界面元素,默认YES Whether to display interface elements, default is YES

◆ trackingMode

- (AMapNaviViewTrackingMode) trackingMode
readwritenonatomicassign

导航界面跟随模式,默认AMapNaviViewTrackingModeMapNorth Navigation interface follow mode, default is AMapNaviViewTrackingModeMapNorth


The documentation for this class was generated from the following file:
© 2017 高德信息技术有限公司 版权所有,保留所有权利。