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)