高德地图SDK(导航)
V7.7.0
|
#import <MAMapView.h>
Instance Methods | |
(BOOL skyModelEnable) | - __attribute |
是否支持天空模式,默认为YES. 开启后,进入天空模式后,annotation重用可视范围会缩减 More... | |
(CGFloat trafficRatio) | - __attribute |
设置实时交通线宽系数,默认线宽系数为0.8,范围为0 - 1 More... | |
(void) | - setRegion:animated: |
设定当前地图的经纬度范围,该范围可能会被调整为适合地图窗口显示的范围 More... | |
(MACoordinateRegion) | - regionThatFits: |
根据当前地图视图frame的大小调整region范围 More... | |
(void) | - setVisibleMapRect:animated: |
设置可见区域 More... | |
(MAMapRect) | - mapRectThatFits: |
重新计算可见地图矩形区域,使之匹配mapview长宽比 More... | |
(MAMapRect) | - mapRectThatFits:edgePadding: |
根据边缘插入来调整地图矩形区域,使之匹配mapview加insets后的长宽比 More... | |
(void) | - setVisibleMapRect:edgePadding:animated: |
设置可见地图矩形区域 More... | |
(void) | - setCenterCoordinate:animated: |
设置当前地图的中心点,改变该值时,地图的比例尺级别不会发生变化 More... | |
(void) | - setZoomLevel:animated: |
设置缩放级别(默认3-19,有室内地图时为3-20) More... | |
(void) | - setZoomLevel:atPivot:animated: |
根据指定的枢纽点来缩放地图 More... | |
(void) | - setRotationDegree:animated:duration: |
设置地图旋转角度(逆时针为正向) More... | |
(void) | - setCameraDegree:animated:duration: |
设置地图相机角度(范围为[0.f, 60.f],但高于40度的角度需要在16级以上才能生效) More... | |
(MAMapStatus *) | - getMapStatus |
获取地图状态 More... | |
(void) | - setMapStatus:animated: |
设置地图状态 More... | |
(void) | - setMapStatus:animated:duration: |
设置地图状态 More... | |
(void) | - setCompassImage: |
设置指南针的图片 More... | |
(UIImage *) | - takeSnapshotInRect: |
在指定区域内截图(默认会包含该区域内的annotationView),注意不要在地图回调方法内直接调用 More... | |
(void) | - takeSnapshotInRect:withCompletionBlock: |
异步在指定区域内截图(默认会包含该区域内的annotationView), 地图载入完整时回调 More... | |
(double) | - metersPerPointForZoomLevel: |
在指定的缩放级别下, 基于地图中心点, 1 screen point 对应的距离(单位是米). More... | |
(CGPoint) | - convertCoordinate:toPointToView: |
将经纬度转换为指定view坐标系的坐标 More... | |
(CLLocationCoordinate2D) | - convertPoint:toCoordinateFromView: |
将指定view坐标系的坐标转换为经纬度 More... | |
(CGRect) | - convertRegion:toRectToView: |
将经纬度region转换为指定view坐标系的rect More... | |
(MACoordinateRegion) | - convertRect:toRegionFromView: |
将指定view坐标系的rect转换为经纬度region More... | |
(void) | - reloadMap |
重新加载地图 More... | |
(void) | - clearDisk |
清除所有磁盘上缓存的地图数据(不包括离线地图) More... | |
(void) | - reloadInternalTexture |
重新加载内部纹理,在纹理被错误释放时可以执行此方法。(since 5.4.0) More... | |
(NSString *) | - mapContentApprovalNumber |
获取地图审图号。如果启用了“自定义样式”功能(customMapStyleEnabled 为 YES),则返回nil。(since 5.4.0) More... | |
(NSString *) | - satelliteImageApprovalNumber |
获取卫星图片审图号。(since 5.4.0) More... | |
(void) | - addAnimationWith:zoomAnimation:rotateAnimation:cameraDegreeAnimation: |
添加CAKeyframeAnimation动画。(since 6.0.0) More... | |
(void) | - forceRefresh |
强制刷新。(since 6.0.0) More... | |
(void) | - setConstructingRoadEnable: |
设置在建道路图层是否显示。默认NO(since 7.7.0) More... | |
(void) | - addAnnotation: |
向地图窗口添加标注,需要实现MAMapViewDelegate的-mapView:viewForAnnotation:函数来生成标注对应的View More... | |
(void) | - addAnnotations: |
向地图窗口添加一组标注,需要实现MAMapViewDelegate的-mapView:viewForAnnotation:函数来生成标注对应的View More... | |
(void) | - removeAnnotation: |
移除标注 More... | |
(void) | - removeAnnotations: |
移除一组标注 More... | |
(NSSet *) | - annotationsInMapRect: |
获取指定投影矩形范围内的标注 More... | |
(MAAnnotationView *) | - viewForAnnotation: |
根据标注数据获取标注view More... | |
(MAAnnotationView *) | - dequeueReusableAnnotationViewWithIdentifier: |
从复用内存池中获取制定复用标识的annotation view More... | |
(void) | - selectAnnotation:animated: |
选中标注数据对应的view。注意:如果annotation对应的annotationView因不在屏幕范围内而被移入复用池,为了完成选中操作,会将对应的annotationView添加到地图上,并将地图中心点移至annotation.coordinate的位置。 More... | |
(void) | - deselectAnnotation:animated: |
取消选中标注数据对应的view More... | |
(void) | - showAnnotations:animated: |
设置地图使其可以显示数组中所有的annotation, 如果数组中只有一个则直接设置地图中心为annotation的位置。 More... | |
(void) | - showAnnotations:edgePadding:animated: |
设置地图使其可以显示数组中所有的annotation, 如果数组中只有一个则直接设置地图中心为annotation的位置。 More... | |
(void) | - setCustomMapStyleWithWebData: |
根据web导出数据设置地图样式, 目前仅支持自定义标准类型. 默认不生效,调用customMapStyleEnabled=YES使生效. since 5.2.0 More... | |
(void) | - setCustomTextureResourcePath: |
设置自定义纹理. since 5.7.0 More... | |
(void) | - setCustomMapStyleID: |
自定义地图样式id, 官网发布后下次开启自定义样式便可生效,目前仅支持自定义标准类型. 默认不生效,调用customMapStyleEnabled=YES使生效. since 6.0.0 More... | |
(void) | - setCustomMapStyleOptions: |
自定义地图样式设置,可以支持分级样式配置,如控制不同级别显示不同的颜色(自7.0.0开始样式有更新,旧的样式文件不能继续使用,必须到官网重新导出新样式文件。 自6.6.0开始使用新版样式,旧版样式无法在新版接口setCustomMapStyleOptions:(MAMapCustomStyleOptions *)styleOptions中使用,请到官网(lbs.amap.com)更新新版样式文件.) More... | |
(void) | - setIndoorMapControlOrigin: |
设置默认室内地图控件位置 More... | |
(void) | - setCurrentIndoorMapFloorIndex: |
设置当前室内地图楼层数 More... | |
(void) | - clearIndoorMapCache |
清空室内地图缓存 More... | |
(NSArray *) | - overlaysInLevel: |
取位于level下的overlays More... | |
(void) | - addOverlay: |
向地图窗口添加Overlay。 需要实现MAMapViewDelegate的-mapView:rendererForOverlay:函数来生成标注对应的Renderer。 默认添加层级:MAGroundOverlay默认层级为MAOverlayLevelAboveRoads,其余overlay类型默认层级为MAOverlayLevelAboveLabels More... | |
(void) | - addOverlays: |
向地图窗口添加一组Overlay,需要实现MAMapViewDelegate的-mapView:rendererForOverlay:函数来生成标注对应的Renderer 默认添加层级:MAOverlayLevelAboveLabels More... | |
(void) | - addOverlay:level: |
向地图窗口添加Overlay,需要实现MAMapViewDelegate的-mapView:rendererForOverlay:函数来生成标注对应的Renderer More... | |
(void) | - addOverlays:level: |
向地图窗口添加一组Overlay,需要实现MAMapViewDelegate的-mapView:rendererForOverlay:函数来生成标注对应的Renderer More... | |
(void) | - removeOverlay: |
移除Overlay More... | |
(void) | - removeOverlays: |
移除一组Overlay More... | |
(void) | - insertOverlay:atIndex:level: |
在指定层级的指定的索引处添加一个Overlay More... | |
(void) | - insertOverlay:aboveOverlay: |
在指定的Overlay之上插入一个overlay More... | |
(void) | - insertOverlay:belowOverlay: |
在指定的Overlay之下插入一个overlay More... | |
(void) | - insertOverlay:atIndex: |
在指定的索引处添加一个Overlay More... | |
(void) | - exchangeOverlayAtIndex:withOverlayAtIndex: |
在MAOverlayLevelAboveLabels上交换指定索引处的Overlay More... | |
(void) | - exchangeOverlayAtIndex:withOverlayAtIndex:atLevel: |
交换指定索引处的Overlay More... | |
(void) | - exchangeOverlay:withOverlay: |
交换两个overlay More... | |
(MAOverlayRenderer *) | - rendererForOverlay: |
查找指定overlay对应的Renderer,如果该View尚未创建,返回nil More... | |
(void) | - showOverlays:animated: |
设置地图使其可以显示数组中所有的overlay, 如果数组中只有一个则直接设置地图中心为overlay的位置。 More... | |
(void) | - showOverlays:edgePadding:animated: |
设置地图使其可以显示数组中所有的overlay, 如果数组中只有一个则直接设置地图中心为overlay的位置。 More... | |
(NSArray *) | - getHittedPolylinesWith:traverseAll: |
获取点击选中的polylineRenderer, 注意:开启polylineRenderer的点击选中功能,需设置userInteractionEnabled=YES。since 7.1.0 More... | |
(void) | - setUserTrackingMode:animated: |
设置定位用户位置的模式 More... | |
(void) | - updateUserLocationRepresentation: |
设定UserLocationView样式。如果用户自定义了userlocation的annotationView,或者该annotationView还未添加到地图上,此方法将不起作用 More... | |
Properties | |
id< MAMapViewDelegate > | delegate |
地图view的delegate More... | |
MAMapType | mapType |
地图类型 More... | |
CLLocationCoordinate2D | centerCoordinate |
当前地图的中心点,改变该值时,地图的比例尺级别不会发生变化 More... | |
MACoordinateRegion | region |
当前地图的经纬度范围,设定的该范围可能会被调整为适合地图窗口显示的范围 More... | |
MAMapRect | visibleMapRect |
可见区域, 设定的该范围可能会被调整为适合地图窗口显示的范围 More... | |
MACoordinateRegion | limitRegion |
设置可见地图区域的矩形边界,如限制地图只显示北京市范围 More... | |
MAMapRect | limitMapRect |
设置可见地图区域的矩形边界,如限制地图只显示北京市范围 More... | |
CGFloat | zoomLevel |
缩放级别(默认3-19,有室内地图时为3-20) More... | |
CGFloat | minZoomLevel |
最小缩放级别 More... | |
CGFloat | maxZoomLevel |
最大缩放级别(有室内地图时最大为20,否则为19) More... | |
CGFloat | rotationDegree |
设置地图旋转角度(逆时针为正向) More... | |
CGFloat | cameraDegree |
设置地图相机角度(范围为[0.f, 60.f],但高于40度的角度需要在16级以上才能生效) More... | |
BOOL | zoomingInPivotsAroundAnchorPoint |
是否以screenAnchor点作为锚点进行缩放,默认为YES。如果为NO,则以手势中心点作为锚点 More... | |
BOOL | zoomEnabled |
是否支持缩放, 默认YES More... | |
BOOL | scrollEnabled |
是否支持平移, 默认YES More... | |
BOOL | rotateEnabled |
是否支持旋转, 默认YES More... | |
BOOL | rotateCameraEnabled |
是否支持camera旋转, 默认YES More... | |
BOOL | showsBuildings |
是否显示楼块,默认为YES More... | |
BOOL | showsLabels |
是否显示底图标注, 默认为YES More... | |
BOOL | showTraffic |
是否显示交通路况图层, 默认为NO More... | |
NSDictionary< NSNumber *, UIColor * > * | trafficStatus |
设置实时交通颜色,key为 MATrafficStatus More... | |
BOOL | touchPOIEnabled |
是否支持单击地图获取POI信息(默认为YES), 对应的回调是 -(void)mapView:(MAMapView *) didTouchPois:(NSArray *) More... | |
BOOL | showsCompass |
是否显示指南针, 默认YES More... | |
CGPoint | compassOrigin |
指南针原点位置 More... | |
CGSize | compassSize |
指南针的宽高 More... | |
BOOL | showsScale |
是否显示比例尺, 默认YES More... | |
CGPoint | scaleOrigin |
比例尺原点位置 More... | |
CGSize | scaleSize |
比例尺的最大宽高 More... | |
CGPoint | logoCenter |
logo位置, 必须在mapView.bounds之内,否则会被忽略 More... | |
CGSize | logoSize |
logo的宽高 More... | |
double | metersPerPointForCurrentZoom |
在当前缩放级别下, 基于地图中心点, 1 screen point 对应的距离(单位是米) More... | |
BOOL | isAbroad |
标识当前地图中心位置是否在中国范围外。此属性不是精确判断,不能用于边界区域 More... | |
NSUInteger | maxRenderFrame |
最大帧数,有效的帧数为:60、30、20、10等能被60整除的数。默认为60 More... | |
BOOL | isAllowDecreaseFrame |
是否允许降帧,默认为YES More... | |
BOOL | openGLESDisabled |
停止/开启 OpenGLES绘制, 默认NO. 对应回调是 - (void)mapView:(MAMapView *) didChangeOpenGLESDisabled:(BOOL) More... | |
CGPoint | screenAnchor |
地图的视图锚点。坐标系归一化,(0, 0)为MAMapView左上角,(1, 1)为右下角。默认为(0.5, 0.5),即当前地图的视图中心 (since 5.0.0) More... | |
NSRunLoopMode | runLoopMode |
地图渲染的runloop mode,默认为NSRunLoopCommonModes。如果是和UIScrollView一起使用且不希望地图在scrollView拖动时渲染,请设置此值为NSDefaultRunLoopMode。(since 5.1.0) More... | |
NSNumber * | showsWorldMap |
是否显示海外地图,默认为@NO. 注意:必须先在官网申请开通海外权限 More... | |
NSNumber * | mapLanguage |
设置语言。中文:@0: 英文:@1. 英文使用注意事项:1、不能和自定义地图样式同时使用;2、英文状态只在MAMapTypeStandard生效 More... | |
NSArray * | annotations |
所有添加的标注, 注意从5.3.0开始返回数组内不再包含定位蓝点userLocation More... | |
NSArray * | selectedAnnotations |
处于选中状态的标注数据数据(其count == 0 或 1) More... | |
CGRect | annotationVisibleRect |
annotation 可见区域 More... | |
BOOL | customMapStyleEnabled |
是否开启自定义样式, 默认NO. since 5.0.0 More... | |
BOOL | showsIndoorMap |
是否显示室内地图, 默认NO More... | |
BOOL | showsIndoorMapControl |
是否显示室内地图默认控件, 默认YES More... | |
CGSize | indoorMapControlSize |
默认室内地图控件的最大宽高 More... | |
NSArray * | overlays |
所有添加的Overlay More... | |
BOOL | showsUserLocation |
是否显示用户位置 More... | |
MAUserLocation * | userLocation |
当前的位置数据 More... | |
BOOL | customizeUserLocationAccuracyCircleRepresentation |
是否自定义用户位置精度圈(userLocationAccuracyCircle)对应的 view, 默认为 NO. 如果为YES: 会调用 - (MAOverlayRenderer *)mapView (MAMapView *)mapView rendererForOverlay: (MAMapView(Overlay))overlay 若返回nil, 则不加载. 如果为NO : 会使用默认的样式. More... | |
MACircle * | userLocationAccuracyCircle |
用户位置精度圈 对应的overlay More... | |
MAUserTrackingMode | userTrackingMode |
定位用户位置的模式, 注意:在follow模式下,设置地图中心点、设置可见区域、滑动手势、选择annotation操作会取消follow模式,并触发 - (void)mapView:(MAMapView *)mapView didChangeUserTrackingMode:(MAUserTrackingMode)mode animated:(BOOL)animated; More... | |
BOOL | userLocationVisible |
当前位置再地图中是否可见 More... | |
CLLocationDistance | distanceFilter |
设定定位的最小更新距离。默认为kCLDistanceFilterNone,会提示任何移动 More... | |
CLLocationAccuracy | desiredAccuracy |
设定定位精度。默认为kCLLocationAccuracyBest More... | |
CLLocationDegrees | headingFilter |
设定最小更新角度。默认为1度,设定为kCLHeadingFilterNone会提示任何角度改变 More... | |
BOOL | pausesLocationUpdatesAutomatically |
指定定位是否会被系统自动暂停 More... | |
BOOL | allowsBackgroundLocationUpdates |
是否允许后台定位。默认为NO。只在iOS 9.0之后起作用。 设置为YES的时候必须保证 Background Modes 中的 Location updates处于选中状态,否则会抛出异常。 注意:定位必须在停止的状态下设置(showsUserLocation = NO),否则无效 More... | |
- (BOOL skyModelEnable) __attribute | ((deprecated("已废弃 since 6.0.0"))) |
是否支持天空模式,默认为YES. 开启后,进入天空模式后,annotation重用可视范围会缩减
Provided by category MAMapView(Annotation).
- (CGFloat trafficRatio) __attribute | ((deprecated("已废弃 since 6.0.0, 不再支持修改实时交通线宽"))) |
设置实时交通线宽系数,默认线宽系数为0.8,范围为0 - 1
- (void) addAnimationWith: | (CAKeyframeAnimation *) | mapCenterAnimation | |
zoomAnimation: | (CAKeyframeAnimation *) | zoomAnimation | |
rotateAnimation: | (CAKeyframeAnimation *) | rotateAnimation | |
cameraDegreeAnimation: | (CAKeyframeAnimation *) | cameraDegreeAnimation | |
添加CAKeyframeAnimation动画。(since 6.0.0)
mapCenterAnimation | 地图中心点动画 |
zoomAnimation | 放大缩小动画 |
rotateAnimation | 旋转动画 |
cameraDegreeAnimation | 仰角动画 |
- (void) addAnnotation: | (id< MAAnnotation >) | annotation |
向地图窗口添加标注,需要实现MAMapViewDelegate的-mapView:viewForAnnotation:函数来生成标注对应的View
annotation | 要添加的标注 |
Provided by category MAMapView(Annotation).
- (void) addAnnotations: | (NSArray *) | annotations |
向地图窗口添加一组标注,需要实现MAMapViewDelegate的-mapView:viewForAnnotation:函数来生成标注对应的View
annotations | 要添加的标注数组 |
Provided by category MAMapView(Annotation).
- (void) addOverlay: | (id< MAOverlay >) | overlay |
向地图窗口添加Overlay。 需要实现MAMapViewDelegate的-mapView:rendererForOverlay:函数来生成标注对应的Renderer。 默认添加层级:MAGroundOverlay默认层级为MAOverlayLevelAboveRoads,其余overlay类型默认层级为MAOverlayLevelAboveLabels
overlay | 要添加的overlay |
Provided by category MAMapView(Overlay).
- (void) addOverlay: | (id< MAOverlay >) | overlay | |
level: | (MAOverlayLevel) | level | |
向地图窗口添加Overlay,需要实现MAMapViewDelegate的-mapView:rendererForOverlay:函数来生成标注对应的Renderer
overlay | 要添加的overlay |
level | 添加的overlay所在层级 |
Provided by category MAMapView(Overlay).
- (void) addOverlays: | (NSArray *) | overlays |
向地图窗口添加一组Overlay,需要实现MAMapViewDelegate的-mapView:rendererForOverlay:函数来生成标注对应的Renderer 默认添加层级:MAOverlayLevelAboveLabels
overlays | 要添加的overlay数组 |
Provided by category MAMapView(Overlay).
- (void) addOverlays: | (NSArray *) | overlays | |
level: | (MAOverlayLevel) | level | |
向地图窗口添加一组Overlay,需要实现MAMapViewDelegate的-mapView:rendererForOverlay:函数来生成标注对应的Renderer
overlays | 要添加的overlay数组 |
level | 添加的overlay所在层级 |
Provided by category MAMapView(Overlay).
- (NSSet *) annotationsInMapRect: | (MAMapRect) | mapRect |
- (void) clearDisk |
清除所有磁盘上缓存的地图数据(不包括离线地图)
- (void) clearIndoorMapCache |
清空室内地图缓存
Provided by category MAMapView(Indoor).
- (CGPoint) convertCoordinate: | (CLLocationCoordinate2D) | coordinate | |
toPointToView: | (UIView *) | view | |
将经纬度转换为指定view坐标系的坐标
coordinate | 经纬度 |
view | 指定的view |
- (CLLocationCoordinate2D) convertPoint: | (CGPoint) | point | |
toCoordinateFromView: | (UIView *) | view | |
将指定view坐标系的坐标转换为经纬度
point | 指定view坐标系的坐标 |
view | 指定的view |
- (MACoordinateRegion) convertRect: | (CGRect) | rect | |
toRegionFromView: | (UIView *) | view | |
将指定view坐标系的rect转换为经纬度region
rect | 指定view坐标系的rect |
view | 指定的view |
- (CGRect) convertRegion: | (MACoordinateRegion) | region | |
toRectToView: | (UIView *) | view | |
将经纬度region转换为指定view坐标系的rect
region | 经纬度region |
view | 指定的view |
- (MAAnnotationView *) dequeueReusableAnnotationViewWithIdentifier: | (NSString *) | identifier |
从复用内存池中获取制定复用标识的annotation view
identifier | 复用标识 |
Provided by category MAMapView(Annotation).
- (void) deselectAnnotation: | (id< MAAnnotation >) | annotation | |
animated: | (BOOL) | animated | |
取消选中标注数据对应的view
annotation | 标注数据 |
animated | 是否有动画效果 |
Provided by category MAMapView(Annotation).
- (void) exchangeOverlayAtIndex: | (NSUInteger) | index1 | |
withOverlayAtIndex: | (NSUInteger) | index2 | |
在MAOverlayLevelAboveLabels上交换指定索引处的Overlay
index1 | 索引1 |
index2 | 索引2 |
Provided by category MAMapView(Overlay).
- (void) exchangeOverlayAtIndex: | (NSUInteger) | index1 | |
withOverlayAtIndex: | (NSUInteger) | index2 | |
atLevel: | (MAOverlayLevel) | level | |
- (void) forceRefresh |
强制刷新。(since 6.0.0)
- (NSArray*) getHittedPolylinesWith: | (CLLocationCoordinate2D) | tappedCoord | |
traverseAll: | (BOOL) | traverseAll | |
获取点击选中的polylineRenderer, 注意:开启polylineRenderer的点击选中功能,需设置userInteractionEnabled=YES。since 7.1.0
tappedCoord | 点击点的坐标 |
traverseAll | 如果有polyline重合情况,是否返回多个。NO: 只返回最上面的 YES:返回所有 |
Provided by category MAMapView(Overlay).
- (MAMapStatus *) getMapStatus |
获取地图状态
在指定的Overlay之上插入一个overlay
overlay | 带添加的Overlay |
sibling | 用于指定相对位置的Overlay |
Provided by category MAMapView(Overlay).
- (void) insertOverlay: | (id< MAOverlay >) | overlay | |
atIndex: | (NSUInteger) | index | |
在指定的索引处添加一个Overlay
overlay | 要添加的overlay |
index | 指定的索引 |
Provided by category MAMapView(Overlay).
- (void) insertOverlay: | (id< MAOverlay >) | overlay | |
atIndex: | (NSUInteger) | index | |
level: | (MAOverlayLevel) | level | |
在指定层级的指定的索引处添加一个Overlay
overlay | 要添加的overlay |
index | 指定的索引 |
level | 指定的层级 |
注:各个层级的索引分开计数; 若index大于level层级的最大索引,则添加至level层级的最大索引之后。
Provided by category MAMapView(Overlay).
在指定的Overlay之下插入一个overlay
overlay | 带添加的Overlay |
sibling | 用于指定相对位置的Overlay |
Provided by category MAMapView(Overlay).
- (NSString *) mapContentApprovalNumber |
获取地图审图号。如果启用了“自定义样式”功能(customMapStyleEnabled 为 YES),则返回nil。(since 5.4.0)
重新计算可见地图矩形区域,使之匹配mapview长宽比
mapRect | 要调整的地图矩形区域 |
- (MAMapRect) mapRectThatFits: | (MAMapRect) | mapRect | |
edgePadding: | (UIEdgeInsets) | insets | |
根据边缘插入来调整地图矩形区域,使之匹配mapview加insets后的长宽比
mapRect | 要调整的地图矩形区域 |
insets | 边缘插入 |
- (double) metersPerPointForZoomLevel: | (CGFloat) | zoomLevel |
在指定的缩放级别下, 基于地图中心点, 1 screen point 对应的距离(单位是米).
zoomLevel | 指定的缩放级别, 在[minZoomLevel, maxZoomLevel]范围内. |
- (NSArray *) overlaysInLevel: | (MAOverlayLevel) | level |
- (MACoordinateRegion) regionThatFits: | (MACoordinateRegion) | region |
根据当前地图视图frame的大小调整region范围
region | 要调整的经纬度范围 |
- (void) reloadInternalTexture |
重新加载内部纹理,在纹理被错误释放时可以执行此方法。(since 5.4.0)
- (void) reloadMap |
重新加载地图
将离线地图解压到 Documents/3dvmap/ 目录下后,调用此函数使离线数据生效, 对应的回调分别是 offlineDataWillReload:(MAMapView *)mapView, offlineDataDidReload:(MAMapView *)mapView.
- (void) removeAnnotation: | (id< MAAnnotation >) | annotation |
- (void) removeAnnotations: | (NSArray *) | annotations |
- (void) removeOverlay: | (id< MAOverlay >) | overlay |
- (void) removeOverlays: | (NSArray *) | overlays |
- (MAOverlayRenderer *) rendererForOverlay: | (id< MAOverlay >) | overlay |
查找指定overlay对应的Renderer,如果该View尚未创建,返回nil
overlay | 指定的overlay |
Provided by category MAMapView(Overlay).
- (NSString *) satelliteImageApprovalNumber |
获取卫星图片审图号。(since 5.4.0)
- (void) selectAnnotation: | (id< MAAnnotation >) | annotation | |
animated: | (BOOL) | animated | |
选中标注数据对应的view。注意:如果annotation对应的annotationView因不在屏幕范围内而被移入复用池,为了完成选中操作,会将对应的annotationView添加到地图上,并将地图中心点移至annotation.coordinate的位置。
annotation | 标注数据 |
animated | 是否有动画效果 |
Provided by category MAMapView(Annotation).
- (void) setCameraDegree: | (CGFloat) | cameraDegree | |
animated: | (BOOL) | animated | |
duration: | (CFTimeInterval) | duration | |
设置地图相机角度(范围为[0.f, 60.f],但高于40度的角度需要在16级以上才能生效)
cameraDegree | 要设置的相机角度 |
animated | 是否动画 |
duration | 动画时间 |
- (void) setCenterCoordinate: | (CLLocationCoordinate2D) | coordinate | |
animated: | (BOOL) | animated | |
设置当前地图的中心点,改变该值时,地图的比例尺级别不会发生变化
coordinate | 要设置的中心点 |
animated | 是否动画设置 |
- (void) setCompassImage: | (UIImage *) | image |
设置指南针的图片
image | 新的指南针图片 |
- (void) setConstructingRoadEnable: | (BOOL) | enabled |
设置在建道路图层是否显示。默认NO(since 7.7.0)
enabled | 是否显示 |
- (void) setCurrentIndoorMapFloorIndex: | (NSInteger) | floorIndex |
- (void) setCustomMapStyleID: | ((deprecated("已废弃, 请使用 setCustomMapStyleOptions: since 6.6.0"))) | __attribute |
自定义地图样式id, 官网发布后下次开启自定义样式便可生效,目前仅支持自定义标准类型. 默认不生效,调用customMapStyleEnabled=YES使生效. since 6.0.0
customMapStyleID | 自定义样式ID,从官网获取 |
Provided by category MAMapView(CustomMapStyle).
- (void) setCustomMapStyleOptions: | (MAMapCustomStyleOptions *) | styleOptions |
自定义地图样式设置,可以支持分级样式配置,如控制不同级别显示不同的颜色(自7.0.0开始样式有更新,旧的样式文件不能继续使用,必须到官网重新导出新样式文件。 自6.6.0开始使用新版样式,旧版样式无法在新版接口setCustomMapStyleOptions:(MAMapCustomStyleOptions *)styleOptions中使用,请到官网(lbs.amap.com)更新新版样式文件.)
styleOptions | 自定义样式options. since 6.6.0 |
Provided by category MAMapView(CustomMapStyle).
- (void) setCustomMapStyleWithWebData: | ((deprecated("已废弃, 请使用 setCustomMapStyleOptions: since 6.6.0"))) | __attribute |
根据web导出数据设置地图样式, 目前仅支持自定义标准类型. 默认不生效,调用customMapStyleEnabled=YES使生效. since 5.2.0
data | 高德web端工具导出的地图样式数据. |
Provided by category MAMapView(CustomMapStyle).
- (void) setCustomTextureResourcePath: | ((deprecated("已废弃, 请使用 setCustomMapStyleOptions: since 6.6.0"))) | __attribute |
设置自定义纹理. since 5.7.0
customTextureResourcePath | 自定义纹理文件路径. |
Provided by category MAMapView(CustomMapStyle).
- (void) setIndoorMapControlOrigin: | (CGPoint) | origin |
- (void) setMapStatus: | (MAMapStatus *) | status | |
animated: | (BOOL) | animated | |
设置地图状态
status | 要设置的地图状态 |
animated | 是否动画 |
- (void) setMapStatus: | (MAMapStatus *) | status | |
animated: | (BOOL) | animated | |
duration: | (CFTimeInterval) | duration | |
设置地图状态
status | 要设置的地图状态 |
animated | 是否动画 |
duration | 动画时间,默认动画时间为0.35s |
- (void) setRegion: | (MACoordinateRegion) | region | |
animated: | (BOOL) | animated | |
设定当前地图的经纬度范围,该范围可能会被调整为适合地图窗口显示的范围
region | 要设定的经纬度范围 |
animated | 是否动画设置 |
- (void) setRotationDegree: | (CGFloat) | rotationDegree | |
animated: | (BOOL) | animated | |
duration: | (CFTimeInterval) | duration | |
设置地图旋转角度(逆时针为正向)
rotationDegree | 旋转角度, 如当前角度是0,720表示逆时针旋转2周,-720表示正时针旋转2周 |
animated | 动画 |
duration | 动画时间 |
- (void) setUserTrackingMode: | (MAUserTrackingMode) | mode | |
animated: | (BOOL) | animated | |
- (void) setVisibleMapRect: | (MAMapRect) | mapRect | |
animated: | (BOOL) | animated | |
设置可见区域
mapRect | 要设定的可见区域 |
animated | 是否动画设置 |
- (void) setVisibleMapRect: | (MAMapRect) | mapRect | |
edgePadding: | (UIEdgeInsets) | insets | |
animated: | (BOOL) | animated | |
设置可见地图矩形区域
insets | 边缘插入 |
mapRect | 要显示的地图矩形区域 |
animated | 是否动画效果 |
- (void) setZoomLevel: | (CGFloat) | zoomLevel | |
animated: | (BOOL) | animated | |
设置缩放级别(默认3-19,有室内地图时为3-20)
zoomLevel | 要设置的缩放级别 |
animated | 是否动画设置 |
- (void) setZoomLevel: | (CGFloat) | zoomLevel | |
atPivot: | (CGPoint) | pivot | |
animated: | (BOOL) | animated | |
根据指定的枢纽点来缩放地图
zoomLevel | 缩放级别 |
pivot | 枢纽点(基于地图view的坐标系) |
animated | 是否动画 |
- (void) showAnnotations: | (NSArray *) | annotations | |
animated: | (BOOL) | animated | |
设置地图使其可以显示数组中所有的annotation, 如果数组中只有一个则直接设置地图中心为annotation的位置。
annotations | 需要显示的annotation |
animated | 是否执行动画 |
Provided by category MAMapView(Annotation).
- (void) showAnnotations: | (NSArray *) | annotations | |
edgePadding: | (UIEdgeInsets) | insets | |
animated: | (BOOL) | animated | |
设置地图使其可以显示数组中所有的annotation, 如果数组中只有一个则直接设置地图中心为annotation的位置。
annotations | 需要显示的annotation |
insets | insets 嵌入边界 |
animated | 是否执行动画 |
Provided by category MAMapView(Annotation).
- (void) showOverlays: | (NSArray *) | overlays | |
animated: | (BOOL) | animated | |
设置地图使其可以显示数组中所有的overlay, 如果数组中只有一个则直接设置地图中心为overlay的位置。
overlays | 需要显示的overlays |
animated | 是否执行动画 |
Provided by category MAMapView(Overlay).
- (void) showOverlays: | (NSArray *) | overlays | |
edgePadding: | (UIEdgeInsets) | insets | |
animated: | (BOOL) | animated | |
设置地图使其可以显示数组中所有的overlay, 如果数组中只有一个则直接设置地图中心为overlay的位置。
overlays | 需要显示的overlays |
insets | insets 嵌入边界 |
animated | 是否执行动画 |
Provided by category MAMapView(Overlay).
- (UIImage *) takeSnapshotInRect: | ((deprecated("已废弃,请使用takeSnapshotInRect:withCompletionBlock:方法 since 6.0.0"))) | __attribute |
在指定区域内截图(默认会包含该区域内的annotationView),注意不要在地图回调方法内直接调用
rect | 指定的区域 |
- (void) takeSnapshotInRect: | (CGRect) | rect | |
withCompletionBlock: | (void(^)(UIImage *resultImage, NSInteger state)) | block | |
异步在指定区域内截图(默认会包含该区域内的annotationView), 地图载入完整时回调
rect | 指定的区域 |
block | 回调block(resultImage:返回的图片,state:0载入不完整,1完整) |
- (void) updateUserLocationRepresentation: | (MAUserLocationRepresentation *) | representation |
设定UserLocationView样式。如果用户自定义了userlocation的annotationView,或者该annotationView还未添加到地图上,此方法将不起作用
representation | 样式信息对象 |
Provided by category MAMapView(UserLocation).
- (MAAnnotationView *) viewForAnnotation: | (id< MAAnnotation >) | annotation |
根据标注数据获取标注view
annotation | 标注数据 |
Provided by category MAMapView(Annotation).
|
readwritenonatomicassign |
是否允许后台定位。默认为NO。只在iOS 9.0之后起作用。
设置为YES的时候必须保证 Background Modes 中的 Location updates处于选中状态,否则会抛出异常。
注意:定位必须在停止的状态下设置(showsUserLocation = NO),否则无效
Provided by category MAMapView(UserLocation).
|
readnonatomicassign |
所有添加的标注, 注意从5.3.0开始返回数组内不再包含定位蓝点userLocation
Provided by category MAMapView(Annotation).
|
readnonatomicassign |
annotation 可见区域
Provided by category MAMapView(Annotation).
|
readwritenonatomicassign |
设置地图相机角度(范围为[0.f, 60.f],但高于40度的角度需要在16级以上才能生效)
|
readwritenonatomicassign |
当前地图的中心点,改变该值时,地图的比例尺级别不会发生变化
|
readwritenonatomicassign |
指南针原点位置
|
readnonatomicassign |
指南针的宽高
|
readwritenonatomicassign |
是否自定义用户位置精度圈(userLocationAccuracyCircle)对应的 view, 默认为 NO.
如果为YES: 会调用 - (MAOverlayRenderer *)mapView (MAMapView *)mapView rendererForOverlay: (MAMapView(Overlay))overlay 若返回nil, 则不加载.
如果为NO : 会使用默认的样式.
Provided by category MAMapView(UserLocation).
|
readwritenonatomicassign |
是否开启自定义样式, 默认NO. since 5.0.0
Provided by category MAMapView(CustomMapStyle).
|
readwritenonatomicweak |
地图view的delegate
|
readwritenonatomicassign |
设定定位精度。默认为kCLLocationAccuracyBest
Provided by category MAMapView(UserLocation).
|
readwritenonatomicassign |
设定定位的最小更新距离。默认为kCLDistanceFilterNone,会提示任何移动
Provided by category MAMapView(UserLocation).
|
readwritenonatomicassign |
设定最小更新角度。默认为1度,设定为kCLHeadingFilterNone会提示任何角度改变
Provided by category MAMapView(UserLocation).
|
readnonatomicassign |
默认室内地图控件的最大宽高
Provided by category MAMapView(Indoor).
|
readnonatomicassign |
标识当前地图中心位置是否在中国范围外。此属性不是精确判断,不能用于边界区域
|
readwritenonatomicassign |
是否允许降帧,默认为YES
|
readwritenonatomicassign |
设置可见地图区域的矩形边界,如限制地图只显示北京市范围
|
readwritenonatomicassign |
设置可见地图区域的矩形边界,如限制地图只显示北京市范围
|
readwritenonatomicassign |
logo位置, 必须在mapView.bounds之内,否则会被忽略
|
readnonatomicassign |
logo的宽高
|
readwritenonatomicstrong |
设置语言。中文:@0: 英文:@1. 英文使用注意事项:1、不能和自定义地图样式同时使用;2、英文状态只在MAMapTypeStandard生效
|
readwritenonatomicassign |
地图类型
|
readwritenonatomicassign |
最大帧数,有效的帧数为:60、30、20、10等能被60整除的数。默认为60
|
readwritenonatomicassign |
最大缩放级别(有室内地图时最大为20,否则为19)
|
readnonatomicassign |
在当前缩放级别下, 基于地图中心点, 1 screen point 对应的距离(单位是米)
|
readwritenonatomicassign |
最小缩放级别
|
readwritenonatomicassign |
停止/开启 OpenGLES绘制, 默认NO. 对应回调是 - (void)mapView:(MAMapView *) didChangeOpenGLESDisabled:(BOOL)
|
readnonatomicassign |
所有添加的Overlay
Provided by category MAMapView(Overlay).
|
readwritenonatomicassign |
指定定位是否会被系统自动暂停
Provided by category MAMapView(UserLocation).
|
readwritenonatomicassign |
当前地图的经纬度范围,设定的该范围可能会被调整为适合地图窗口显示的范围
|
readwritenonatomicassign |
是否支持camera旋转, 默认YES
|
readwritenonatomicassign |
是否支持旋转, 默认YES
|
readwritenonatomicassign |
设置地图旋转角度(逆时针为正向)
|
readwritenonatomiccopy |
地图渲染的runloop mode,默认为NSRunLoopCommonModes。如果是和UIScrollView一起使用且不希望地图在scrollView拖动时渲染,请设置此值为NSDefaultRunLoopMode。(since 5.1.0)
|
readwritenonatomicassign |
比例尺原点位置
|
readnonatomicassign |
比例尺的最大宽高
|
readwritenonatomicassign |
地图的视图锚点。坐标系归一化,(0, 0)为MAMapView左上角,(1, 1)为右下角。默认为(0.5, 0.5),即当前地图的视图中心 (since 5.0.0)
|
readwritenonatomicassign |
是否支持平移, 默认YES
|
readwritenonatomiccopy |
处于选中状态的标注数据数据(其count == 0 或 1)
Provided by category MAMapView(Annotation).
|
readwritenonatomicassign |
是否显示楼块,默认为YES
|
readwritenonatomicassign |
是否显示指南针, 默认YES
|
readwritenonatomicassign |
是否显示室内地图, 默认NO
Provided by category MAMapView(Indoor).
|
readwritenonatomicassign |
是否显示室内地图默认控件, 默认YES
Provided by category MAMapView(Indoor).
|
readwritenonatomicassign |
是否显示底图标注, 默认为YES
|
readwritenonatomicassign |
是否显示比例尺, 默认YES
|
readwritenonatomicassign |
是否显示用户位置
Provided by category MAMapView(UserLocation).
|
readwritenonatomicassign |
是否显示海外地图,默认为@NO. 注意:必须先在官网申请开通海外权限
|
readwritenonatomicassign |
是否显示交通路况图层, 默认为NO
|
readwritenonatomicassign |
是否支持单击地图获取POI信息(默认为YES), 对应的回调是 -(void)mapView:(MAMapView *) didTouchPois:(NSArray *)
|
readwritenonatomiccopy |
设置实时交通颜色,key为 MATrafficStatus
|
readnonatomicassign |
当前的位置数据
Provided by category MAMapView(UserLocation).
|
readnonatomicassign |
用户位置精度圈 对应的overlay
Provided by category MAMapView(UserLocation).
|
readnonatomicassign |
当前位置再地图中是否可见
Provided by category MAMapView(UserLocation).
|
readwritenonatomicassign |
定位用户位置的模式, 注意:在follow模式下,设置地图中心点、设置可见区域、滑动手势、选择annotation操作会取消follow模式,并触发 - (void)mapView:(MAMapView *)mapView didChangeUserTrackingMode:(MAUserTrackingMode)mode animated:(BOOL)animated;
Provided by category MAMapView(UserLocation).
|
readwritenonatomicassign |
可见区域, 设定的该范围可能会被调整为适合地图窗口显示的范围
|
readwritenonatomicassign |
是否支持缩放, 默认YES
|
readwritenonatomicassign |
是否以screenAnchor点作为锚点进行缩放,默认为YES。如果为NO,则以手势中心点作为锚点
|
readwritenonatomicassign |
缩放级别(默认3-19,有室内地图时为3-20)