|
高德地图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)