iOS高德轻量版地图SDK  1.2.0
MAMap Class Reference

#import <MAMap.h>

Inheritance diagram for MAMap:

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< MAMapDelegatedelegate
 地图的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...
 
MAUserLocationuserLocation
 当前的位置数据 More...
 
BOOL customizeUserLocationAccuracyCircleRepresentation
 是否自定义用户位置精度圈(userLocationAccuracyCircle)对应的 view, 默认为 NO.
如果为YES: 会调用 - (MAOverlayRenderer *)map (MAMap *)map rendererForOverlay: (MAMap(Overlay))overlay 若返回nil, 则不加载.
如果为NO : 会使用默认的样式. More...
 
MACircleuserLocationAccuracyCircle
 用户位置精度圈 对应的overlay More...
 
MAUserTrackingMode userTrackingMode
 定位用户位置的模式, 注意:在follow模式下,设置地图中心点、设置可见区域、滑动手势、选择annotation操作会取消follow模式,并触发 - (void)map:(MAMap *)map didChangeUserTrackingMode:(MAUserTrackingMode)mode animated:(BOOL)animated; More...
 

Method Documentation

◆ addAnnotation:

- (void) addAnnotation: (id< MAAnnotation >)  annotation

向地图窗口添加标注,需要实现MAMapDelegate的-map:viewForAnnotation:函数来生成标注对应的View

Parameters
annotation要添加的标注

Provided by category MAMap(Annotation).

◆ addAnnotations:

- (void) addAnnotations: (NSArray *)  annotations

向地图窗口添加一组标注,需要实现MAMapDelegate的-map:viewForAnnotation:函数来生成标注对应的View

Parameters
annotations要添加的标注数组

Provided by category MAMap(Annotation).

◆ addOverlay:

- (void) addOverlay: (id< MAOverlay >)  overlay

向地图窗口添加Overlay。 需要实现MAMapDelegate的-map:rendererForOverlay:函数来生成标注对应的Renderer。 默认添加层级:MAGroundOverlay默认层级为MAOverlayLevelAboveRoads,其余overlay类型默认层级为MAOverlayLevelAboveLabels

Parameters
overlay要添加的overlay

Provided by category MAMap(Overlay).

◆ addOverlays:

- (void) addOverlays: (NSArray *)  overlays

向地图窗口添加一组Overlay,需要实现MAMapDelegate的-map:rendererForOverlay:函数来生成标注对应的Renderer 默认添加层级:MAOverlayLevelAboveLabels

Parameters
overlays要添加的overlay数组

Provided by category MAMap(Overlay).

◆ convertCoordinate:completeCallback:

- (void) convertCoordinate: (CLLocationCoordinate2D)  coordinate
completeCallback: (void(^)(CGPoint point))  completeCallback 

将经纬度转换为指定view坐标系的坐标

Parameters
coordinate经纬度
completeCallback基于指定view坐标系的坐标

◆ convertPoint:completeCallback:

- (void) convertPoint: (CGPoint)  point
completeCallback: (void(^)(CLLocationCoordinate2D coordinate))  completeCallback 

将指定view坐标系的坐标转换为经纬度

Parameters
point指定view坐标系的坐标
completeCallback经纬度

◆ createMap

- (void) createMap

加载地图

◆ customSchemeArray

+ (NSArray<MACustomSchemeModel*>*) customSchemeArray

获取需要注册的自定义

Returns
返回webViewConfiguration用于初始化WKWebView

◆ deselectAnnotation:animated:

- (void) deselectAnnotation: (id< MAAnnotation >)  annotation
animated: (BOOL)  animated 

取消选中标注数据对应的view

Parameters
annotation标注数据
animated是否有动画效果

Provided by category MAMap(Annotation).

◆ getMapStatus

- (MAMapStatus *) getMapStatus

获取地图状态

Returns
地图状态

◆ initWithWebView:

- (instancetype) initWithWebView: (nonnull NSObject< MAMapWebViewProcotol > *)  webView

使用外部webView初始化地图 (注意:该初始化方法不会加载地图,需要调用loadMap加载地图)

Parameters
webView外部创建的WKWebView (内部会强引用,此webView的configuration需要通过webViewConfiguration方法获取)

◆ longPressGesture:

- (void) longPressGesture: (UILongPressGestureRecognizer *)  gestureRecognizer

WKWebView长按事件透传。

Parameters
gestureRecognizer长按事件

◆ mapContentApprovalNumber

- (NSString *) mapContentApprovalNumber

获取地图审图号。如果启用了“自定义样式”功能(customMapStyleEnabled 为 YES),则返回nil。

Returns
地图审图号

◆ removeAnnotation:

- (void) removeAnnotation: (id< MAAnnotation >)  annotation

移除标注

Parameters
annotation要移除的标注

Provided by category MAMap(Annotation).

◆ removeAnnotations:

- (void) removeAnnotations: (NSArray *)  annotations

移除一组标注

Parameters
annotations要移除的标注数组

Provided by category MAMap(Annotation).

◆ removeOverlay:

- (void) removeOverlay: (id< MAOverlay >)  overlay

移除Overlay

Parameters
overlay要移除的overlay

Provided by category MAMap(Overlay).

◆ removeOverlays:

- (void) removeOverlays: (NSArray *)  overlays

移除一组Overlay

Parameters
overlays要移除的overlay数组

Provided by category MAMap(Overlay).

◆ rendererForOverlay:

- (MAOverlayRenderer *) rendererForOverlay: (id< MAOverlay >)  overlay

查找指定overlay对应的Renderer,如果该View尚未创建,返回nil

Parameters
overlay指定的overlay
Returns
指定overlay对应的Renderer

Provided by category MAMap(Overlay).

◆ satelliteImageApprovalNumber

- (NSString *) satelliteImageApprovalNumber

获取卫星图片审图号。

Returns
卫星图片审图号

◆ selectAnnotation:animated:

- (void) selectAnnotation: (id< MAAnnotation >)  annotation
animated: (BOOL)  animated 

选中标注数据对应的view。注意:如果annotation对应的annotationView因不在屏幕范围内而被移入复用池,为了完成选中操作,会将对应的annotationView添加到地图上,并将地图中心点移至annotation.coordinate的位置。

Parameters
annotation标注数据
animated是否有动画效果

Provided by category MAMap(Annotation).

◆ setCameraDegree:animated:

- (void) setCameraDegree: (CGFloat)  cameraDegree
animated: (BOOL)  animated 

设置仰角角度

Parameters
cameraDegree要设置的仰角角度
animated是否动画设置

◆ setCenterCoordinate:animated:

- (void) setCenterCoordinate: (CLLocationCoordinate2D)  coordinate
animated: (BOOL)  animated 

设置当前地图的中心点,改变该值时,地图的比例尺级别不会发生变化

Parameters
coordinate要设置的中心点
animated是否动画设置

◆ setMapStatus:animated:

- (void) setMapStatus: (MAMapStatus *)  status
animated: (BOOL)  animated 

设置地图状态

Parameters
status要设置的地图状态
animated是否动画

◆ setRotationDegree:animated:

- (void) setRotationDegree: (CGFloat)  rotationDegree
animated: (BOOL)  animated 

设置旋转角度

Parameters
rotationDegree要设置的旋转角度
animated是否动画设置

◆ setUserHeading:

- (void) setUserHeading: (CLHeading *)  heading

设置当前用户设备方向,当showsUserLocation为YES时调用有效

Parameters
heading当前用户方向heading

Provided by category MAMap(UserLocation).

◆ setUserLocation:coordinateType:

- (void) setUserLocation: (CLLocation *)  location
coordinateType: (AMapCoordinateType)  type 

设置当前用户位置,当showsUserLocation为YES时调用有效

Parameters
location当前用户定位location

Provided by category MAMap(UserLocation).

◆ setUserTrackingMode:animated:

- (void) setUserTrackingMode: (MAUserTrackingMode)  mode
animated: (BOOL)  animated 

设置定位用户位置的模式

Parameters
mode要设置的模式
animated是否动画设置

Provided by category MAMap(UserLocation).

◆ setVisibleMapRect:animated:

- (void) setVisibleMapRect: (MAMapRect mapRect
animated: (BOOL)  animated 

设置可见区域

Parameters
mapRect要设定的可见区域
animated是否动画设置

◆ setVisibleMapRect:edgePadding:animated:

- (void) setVisibleMapRect: (MAMapRect mapRect
edgePadding: (UIEdgeInsets)  insets
animated: (BOOL)  animated 

设置可见地图矩形区域

Parameters
insets边缘插入
mapRect要显示的地图矩形区域
animated是否动画效果

◆ setZoomLevel:animated:

- (void) setZoomLevel: (CGFloat)  zoomLevel
animated: (BOOL)  animated 

设置缩放级别

Parameters
zoomLevel要设置的缩放级别
animated是否动画设置

◆ showAnnotations:animated:

- (void) showAnnotations: (NSArray *)  annotations
animated: (BOOL)  animated 

设置地图使其可以显示数组中所有的annotation, 如果数组中只有一个则直接设置地图中心为annotation的位置。

Parameters
annotations需要显示的annotation
animated是否执行动画

Provided by category MAMap(Annotation).

◆ showAnnotations:edgePadding:animated:

- (void) showAnnotations: (NSArray *)  annotations
edgePadding: (UIEdgeInsets)  insets
animated: (BOOL)  animated 

设置地图使其可以显示数组中所有的annotation, 如果数组中只有一个则直接设置地图中心为annotation的位置。

Parameters
annotations需要显示的annotation
insetsinsets 嵌入边界
animated是否执行动画

Provided by category MAMap(Annotation).

◆ showOverlays:animated:

- (void) showOverlays: (NSArray *)  overlays
animated: (BOOL)  animated 

设置地图使其可以显示数组中所有的overlay, 如果数组中只有一个则直接设置地图中心为overlay的位置。

Parameters
overlays需要显示的overlays
animated是否执行动画

Provided by category MAMap(Overlay).

◆ showOverlays:edgePadding:animated:

- (void) showOverlays: (NSArray *)  overlays
edgePadding: (UIEdgeInsets)  insets
animated: (BOOL)  animated 

设置地图使其可以显示数组中所有的overlay, 如果数组中只有一个则直接设置地图中心为overlay的位置。

Parameters
overlays需要显示的overlays
insetsinsets 嵌入边界
animated是否执行动画

Provided by category MAMap(Overlay).

◆ startRequestWithURLProtocol:

+ (void) startRequestWithURLProtocol: (NSURLProtocol *)  urlProtocol

Provided by category MAMap(NetworkIntercept).

◆ stopRequestWithURLProtocol:

+ (void) stopRequestWithURLProtocol: (NSURLProtocol *)  urlProtocol

Provided by category MAMap(NetworkIntercept).

◆ updateUserLocationRepresentation:

- (void) updateUserLocationRepresentation: (MAUserLocationRepresentation *)  representation

设定UserLocationView样式。如果用户自定义了userlocation的annotationView,或者该annotationView还未添加到地图上,此方法将不起作用

Parameters
representation样式信息对象

Provided by category MAMap(UserLocation).

◆ viewForAnnotation:

- (MAAnnotationView *) viewForAnnotation: (id< MAAnnotation >)  annotation

根据标注数据获取标注view

Parameters
annotation标注数据
Returns
对应的标注view

Provided by category MAMap(Annotation).

Property Documentation

◆ annotations

- (NSArray*) annotations
readnonatomicassign

所有添加的标注, 注意从5.3.0开始返回数组内不再包含定位蓝点userLocation

Provided by category MAMap(Annotation).

◆ cameraDegree

- (CGFloat) cameraDegree
readwritenonatomicassign

设置地图相机角度(范围为[0.f, 60.f],但高于40度的角度需要在16级以上才能生效)

◆ centerCoordinate

- (CLLocationCoordinate2D) centerCoordinate
readwritenonatomicassign

当前地图的中心点,改变该值时,地图的比例尺级别不会发生变化

◆ customizeUserLocationAccuracyCircleRepresentation

- (BOOL) customizeUserLocationAccuracyCircleRepresentation
readwritenonatomicassign

是否自定义用户位置精度圈(userLocationAccuracyCircle)对应的 view, 默认为 NO.
如果为YES: 会调用 - (MAOverlayRenderer *)map (MAMap *)map rendererForOverlay: (MAMap(Overlay))overlay 若返回nil, 则不加载.
如果为NO : 会使用默认的样式.

Provided by category MAMap(UserLocation).

◆ delegate

- (id<MAMapDelegate>) delegate
readwritenonatomicweak

地图的delegate

◆ isAbroad

- (BOOL) isAbroad
readnonatomicassign

标识当前地图中心位置是否在中国范围外。此属性不是精确判断,不能用于边界区域

◆ limitMapRect

- (MAMapRect) limitMapRect
readwritenonatomicassign

设置可见地图区域的矩形边界,如限制地图只显示北京市范围

◆ limitRegion

- (MACoordinateRegion) limitRegion
readwritenonatomicassign

设置可见地图区域的矩形边界,如限制地图只显示北京市范围

◆ mapType

- (MAMapType) mapType
readwritenonatomicassign

◆ maxZoomLevel

- (CGFloat) maxZoomLevel
readwritenonatomicassign

最大缩放级别

◆ minZoomLevel

- (CGFloat) minZoomLevel
readwritenonatomicassign

最小缩放级别

◆ overlays

- (NSArray*) overlays
readnonatomicassign

所有添加的Overlay

Provided by category MAMap(Overlay).

◆ rotateCameraEnabled

- (BOOL) rotateCameraEnabled
readwritenonatomicassign

是否支持camera旋转, 默认YES

◆ rotateEnabled

- (BOOL) rotateEnabled
readwritenonatomicassign

是否支持旋转, 默认YES

◆ rotationDegree

- (CGFloat) rotationDegree
readwritenonatomicassign

设置地图旋转角度(逆时针为正向)

◆ scrollEnabled

- (BOOL) scrollEnabled
readwritenonatomicassign

是否支持平移, 默认YES

◆ selectedAnnotations

- (NSArray*) selectedAnnotations
readwritenonatomiccopy

处于选中状态的标注数据数据(其count == 0 或 1)

Provided by category MAMap(Annotation).

◆ showsBuildings

- (BOOL) showsBuildings
readwritenonatomicassign

是否显示楼块,默认为YES

◆ showsLabels

- (BOOL) showsLabels
readwritenonatomicassign

是否显示底图标注, 默认为YES

◆ showsUserLocation

- (BOOL) showsUserLocation
readwritenonatomicassign

是否显示用户位置,默认为NO

Provided by category MAMap(UserLocation).

◆ showsWorldMap

- (BOOL) showsWorldMap
readwritenonatomicassign

是否显示海外地图,默认为@NO. 注意:必须先在官网申请开通海外权限

◆ showTraffic

- (BOOL) showTraffic
readwritenonatomicassign

是否显示交通路况图层, 默认为NO

◆ userLocation

- (MAUserLocation*) userLocation
readnonatomicassign

当前的位置数据

Provided by category MAMap(UserLocation).

◆ userLocationAccuracyCircle

- (MACircle*) userLocationAccuracyCircle
readnonatomicassign

用户位置精度圈 对应的overlay

Provided by category MAMap(UserLocation).

◆ userTrackingMode

- (MAUserTrackingMode) userTrackingMode
readwritenonatomicassign

定位用户位置的模式, 注意:在follow模式下,设置地图中心点、设置可见区域、滑动手势、选择annotation操作会取消follow模式,并触发 - (void)map:(MAMap *)map didChangeUserTrackingMode:(MAUserTrackingMode)mode animated:(BOOL)animated;

Provided by category MAMap(UserLocation).

◆ visibleMapRect

- (MAMapRect) visibleMapRect
readwritenonatomicassign

可见区域, 设定的该范围可能会被调整为适合地图窗口显示的范围

◆ zoomEnabled

- (BOOL) zoomEnabled
readwritenonatomicassign

是否支持缩放, 默认YES

◆ zoomLevel

- (CGFloat) zoomLevel
readwritenonatomicassign

缩放级别(默认3-20)


The documentation for this class was generated from the following file:
© 2020 高德信息技术有限公司版权所有,保留所有权利。