345 lines
15 KiB
Objective-C
345 lines
15 KiB
Objective-C
//
|
||
// AMapNaviDriveView.h
|
||
// AMapNaviKit
|
||
//
|
||
// Created by AutoNavi on 15/12/28.
|
||
// Copyright © 2016年 Amap. All rights reserved.
|
||
//
|
||
|
||
#import "AMapNaviHeaderHandler.h"
|
||
#import "AMapNaviCommonObj.h"
|
||
#import "AMapNaviDriveDataRepresentable.h"
|
||
#import "AMapNaviCompositeAnnotation.h"
|
||
|
||
NS_ASSUME_NONNULL_BEGIN
|
||
|
||
@protocol AMapNaviDriveViewDelegate;
|
||
|
||
///驾车导航界面.该类实现AMapNaviDriveDataRepresentable协议,可通过 AMapNaviDriveManager 的addDataRepresentative:方法进行注册展示驾车导航过程.
|
||
@interface AMapNaviDriveView : UIView <AMapNaviDriveDataRepresentable>
|
||
|
||
#pragma mark - Delegate
|
||
|
||
///实现了 AMapNaviDriveViewDelegate 协议的类指针
|
||
@property (nonatomic, weak) id<AMapNaviDriveViewDelegate> delegate;
|
||
|
||
///可获得和 MAMapView 原始 Delegate 同样的能力. since 7.0.0
|
||
@property (nonatomic, weak) id <MAMapViewDelegate> mapViewDelegate;
|
||
|
||
#pragma mark - Mode Options
|
||
|
||
///导航界面跟随模式,默认AMapNaviViewTrackingModeMapNorth
|
||
@property (nonatomic, assign) AMapNaviViewTrackingMode trackingMode;
|
||
|
||
///导航界面显示模式,默认AMapNaviDriveViewShowModeCarPositionLocked
|
||
@property (nonatomic, assign) AMapNaviDriveViewShowMode showMode;
|
||
|
||
#pragma mark - Map Options
|
||
|
||
///当前地图Logo位置, 必须在 AMapNaviDriveView.bounds 之内，否则会被忽略. 注意:只有showUIElements为NO时，设置此值才有效. since 6.2.0
|
||
@property (nonatomic, assign) CGPoint logoCenter;
|
||
|
||
///当前地图Logo的宽高. since 6.2.0
|
||
@property (nonatomic, assign, readonly) CGSize logoSize;
|
||
|
||
///当前地图是否显示比例尺，默认NO. 注意:只有showUIElements为NO时，设置此值才有效.
|
||
@property (nonatomic, assign) BOOL showScale;
|
||
|
||
///当前地图比例尺的原点位置. 注意:只有showUIElements为NO时，设置此值才有效.
|
||
@property (nonatomic, assign) CGPoint scaleOrigin;
|
||
|
||
///是否显示指南针,默认NO
|
||
@property (nonatomic, assign) BOOL showCompass;
|
||
|
||
///指南针原点位置. since 6.3.0
|
||
@property (nonatomic, assign) CGPoint compassOrigin;
|
||
|
||
///指南针的宽高. since 6.3.0
|
||
@property (nonatomic, assign, readonly) CGSize compassSize;
|
||
|
||
///地图是否显示交通路况，默认YES. since 6.1.0
|
||
@property (nonatomic, assign) BOOL mapShowTraffic;
|
||
|
||
///当前地图的zoomLevel，修改zoomLevel会进入非锁车状态
|
||
@property (nonatomic, assign) CGFloat mapZoomLevel;
|
||
|
||
///锁车模式下是否为了预见下一导航动作自动缩放地图,默认为YES。 since 10.0.2
|
||
@property (nonatomic, assign) BOOL autoZoomMapLevel;
|
||
|
||
///非锁车状态下地图cameraDegree，锁车态下内部会处理, 默认35.0, 范围[0,60]
|
||
@property (nonatomic, assign) CGFloat cameraDegree;
|
||
|
||
///地图的视图锚点. (0, 0)为左上角，(1, 1)为右下角. 可通过设置此值来改变自车图标的默认显示位置. 注意:只有showUIElements为NO时，设置此值才有效 since 6.2.0
|
||
@property (nonatomic, assign) CGPoint screenAnchor;
|
||
|
||
///当前地图最大帧数，有效的帧数为：60、30、20、10等能被60整除的数，默认为60. since 6.5.0
|
||
@property (nonatomic, assign) NSUInteger maxRenderFrame;
|
||
|
||
///导航界面日夜模式类型, 默认为 AMapNaviViewMapModeTypeDay(白天模式) since 6.7.0
|
||
@property (nonatomic, assign) AMapNaviViewMapModeType mapViewModeType;
|
||
|
||
/**
|
||
* @brief 自定义地图样式设置,可以支持分级样式配置,如控制不同级别显示不同的颜色(自7.8.0开始使用新版样式,请到官网(lbs.amap.com)更新新版样式文件,否则无法正常显示路口放大图)
|
||
* @param styleOptions 自定义样式options. since 6.6.0
|
||
*/
|
||
- (void)setCustomMapStyleOptions:(MAMapCustomStyleOptions *)styleOptions;
|
||
|
||
///地图是否自动切换白天黑夜模式,默认NO.
|
||
@property (nonatomic, assign) BOOL autoSwitchDayNightType __attribute((deprecated("已废弃, 请使用 mapViewModeType 替代 since 6.7.0")));
|
||
|
||
///是否黑夜模式,默认NO.
|
||
@property (nonatomic, assign) BOOL showStandardNightType __attribute((deprecated("已废弃, 请使用 mapViewModeType 替代 since 6.7.0")));
|
||
|
||
///当前地图是否开启自定义样式, 默认NO.
|
||
@property (nonatomic, assign) BOOL customMapStyleEnabled __attribute((deprecated("已废弃, 请使用 mapViewModeType 替代 since 6.7.0")));
|
||
|
||
/**
|
||
* @brief 自定义当前地图样式, 目前仅支持自定义标准类型. 已废弃, 请使用 setCustomMapStyleOptions: since 6.6.0
|
||
* @param customJson 自定义的JSON格式数据.
|
||
*/
|
||
- (void)setCustomMapStyle:(NSData *)customJson __attribute((deprecated("已废弃, 请使用 setCustomMapStyleOptions: 替代 since 6.6.0")));
|
||
|
||
/**
|
||
* @brief 根据web导出数据设置地图样式, 目前仅支持自定义标准类型. 默认不生效，调用customMapStyleEnabled=YES使生效. since 5.1.0
|
||
* @param data 高德web端工具导出的地图样式数据.
|
||
*/
|
||
- (void)setCustomMapStyleWithWebData:(NSData*)data __attribute((deprecated("已废弃, 请使用 setCustomMapStyleOptions: 替代 since 6.6.0")));
|
||
|
||
#pragma mark - Annoation Options and Overlay Options
|
||
|
||
///是否显示实时交通图层(地图路况+路线路况),默认YES
|
||
@property (nonatomic, assign) BOOL showTrafficLayer __attribute((deprecated("已废弃, 请使用 mapShowTraffic 结合 -statusTextures: 替代. since 7.4.0")));
|
||
|
||
///路线上是否显示摄像头,默认YES
|
||
@property (nonatomic, assign) BOOL showCamera;
|
||
|
||
///路线上是否显示转向箭头,默认YES
|
||
@property (nonatomic, assign) BOOL showTurnArrow;
|
||
|
||
///路线上转弯箭头颜色. since 6.1.0
|
||
@property (nonatomic, strong) UIColor *turnArrowColor;
|
||
|
||
///路线上转弯箭头的宽度,设置0恢复默认宽度. since 6.2.0
|
||
@property (nonatomic, assign) CGFloat turnArrowWidth;
|
||
|
||
///路线上转弯箭头是否为3D箭头线,默认为YES. since 6.6.0
|
||
@property (nonatomic, assign) BOOL turnArrowIs3D;
|
||
|
||
///路线上转弯箭头设置3D箭头的侧边颜色（当turnArrowIs3D为YES时有效). since 6.6.0
|
||
@property (nonatomic, strong) UIColor *turnArrowSideColor;
|
||
|
||
///是否显示牵引线,默认YES. since 6.2.0
|
||
@property (nonatomic, assign) BOOL showVectorline;
|
||
|
||
///是否显示红绿灯图标,默认YES. since 6.2.0
|
||
@property (nonatomic, assign) BOOL showTrafficLights;
|
||
|
||
///是否显示小车图标,默认YES. since 6.2.0
|
||
@property (nonatomic, assign) BOOL showCar;
|
||
|
||
///是否显示路线,默认YES. 注意：路线上的相关信息，如摄像头(showCamera)、红绿灯(showTrafficLights)、转向箭头(showTurnArrow)、牵引线(showVectorline)、起终点等也会一同受控制，进行显示和隐藏. since 6.2.0
|
||
@property (nonatomic, assign) BOOL showRoute;
|
||
|
||
///多路线导航模式下是否显示备选路线, 默认YES. since 6.7.0
|
||
@property (nonatomic, assign) BOOL showBackupRoute;
|
||
|
||
///走过的路线是否置灰,默认为NO. since 6.2.0
|
||
@property (nonatomic, assign) BOOL showGreyAfterPass;
|
||
|
||
///路线polyline的宽度,设置0恢复默认宽度
|
||
@property (nonatomic, assign) CGFloat lineWidth;
|
||
|
||
///自定义导航界面自车图标的弹出框view, 设置为nil取消弹框. 注意:弹框功能同MAAnnotationView的customCalloutView, 弹框不会触发 mapView:didAnnotationViewCalloutTapped: 方法. since 5.1.0
|
||
@property (nonatomic, strong, nullable) MACustomCalloutView *customCalloutView;
|
||
|
||
///路线虚线部分的颜色. since 6.2.0
|
||
@property (nonatomic, strong) UIColor *dashedLineColor;
|
||
|
||
// 路线走过后置灰的颜色 since 10.0.2
|
||
@property (nonatomic, strong) AMapNaviPolylineGreyColor *routeGreyColor;
|
||
|
||
///路线的路况颜色，根据AMapNaviRouteStatus配置不同道路状态的颜色 since 10.0.2
|
||
@property (nonatomic, copy) NSArray<AMapNaviPolylineTrafficStatusColor *> *routeStatusColor;
|
||
|
||
//设置自定义View是否显示鹰眼地图，默认为NO。显示鹰眼小地图的时候，光柱图和全览按钮隐藏。 特别注意：当前接口为收费接口，您如果申请试用或者正式应用都请通过工单系统提交商务合作类工单进行沟通 https://lbs.amap.com/。since 10.0.2
|
||
@property (nonatomic, assign) BOOL showEagleMap;
|
||
|
||
///是否显示电子眼的距离，默认为NO。since 10.0.2
|
||
@property (nonatomic, assign) BOOL showCameraDistance;
|
||
|
||
///是否显示超速脉冲，默认为NO。特别注意：当前接口为收费接口，您如果申请试用或者正式应用都请通过工单系统提交商务合作类工单进行沟通 https://lbs.amap.com/。since 10.0.2
|
||
@property (nonatomic, assign) BOOL showOverSpeedPulse;
|
||
|
||
///路线上是否显示拥堵气泡，默认YES。 since 10.0.5
|
||
@property (nonatomic, assign) BOOL showDriveCongestion;
|
||
|
||
///路线上是否显示红绿灯倒计时，开启付费权限时默认YES。特别注意：当前接口为收费接口，您如果申请试用或者正式应用都请通过工单系统提交商务合作类工单进行沟通 https://lbs.amap.com/。since 10.0.5
|
||
@property (nonatomic, assign) BOOL showTrafficLightView;
|
||
|
||
/**
|
||
* @brief 设置摄像头图标
|
||
* @param cameraImage 摄像头图标。
|
||
*/
|
||
- (void)setCameraImage:(nullable UIImage *)cameraImage;
|
||
|
||
/**
|
||
* @brief 设置路径起点图标
|
||
* @param startPointImage 起点图标,设置nil为默认图标
|
||
*/
|
||
- (void)setStartPointImage:(nullable UIImage *)startPointImage;
|
||
|
||
/**
|
||
* @brief 设置路径途经点图标
|
||
* @param wayPointImage 途经点图标,设置nil为默认图标
|
||
*/
|
||
- (void)setWayPointImage:(nullable UIImage *)wayPointImage;
|
||
|
||
/**
|
||
* @brief 设置路径终点图标
|
||
* @param endPointImage 终点图标,设置nil为默认图标
|
||
*/
|
||
- (void)setEndPointImage:(nullable UIImage *)endPointImage;
|
||
|
||
/**
|
||
* @brief 设置自车图标
|
||
* @param carImage 自车图标,设置nil为默认图标
|
||
*/
|
||
- (void)setCarImage:(nullable UIImage *)carImage;
|
||
|
||
/**
|
||
* @brief 设置自车罗盘图标
|
||
* @param carCompassImage 自车罗盘图标,设置nil为默认图标
|
||
*/
|
||
- (void)setCarCompassImage:(nullable UIImage *)carCompassImage;
|
||
|
||
/**
|
||
* @brief 在导航地图中添加自定义标注. since 6.2.0
|
||
* @param annotation 具体参考 AMapNaviCompositeCustomAnnotation .
|
||
*/
|
||
- (void)addCustomAnnotation:(AMapNaviCompositeCustomAnnotation *)annotation;
|
||
|
||
/**
|
||
* @brief 移除导航地图中的自定义标注. since 6.2.0
|
||
* @param annotation 具体参考 AMapNaviCompositeCustomAnnotation .
|
||
*/
|
||
- (void)removeCustomAnnotation:(AMapNaviCompositeCustomAnnotation *)annotation;
|
||
|
||
/**
|
||
* @brief 在导航地图中添加自定义overlay. since 6.7.0
|
||
* @param overlay 具体参考 官方Demo中 DriveViewWithCustomOverlayViewController .
|
||
*/
|
||
- (void)addCustomOverlay:(id <AMapNaviCompositeOverlay>_Nonnull)overlay;
|
||
|
||
/**
|
||
* @brief 移除导航地图中的自定义overlay. since 6.7.0
|
||
* @param overlay 具体参考 AMapNaviCompositeOverlay .
|
||
*/
|
||
- (void)removeCustomOverlay:(id <AMapNaviCompositeOverlay>_Nonnull)overlay;
|
||
|
||
#pragma mark - UI Element Options
|
||
|
||
///是否显示界面元素,默认YES
|
||
@property (nonatomic, assign) BOOL showUIElements;
|
||
|
||
///是否显示路口放大图，默认YES
|
||
@property (nonatomic, assign) BOOL showCrossImage;
|
||
|
||
///是否显示实时交通按钮,默认YES
|
||
@property (nonatomic, assign) BOOL showTrafficButton;
|
||
|
||
///是否显示路况光柱图,默认YES
|
||
@property (nonatomic, assign) BOOL showTrafficBar;
|
||
|
||
///是否显示全览按钮,默认YES
|
||
@property (nonatomic, assign) BOOL showBrowseRouteButton;
|
||
|
||
///是否显示更多按钮,默认YES
|
||
@property (nonatomic, assign) BOOL showMoreButton;
|
||
|
||
///光柱图位置。since 10.0.2
|
||
@property (nonatomic, assign) CGRect tmcRouteFrame;
|
||
|
||
///光柱图颜色，根据AMapNaviRouteStatus配置不同道路状态的颜色，AMapNaviRouteStatusUnknow 的可以不做配置。since 10.0.2
|
||
@property (nonatomic, copy) NSArray<AMapNaviTMCStatusColor *> *tmcRouteColor;
|
||
|
||
#pragma mark - Other
|
||
|
||
///目前是否为横屏状态. since 6.2.0 内部会自行监听 UIDeviceOrientationDidChange 进行横竖屏切换，无需再设置此值，但用户要自行保证 AMapNaviDriveView.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight，让 AMapNaviDriveView 能够跟着父View一起变化. 可通过回调 -driveView:didChangeOrientation: 获取横竖屏切换时机
|
||
@property (nonatomic, assign, readonly) BOOL isLandscape;
|
||
|
||
///当显示模式为非锁车模式时，是否在7秒后自动设置为锁车模式，默认为NO. since 5.3.0
|
||
@property (nonatomic, assign) BOOL autoSwitchShowModeToCarPositionLocked;
|
||
|
||
/**
|
||
* @brief 在全览状态下调用此函数能够让路线显示在可视区域内(排除EdgePadding后剩余的区域)，保证路线不被自定义界面元素遮挡. 比如showUIElements为NO时（自定义界面）横竖屏切换后，可以调用此函数. since 6.2.0
|
||
*/
|
||
- (void)updateRoutePolylineInTheVisualRangeWhenTheShowModeIsOverview;
|
||
|
||
@end
|
||
|
||
@protocol AMapNaviDriveViewDelegate <NSObject>
|
||
@optional
|
||
|
||
/**
|
||
* @brief 导航界面关闭按钮点击时的回调函数
|
||
* @param driveView 驾车导航界面
|
||
*/
|
||
- (void)driveViewCloseButtonClicked:(AMapNaviDriveView *)driveView;
|
||
|
||
/**
|
||
* @brief 导航界面更多按钮点击时的回调函数
|
||
* @param driveView 驾车导航界面
|
||
*/
|
||
- (void)driveViewMoreButtonClicked:(AMapNaviDriveView *)driveView;
|
||
|
||
/**
|
||
* @brief 导航界面转向指示View点击时的回调函数
|
||
* @param driveView 驾车导航界面
|
||
*/
|
||
- (void)driveViewTrunIndicatorViewTapped:(AMapNaviDriveView *)driveView;
|
||
|
||
/**
|
||
* @brief 导航界面显示模式改变后的回调函数
|
||
* @param driveView 驾车导航界面
|
||
* @param showMode 显示模式
|
||
*/
|
||
- (void)driveView:(AMapNaviDriveView *)driveView didChangeShowMode:(AMapNaviDriveViewShowMode)showMode;
|
||
|
||
/**
|
||
* @brief 驾车导航界面跟随模式改变后的回调函数. since 6.2.0
|
||
* @param driveView 驾车导航界面
|
||
* @param trackMode 跟随模式
|
||
*/
|
||
- (void)driveView:(AMapNaviDriveView *)driveView didChangeTrackingMode:(AMapNaviViewTrackingMode)trackMode;
|
||
|
||
/**
|
||
* @brief 驾车导航界面跟随模式改变动画执行完成的回调函数，可在此函数中设置地图状态。注意，只有在showMode为AMapNaviDriveViewShowModeNormal时才会回调。 since 10.0.2
|
||
* @param driveView 驾车导航界面
|
||
*/
|
||
- (void)driveViewTrackingModeAnimationFinished:(AMapNaviDriveView *)driveView;
|
||
|
||
/**
|
||
* @brief 驾车导航界面横竖屏切换后的回调函数. since 6.2.0
|
||
* @param driveView 驾车导航界面
|
||
* @param isLandscape 是否是横屏
|
||
*/
|
||
- (void)driveView:(AMapNaviDriveView *)driveView didChangeOrientation:(BOOL)isLandscape;
|
||
|
||
/**
|
||
* @brief 驾车导航界面白天黑夜模式切换后的回调函数. since 6.2.0
|
||
* @param driveView 驾车导航界面
|
||
* @param showStandardNightType 是否为黑夜模式
|
||
*/
|
||
- (void)driveView:(AMapNaviDriveView *)driveView didChangeDayNightType:(BOOL)showStandardNightType;
|
||
|
||
/**
|
||
* @brief 在showUIElements为NO时，驾车导航界面需要实时的取得可视区域，比如切换成全览时、横竖屏切换时、动态计算地图的缩放级别时. 注意：此回调只在showUIElements为NO时，才会调用且比较频繁，在获取EdgePadding时请勿进行大量的计算. since 6.2.0
|
||
* @param driveView 驾车导航界面
|
||
* @return 如(100, 50, 80, 60)表示的是：driveView.bounds 上边留出100px，左边留出50px，底部留出80px，右边留出60px后的区域为可视区域，一般EdgePadding的值由用户的界面布局决定.
|
||
*/
|
||
- (UIEdgeInsets)driveViewEdgePadding:(AMapNaviDriveView *)driveView;
|
||
|
||
@end
|
||
|
||
NS_ASSUME_NONNULL_END
|