|
iOS高德轻量版地图SDK
1.2.0
|
#import <MAMap.h>
Instance Methods | |
| (instancetype) | - initWithWebView: |
| 使用外部webView初始化地图 (注意:该初始化方法不会加载地图,需要调用loadMap加载地图) More... | |
| (void) | - createMap |
| 加载地图 More... | |
| (void) | - setVisibleMapRect:animated: |
| 设置可见区域 More... | |
| (void) | - setVisibleMapRect:edgePadding:animated: |
| 设置可见地图矩形区域 More... | |
| (void) | - setCenterCoordinate:animated: |
| 设置当前地图的中心点,改变该值时,地图的比例尺级别不会发生变化 More... | |
| (void) | - setZoomLevel:animated: |
| 设置缩放级别 More... | |
| (void) | - setRotationDegree:animated: |
| 设置旋转角度 More... | |
| (void) | - setCameraDegree:animated: |
| 设置仰角角度 More... | |
| (MAMapStatus *) | - getMapStatus |
| 获取地图状态 More... | |
| (void) | - setMapStatus:animated: |
| 设置地图状态 More... | |
| (void) | - convertCoordinate:completeCallback: |
| 将经纬度转换为指定view坐标系的坐标 More... | |
| (void) | - convertPoint:completeCallback: |
| 将指定view坐标系的坐标转换为经纬度 More... | |
| (NSString *) | - mapContentApprovalNumber |
| 获取地图审图号。如果启用了“自定义样式”功能(customMapStyleEnabled 为 YES),则返回nil。 More... | |
| (NSString *) | - satelliteImageApprovalNumber |
| 获取卫星图片审图号。 More... | |
| (void) | - longPressGesture: |
| WKWebView长按事件透传。 More... | |
| (void) | - addAnnotation: |
| 向地图窗口添加标注,需要实现MAMapDelegate的-map:viewForAnnotation:函数来生成标注对应的View More... | |
| (void) | - addAnnotations: |
| 向地图窗口添加一组标注,需要实现MAMapDelegate的-map:viewForAnnotation:函数来生成标注对应的View More... | |
| (void) | - removeAnnotation: |
| 移除标注 More... | |
| (void) | - removeAnnotations: |
| 移除一组标注 More... | |
| (MAAnnotationView *) | - viewForAnnotation: |
| 根据标注数据获取标注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) | - addOverlay: |
| 向地图窗口添加Overlay。 需要实现MAMapDelegate的-map:rendererForOverlay:函数来生成标注对应的Renderer。 默认添加层级:MAGroundOverlay默认层级为MAOverlayLevelAboveRoads,其余overlay类型默认层级为MAOverlayLevelAboveLabels More... | |
| (void) | - addOverlays: |
| 向地图窗口添加一组Overlay,需要实现MAMapDelegate的-map:rendererForOverlay:函数来生成标注对应的Renderer 默认添加层级:MAOverlayLevelAboveLabels More... | |
| (void) | - removeOverlay: |
| 移除Overlay More... | |
| (void) | - removeOverlays: |
| 移除一组Overlay More... | |
| (MAOverlayRenderer *) | - rendererForOverlay: |
| 查找指定overlay对应的Renderer,如果该View尚未创建,返回nil More... | |
| (void) | - showOverlays:animated: |
| 设置地图使其可以显示数组中所有的overlay, 如果数组中只有一个则直接设置地图中心为overlay的位置。 More... | |
| (void) | - showOverlays:edgePadding:animated: |
| 设置地图使其可以显示数组中所有的overlay, 如果数组中只有一个则直接设置地图中心为overlay的位置。 More... | |
| (void) | - setUserLocation:coordinateType: |
| 设置当前用户位置,当showsUserLocation为YES时调用有效 More... | |
| (void) | - setUserHeading: |
| 设置当前用户设备方向,当showsUserLocation为YES时调用有效 More... | |
| (void) | - setUserTrackingMode:animated: |
| 设置定位用户位置的模式 More... | |
| (void) | - updateUserLocationRepresentation: |
| 设定UserLocationView样式。如果用户自定义了userlocation的annotationView,或者该annotationView还未添加到地图上,此方法将不起作用 More... | |
Class Methods | |
| (NSArray< MACustomSchemeModel * > *) | + customSchemeArray |
| 获取需要注册的自定义 More... | |
| (void) | + startRequestWithURLProtocol: |
| (void) | + stopRequestWithURLProtocol: |
Properties | |
| id< MAMapDelegate > | delegate |
| 地图的delegate More... | |
| MAMapType | mapType |
| CLLocationCoordinate2D | centerCoordinate |
| 当前地图的中心点,改变该值时,地图的比例尺级别不会发生变化 More... | |
| MAMapRect | visibleMapRect |
| 可见区域, 设定的该范围可能会被调整为适合地图窗口显示的范围 More... | |
| MACoordinateRegion | limitRegion |
| 设置可见地图区域的矩形边界,如限制地图只显示北京市范围 More... | |
| MAMapRect | limitMapRect |
| 设置可见地图区域的矩形边界,如限制地图只显示北京市范围 More... | |
| CGFloat | zoomLevel |
| 缩放级别(默认3-20) More... | |
| CGFloat | minZoomLevel |
| 最小缩放级别 More... | |
| CGFloat | maxZoomLevel |
| 最大缩放级别 More... | |
| BOOL | zoomEnabled |
| 是否支持缩放, 默认YES More... | |
| CGFloat | rotationDegree |
| 设置地图旋转角度(逆时针为正向) More... | |
| BOOL | rotateEnabled |
| 是否支持旋转, 默认YES More... | |
| CGFloat | cameraDegree |
| 设置地图相机角度(范围为[0.f, 60.f],但高于40度的角度需要在16级以上才能生效) More... | |
| BOOL | rotateCameraEnabled |
| 是否支持camera旋转, 默认YES More... | |
| BOOL | scrollEnabled |
| 是否支持平移, 默认YES More... | |
| BOOL | showsBuildings |
| 是否显示楼块,默认为YES More... | |
| BOOL | showsLabels |
| 是否显示底图标注, 默认为YES More... | |
| BOOL | showTraffic |
| 是否显示交通路况图层, 默认为NO More... | |
| BOOL | isAbroad |
| 标识当前地图中心位置是否在中国范围外。此属性不是精确判断,不能用于边界区域 More... | |
| BOOL | showsWorldMap |
| 是否显示海外地图,默认为@NO. 注意:必须先在官网申请开通海外权限 More... | |
| NSArray * | annotations |
| 所有添加的标注, 注意从5.3.0开始返回数组内不再包含定位蓝点userLocation More... | |
| NSArray * | selectedAnnotations |
| 处于选中状态的标注数据数据(其count == 0 或 1) More... | |
| NSArray * | overlays |
| 所有添加的Overlay More... | |
| BOOL | showsUserLocation |
| 是否显示用户位置,默认为NO More... | |
| MAUserLocation * | userLocation |
| 当前的位置数据 More... | |
| BOOL | customizeUserLocationAccuracyCircleRepresentation |
| 是否自定义用户位置精度圈(userLocationAccuracyCircle)对应的 view, 默认为 NO. 如果为YES: 会调用 - (MAOverlayRenderer *)map (MAMap *)map rendererForOverlay: (MAMap(Overlay))overlay 若返回nil, 则不加载. 如果为NO : 会使用默认的样式. More... | |
| MACircle * | userLocationAccuracyCircle |
| 用户位置精度圈 对应的overlay More... | |
| MAUserTrackingMode | userTrackingMode |
| 定位用户位置的模式, 注意:在follow模式下,设置地图中心点、设置可见区域、滑动手势、选择annotation操作会取消follow模式,并触发 - (void)map:(MAMap *)map didChangeUserTrackingMode:(MAUserTrackingMode)mode animated:(BOOL)animated; More... | |
| - (void) addAnnotation: | (id< MAAnnotation >) | annotation |
向地图窗口添加标注,需要实现MAMapDelegate的-map:viewForAnnotation:函数来生成标注对应的View
| annotation | 要添加的标注 |
Provided by category MAMap(Annotation).
| - (void) addAnnotations: | (NSArray *) | annotations |
向地图窗口添加一组标注,需要实现MAMapDelegate的-map:viewForAnnotation:函数来生成标注对应的View
| annotations | 要添加的标注数组 |
Provided by category MAMap(Annotation).
| - (void) addOverlay: | (id< MAOverlay >) | overlay |
向地图窗口添加Overlay。 需要实现MAMapDelegate的-map:rendererForOverlay:函数来生成标注对应的Renderer。 默认添加层级:MAGroundOverlay默认层级为MAOverlayLevelAboveRoads,其余overlay类型默认层级为MAOverlayLevelAboveLabels
| overlay | 要添加的overlay |
Provided by category MAMap(Overlay).
| - (void) addOverlays: | (NSArray *) | overlays |
向地图窗口添加一组Overlay,需要实现MAMapDelegate的-map:rendererForOverlay:函数来生成标注对应的Renderer 默认添加层级:MAOverlayLevelAboveLabels
| overlays | 要添加的overlay数组 |
Provided by category MAMap(Overlay).
| - (void) convertCoordinate: | (CLLocationCoordinate2D) | coordinate | |
| completeCallback: | (void(^)(CGPoint point)) | completeCallback | |
将经纬度转换为指定view坐标系的坐标
| coordinate | 经纬度 |
| completeCallback | 基于指定view坐标系的坐标 |
| - (void) convertPoint: | (CGPoint) | point | |
| completeCallback: | (void(^)(CLLocationCoordinate2D coordinate)) | completeCallback | |
将指定view坐标系的坐标转换为经纬度
| point | 指定view坐标系的坐标 |
| completeCallback | 经纬度 |
| - (void) createMap |
加载地图
| + (NSArray<MACustomSchemeModel*>*) customSchemeArray |
获取需要注册的自定义
| - (void) deselectAnnotation: | (id< MAAnnotation >) | annotation | |
| animated: | (BOOL) | animated | |
| - (MAMapStatus *) getMapStatus |
获取地图状态
| - (instancetype) initWithWebView: | (nonnull NSObject< MAMapWebViewProcotol > *) | webView |
使用外部webView初始化地图 (注意:该初始化方法不会加载地图,需要调用loadMap加载地图)
| webView | 外部创建的WKWebView (内部会强引用,此webView的configuration需要通过webViewConfiguration方法获取) |
| - (void) longPressGesture: | (UILongPressGestureRecognizer *) | gestureRecognizer |
WKWebView长按事件透传。
| gestureRecognizer | 长按事件 |
| - (NSString *) mapContentApprovalNumber |
获取地图审图号。如果启用了“自定义样式”功能(customMapStyleEnabled 为 YES),则返回nil。
| - (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 MAMap(Overlay).
| - (NSString *) satelliteImageApprovalNumber |
获取卫星图片审图号。
| - (void) selectAnnotation: | (id< MAAnnotation >) | annotation | |
| animated: | (BOOL) | animated | |
选中标注数据对应的view。注意:如果annotation对应的annotationView因不在屏幕范围内而被移入复用池,为了完成选中操作,会将对应的annotationView添加到地图上,并将地图中心点移至annotation.coordinate的位置。
| annotation | 标注数据 |
| animated | 是否有动画效果 |
Provided by category MAMap(Annotation).
| - (void) setCameraDegree: | (CGFloat) | cameraDegree | |
| animated: | (BOOL) | animated | |
设置仰角角度
| cameraDegree | 要设置的仰角角度 |
| animated | 是否动画设置 |
| - (void) setCenterCoordinate: | (CLLocationCoordinate2D) | coordinate | |
| animated: | (BOOL) | animated | |
设置当前地图的中心点,改变该值时,地图的比例尺级别不会发生变化
| coordinate | 要设置的中心点 |
| animated | 是否动画设置 |
| - (void) setMapStatus: | (MAMapStatus *) | status | |
| animated: | (BOOL) | animated | |
设置地图状态
| status | 要设置的地图状态 |
| animated | 是否动画 |
| - (void) setRotationDegree: | (CGFloat) | rotationDegree | |
| animated: | (BOOL) | animated | |
设置旋转角度
| rotationDegree | 要设置的旋转角度 |
| animated | 是否动画设置 |
| - (void) setUserHeading: | (CLHeading *) | heading |
设置当前用户设备方向,当showsUserLocation为YES时调用有效
| heading | 当前用户方向heading |
Provided by category MAMap(UserLocation).
| - (void) setUserLocation: | (CLLocation *) | location | |
| coordinateType: | (AMapCoordinateType) | type | |
设置当前用户位置,当showsUserLocation为YES时调用有效
| location | 当前用户定位location |
Provided by category MAMap(UserLocation).
| - (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 | |
设置缩放级别
| zoomLevel | 要设置的缩放级别 |
| animated | 是否动画设置 |
| - (void) showAnnotations: | (NSArray *) | annotations | |
| animated: | (BOOL) | animated | |
设置地图使其可以显示数组中所有的annotation, 如果数组中只有一个则直接设置地图中心为annotation的位置。
| annotations | 需要显示的annotation |
| animated | 是否执行动画 |
Provided by category MAMap(Annotation).
| - (void) showAnnotations: | (NSArray *) | annotations | |
| edgePadding: | (UIEdgeInsets) | insets | |
| animated: | (BOOL) | animated | |
设置地图使其可以显示数组中所有的annotation, 如果数组中只有一个则直接设置地图中心为annotation的位置。
| annotations | 需要显示的annotation |
| insets | insets 嵌入边界 |
| animated | 是否执行动画 |
Provided by category MAMap(Annotation).
| - (void) showOverlays: | (NSArray *) | overlays | |
| animated: | (BOOL) | animated | |
设置地图使其可以显示数组中所有的overlay, 如果数组中只有一个则直接设置地图中心为overlay的位置。
| overlays | 需要显示的overlays |
| animated | 是否执行动画 |
Provided by category MAMap(Overlay).
| - (void) showOverlays: | (NSArray *) | overlays | |
| edgePadding: | (UIEdgeInsets) | insets | |
| animated: | (BOOL) | animated | |
设置地图使其可以显示数组中所有的overlay, 如果数组中只有一个则直接设置地图中心为overlay的位置。
| overlays | 需要显示的overlays |
| insets | insets 嵌入边界 |
| animated | 是否执行动画 |
Provided by category MAMap(Overlay).
| + (void) startRequestWithURLProtocol: | (NSURLProtocol *) | urlProtocol |
Provided by category MAMap(NetworkIntercept).
| + (void) stopRequestWithURLProtocol: | (NSURLProtocol *) | urlProtocol |
Provided by category MAMap(NetworkIntercept).
| - (void) updateUserLocationRepresentation: | (MAUserLocationRepresentation *) | representation |
设定UserLocationView样式。如果用户自定义了userlocation的annotationView,或者该annotationView还未添加到地图上,此方法将不起作用
| representation | 样式信息对象 |
Provided by category MAMap(UserLocation).
| - (MAAnnotationView *) viewForAnnotation: | (id< MAAnnotation >) | annotation |
|
readnonatomicassign |
所有添加的标注, 注意从5.3.0开始返回数组内不再包含定位蓝点userLocation
Provided by category MAMap(Annotation).
|
readwritenonatomicassign |
设置地图相机角度(范围为[0.f, 60.f],但高于40度的角度需要在16级以上才能生效)
|
readwritenonatomicassign |
当前地图的中心点,改变该值时,地图的比例尺级别不会发生变化
|
readwritenonatomicassign |
是否自定义用户位置精度圈(userLocationAccuracyCircle)对应的 view, 默认为 NO.
如果为YES: 会调用 - (MAOverlayRenderer *)map (MAMap *)map rendererForOverlay: (MAMap(Overlay))overlay 若返回nil, 则不加载.
如果为NO : 会使用默认的样式.
Provided by category MAMap(UserLocation).
|
readwritenonatomicweak |
地图的delegate
|
readnonatomicassign |
标识当前地图中心位置是否在中国范围外。此属性不是精确判断,不能用于边界区域
|
readwritenonatomicassign |
设置可见地图区域的矩形边界,如限制地图只显示北京市范围
|
readwritenonatomicassign |
设置可见地图区域的矩形边界,如限制地图只显示北京市范围
|
readwritenonatomicassign |
|
readwritenonatomicassign |
最大缩放级别
|
readwritenonatomicassign |
最小缩放级别
|
readnonatomicassign |
所有添加的Overlay
Provided by category MAMap(Overlay).
|
readwritenonatomicassign |
是否支持camera旋转, 默认YES
|
readwritenonatomicassign |
是否支持旋转, 默认YES
|
readwritenonatomicassign |
设置地图旋转角度(逆时针为正向)
|
readwritenonatomicassign |
是否支持平移, 默认YES
|
readwritenonatomiccopy |
处于选中状态的标注数据数据(其count == 0 或 1)
Provided by category MAMap(Annotation).
|
readwritenonatomicassign |
是否显示楼块,默认为YES
|
readwritenonatomicassign |
是否显示底图标注, 默认为YES
|
readwritenonatomicassign |
是否显示用户位置,默认为NO
Provided by category MAMap(UserLocation).
|
readwritenonatomicassign |
是否显示海外地图,默认为@NO. 注意:必须先在官网申请开通海外权限
|
readwritenonatomicassign |
是否显示交通路况图层, 默认为NO
|
readnonatomicassign |
当前的位置数据
Provided by category MAMap(UserLocation).
|
readnonatomicassign |
用户位置精度圈 对应的overlay
Provided by category MAMap(UserLocation).
|
readwritenonatomicassign |
定位用户位置的模式, 注意:在follow模式下,设置地图中心点、设置可见区域、滑动手势、选择annotation操作会取消follow模式,并触发 - (void)map:(MAMap *)map didChangeUserTrackingMode:(MAUserTrackingMode)mode animated:(BOOL)animated;
Provided by category MAMap(UserLocation).
|
readwritenonatomicassign |
可见区域, 设定的该范围可能会被调整为适合地图窗口显示的范围
|
readwritenonatomicassign |
是否支持缩放, 默认YES
|
readwritenonatomicassign |
缩放级别(默认3-20)