#import <MAMapView.h>

Inheritance diagram for <MAMapViewDelegate>:

Instance Methods
(void)	- mapViewRegionChanged:
	地图区域改变过程中会调用此接口 since 4.6.0

(void)	- mapView:regionWillChangeAnimated:
	地图区域即将改变时会调用此接口

(void)	- mapView:regionDidChangeAnimated:
	地图区域改变完成后会调用此接口

(void)	- mapView:regionWillChangeAnimated:wasUserAction:
	地图区域即将改变时会调用此接口，如实现此接口则不会触发回掉mapView:regionWillChangeAnimated:

(void)	- mapView:regionDidChangeAnimated:wasUserAction:
	地图区域改变完成后会调用此接口，如实现此接口则不会触发回掉mapView:regionDidChangeAnimated:

(void)	- mapView:mapWillMoveByUser:
	地图将要发生移动时调用此接口

(void)	- mapView:mapDidMoveByUser:
	地图移动结束后调用此接口

(void)	- mapView:mapWillZoomByUser:
	地图将要发生缩放时调用此接口

(void)	- mapView:mapDidZoomByUser:
	地图缩放结束后调用此接口

(void)	- mapViewWillStartLoadingMap:
	地图开始加载

(void)	- mapViewDidFinishLoadingMap:
	地图加载成功

(void)	- mapViewDidFailLoadingMap:withError:
	地图加载失败

(void)	- mapView:didFailLoadTerrainWithError:
	地形图加载失败

(MAAnnotationView *)	- mapView:viewForAnnotation:
	根据anntation生成对应的View。

(void)	- mapView:didAddAnnotationViews:
	当mapView新添加annotation views时，调用此接口

(void)	- mapView:didSelectAnnotationView:
	当选中一个annotation view时，调用此接口. 注意如果已经是选中状态，再次点击不会触发此回调。取消选中需调用-(void)deselectAnnotation:animated:

(void)	- mapView:didDeselectAnnotationView:
	当取消选中一个annotation view时，调用此接口

(void)	- mapViewWillStartLocatingUser:
	在地图View将要启动定位时，会调用此函数

(void)	- mapViewDidStopLocatingUser:
	在地图View停止定位后，会调用此函数

(void)	- mapView:didUpdateUserLocation:updatingLocation:
	位置或者设备方向更新后，会调用此函数

(void)	- mapViewRequireLocationAuth:
	当plist配置NSLocationAlwaysUsageDescription或者NSLocationAlwaysAndWhenInUseUsageDescription，并且[CLLocationManager authorizationStatus] == kCLAuthorizationStatusNotDetermined，会调用代理的此方法。此方法实现调用后台权限API即可（该回调必须实现 [locationManager requestAlwaysAuthorization] ）; since 6.8.0

(void)	- mapView:didFailToLocateUserWithError:
	定位失败后，会调用此函数

(void)	- mapView:annotationView:didChangeDragState:fromOldState:
	拖动annotation view时view的状态变化

(MAOverlayRenderer *)	- mapView:rendererForOverlay:
	根据overlay生成对应的Renderer

(void)	- mapView:didAddOverlayRenderers:
	当mapView新添加overlay renderers时，调用此接口

(void)	- mapView:annotationView:calloutAccessoryControlTapped:
	标注view的accessory view(必须继承自UIControl)被点击时，触发该回调

(void)	- mapView:didAnnotationViewCalloutTapped:
	标注view的calloutview整体点击时，触发该回调。只有使用默认calloutview时才生效。

(void)	- mapView:didAnnotationViewTapped:
	标注view被点击时，触发该回调。（since 5.7.0）

(void)	- mapView:didChangeUserTrackingMode:animated:
	当userTrackingMode改变时，调用此接口

(void)	- mapView:didChangeOpenGLESDisabled:
	当openGLESDisabled变量改变时，调用此接口

(void)	- mapView:didTouchPois:
	当touchPOIEnabled == YES时，单击地图使用该回调获取POI信息

(void)	- mapView:didSingleTappedAtCoordinate:
	单击地图回调，返回经纬度

(void)	- mapView:didLongPressedAtCoordinate:
	长按地图，返回经纬度

(void)	- mapInitComplete:
	地图初始化完成（在此之后，可以进行坐标计算）

(void)	- offlineDataWillReload:
	离线地图数据将要被加载, 调用reloadMap会触发该回调，离线数据生效前的回调.

(void)	- offlineDataDidReload:
	离线地图数据加载完成, 调用reloadMap会触发该回调，离线数据生效后的回调.

Method Documentation

◆ mapInitComplete:

- (void) mapInitComplete: (MAMapView *) mapView

optional

地图初始化完成（在此之后，可以进行坐标计算）

Parameters

mapView 地图View

◆ mapView:annotationView:calloutAccessoryControlTapped:

- (void) mapView:	(MAMapView *)	mapView
annotationView:	(MAAnnotationView *)	view
calloutAccessoryControlTapped:	(UIControl *)	control

optional

标注view的accessory view(必须继承自UIControl)被点击时，触发该回调

Parameters

mapView	地图View
view	callout所属的标注view
control	对应的control

◆ mapView:annotationView:didChangeDragState:fromOldState:

- (void) mapView:	(MAMapView *)	mapView
annotationView:	(MAAnnotationView *)	view
didChangeDragState:	(MAAnnotationViewDragState)	newState
fromOldState:	(MAAnnotationViewDragState)	oldState

optional

拖动annotation view时view的状态变化

Parameters

mapView	地图View
view	annotation view
newState	新状态
oldState	旧状态

◆ mapView:didAddAnnotationViews:

- (void) mapView:	(MAMapView *)	mapView
didAddAnnotationViews:	(NSArray *)	views

optional

当mapView新添加annotation views时，调用此接口

Parameters

mapView	地图View
views	新添加的annotation views

◆ mapView:didAddOverlayRenderers:

- (void) mapView:	(MAMapView *)	mapView
didAddOverlayRenderers:	(NSArray *)	overlayRenderers

optional

当mapView新添加overlay renderers时，调用此接口

Parameters

mapView	地图View
overlayRenderers	新添加的overlay renderers

◆ mapView:didAnnotationViewCalloutTapped:

- (void) mapView:	(MAMapView *)	mapView
didAnnotationViewCalloutTapped:	(MAAnnotationView *)	view

optional

标注view的calloutview整体点击时，触发该回调。只有使用默认calloutview时才生效。

Parameters

mapView	地图的view
view	calloutView所属的annotationView

◆ mapView:didAnnotationViewTapped:

- (void) mapView:	(MAMapView *)	mapView
didAnnotationViewTapped:	(MAAnnotationView *)	view

optional

标注view被点击时，触发该回调。（since 5.7.0）

Parameters

mapView	地图的view
view	annotationView

◆ mapView:didChangeOpenGLESDisabled:

- (void) mapView:	(MAMapView *)	mapView
didChangeOpenGLESDisabled:	((deprecated("已废弃，since 7.9.0")))	__attribute

optional

当openGLESDisabled变量改变时，调用此接口

Parameters

mapView	地图View
openGLESDisabled	改变后的openGLESDisabled

◆ mapView:didChangeUserTrackingMode:animated:

- (void) mapView:	(MAMapView *)	mapView
didChangeUserTrackingMode:	(MAUserTrackingMode)	mode
animated:	(BOOL)	animated

optional

当userTrackingMode改变时，调用此接口

Parameters

mapView	地图View
mode	改变后的mode
animated	动画

◆ mapView:didDeselectAnnotationView:

- (void) mapView:	(MAMapView *)	mapView
didDeselectAnnotationView:	(MAAnnotationView *)	view

optional

当取消选中一个annotation view时，调用此接口

Parameters

mapView	地图View
view	取消选中的annotation view

◆ mapView:didFailLoadTerrainWithError:

- (void) mapView:	(MAMapView *)	mapView
didFailLoadTerrainWithError:	(NSError *)	error

optional

地形图加载失败

Parameters

mapView	地图View
error	错误信息

◆ mapView:didFailToLocateUserWithError:

- (void) mapView:	(MAMapView *)	mapView
didFailToLocateUserWithError:	(NSError *)	error

optional

定位失败后，会调用此函数

Parameters

mapView	地图View
error	错误号，参考CLError.h中定义的错误号

◆ mapView:didLongPressedAtCoordinate:

- (void) mapView:	(MAMapView *)	mapView
didLongPressedAtCoordinate:	(CLLocationCoordinate2D)	coordinate

optional

长按地图，返回经纬度

Parameters

mapView	地图View
coordinate	经纬度

◆ mapView:didSelectAnnotationView:

- (void) mapView:	(MAMapView *)	mapView
didSelectAnnotationView:	(MAAnnotationView *)	view

optional

当选中一个annotation view时，调用此接口. 注意如果已经是选中状态，再次点击不会触发此回调。取消选中需调用-(void)deselectAnnotation:animated:

Parameters

mapView	地图View
view	选中的annotation view

◆ mapView:didSingleTappedAtCoordinate:

- (void) mapView:	(MAMapView *)	mapView
didSingleTappedAtCoordinate:	(CLLocationCoordinate2D)	coordinate

optional

单击地图回调，返回经纬度

Parameters

mapView	地图View
coordinate	经纬度

◆ mapView:didTouchPois:

- (void) mapView:	(MAMapView *)	mapView
didTouchPois:	(NSArray *)	pois

optional

当touchPOIEnabled == YES时，单击地图使用该回调获取POI信息

Parameters

mapView	地图View
pois	获取到的poi数组(由MATouchPoi组成)

◆ mapView:didUpdateUserLocation:updatingLocation:

- (void) mapView:	(MAMapView *)	mapView
didUpdateUserLocation:	(MAUserLocation *)	userLocation
updatingLocation:	(BOOL)	updatingLocation

optional

位置或者设备方向更新后，会调用此函数

Parameters

mapView	地图View
userLocation	用户定位信息(包括位置与设备方向等数据)
updatingLocation	标示是否是location数据更新, YES:location数据更新 NO:heading数据更新

◆ mapView:mapDidMoveByUser:

- (void) mapView:	(MAMapView *)	mapView
mapDidMoveByUser:	(BOOL)	wasUserAction

optional

地图移动结束后调用此接口

Parameters

mapView	地图view
wasUserAction	标识是否是用户动作

◆ mapView:mapDidZoomByUser:

- (void) mapView:	(MAMapView *)	mapView
mapDidZoomByUser:	(BOOL)	wasUserAction

optional

地图缩放结束后调用此接口

Parameters

mapView	地图view
wasUserAction	标识是否是用户动作

◆ mapView:mapWillMoveByUser:

- (void) mapView:	(MAMapView *)	mapView
mapWillMoveByUser:	(BOOL)	wasUserAction

optional

地图将要发生移动时调用此接口

Parameters

mapView	地图view
wasUserAction	标识是否是用户动作

◆ mapView:mapWillZoomByUser:

- (void) mapView:	(MAMapView *)	mapView
mapWillZoomByUser:	(BOOL)	wasUserAction

optional

地图将要发生缩放时调用此接口

Parameters

mapView	地图view
wasUserAction	标识是否是用户动作

◆ mapView:regionDidChangeAnimated:

- (void) mapView:	(MAMapView *)	mapView
regionDidChangeAnimated:	(BOOL)	animated

optional

地图区域改变完成后会调用此接口

Parameters

mapView	地图View
animated	是否动画

◆ mapView:regionDidChangeAnimated:wasUserAction:

- (void) mapView:	(MAMapView *)	mapView
regionDidChangeAnimated:	(BOOL)	animated
wasUserAction:	(BOOL)	wasUserAction

optional

地图区域改变完成后会调用此接口，如实现此接口则不会触发回掉mapView:regionDidChangeAnimated:

Parameters

mapView	地图View
animated	是否动画
wasUserAction	标识是否是用户动作

◆ mapView:regionWillChangeAnimated:

- (void) mapView:	(MAMapView *)	mapView
regionWillChangeAnimated:	(BOOL)	animated

optional

地图区域即将改变时会调用此接口

Parameters

mapView	地图View
animated	是否动画

◆ mapView:regionWillChangeAnimated:wasUserAction:

- (void) mapView:	(MAMapView *)	mapView
regionWillChangeAnimated:	(BOOL)	animated
wasUserAction:	(BOOL)	wasUserAction

optional

地图区域即将改变时会调用此接口，如实现此接口则不会触发回掉mapView:regionWillChangeAnimated:

Parameters

mapView	地图View
animated	是否动画
wasUserAction	标识是否是用户动作

◆ mapView:rendererForOverlay:

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

optional

根据overlay生成对应的Renderer

Parameters

mapView	地图View
overlay	指定的overlay

Returns: 生成的覆盖物Renderer

◆ mapView:viewForAnnotation:

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

optional

根据anntation生成对应的View。

注意： 1、5.1.0后由于定位蓝点增加了平滑移动功能，如果在开启定位的情况先添加annotation，需要在此回调方法中判断annotation是否为MAUserLocation，从而返回正确的View。 if ([annotation isKindOfClass:[MAUserLocation class]]) { return nil; }

2、请不要在此回调中对annotation进行select和deselect操作，此时annotationView还未添加到mapview。

Parameters

mapView	地图View
annotation	指定的标注

Returns: 生成的标注View

◆ mapViewDidFailLoadingMap:withError:

- (void) mapViewDidFailLoadingMap:	(MAMapView *)	mapView
withError:	(NSError *)	error

optional

地图加载失败

Parameters

mapView	地图View
error	错误信息

◆ mapViewDidFinishLoadingMap:

- (void) mapViewDidFinishLoadingMap: (MAMapView *) mapView

optional

地图加载成功

Parameters

mapView 地图View

◆ mapViewDidStopLocatingUser:

- (void) mapViewDidStopLocatingUser: (MAMapView *) mapView

optional

在地图View停止定位后，会调用此函数

Parameters

mapView 地图View

◆ mapViewRegionChanged:

- (void) mapViewRegionChanged: (MAMapView *) mapView

optional

地图区域改变过程中会调用此接口 since 4.6.0

Parameters

mapView 地图View

◆ mapViewRequireLocationAuth:

- (void) mapViewRequireLocationAuth: (CLLocationManager *) locationManager

optional

当plist配置NSLocationAlwaysUsageDescription或者NSLocationAlwaysAndWhenInUseUsageDescription，并且[CLLocationManager authorizationStatus] == kCLAuthorizationStatusNotDetermined，会调用代理的此方法。此方法实现调用后台权限API即可（该回调必须实现 [locationManager requestAlwaysAuthorization] ）; since 6.8.0

Parameters

locationManager 地图的CLLocationManager。

◆ mapViewWillStartLoadingMap:

- (void) mapViewWillStartLoadingMap: (MAMapView *) mapView

optional

地图开始加载

Parameters

mapView 地图View

◆ mapViewWillStartLocatingUser:

- (void) mapViewWillStartLocatingUser: (MAMapView *) mapView

optional

在地图View将要启动定位时，会调用此函数

Parameters

mapView 地图View

◆ offlineDataDidReload:

- (void) offlineDataDidReload: (MAMapView *) mapView

optional

离线地图数据加载完成, 调用reloadMap会触发该回调，离线数据生效后的回调.

Parameters

mapView 地图View

◆ offlineDataWillReload:

- (void) offlineDataWillReload: (MAMapView *) mapView

optional

离线地图数据将要被加载, 调用reloadMap会触发该回调，离线数据生效前的回调.

Parameters

mapView 地图View

The documentation for this protocol was generated from the following file:

MAMapView.h

Instance Methods

Method Documentation

◆ mapInitComplete:

◆ mapView:annotationView:calloutAccessoryControlTapped:

◆ mapView:annotationView:didChangeDragState:fromOldState:

◆ mapView:didAddAnnotationViews:

◆ mapView:didAddOverlayRenderers:

◆ mapView:didAnnotationViewCalloutTapped:

◆ mapView:didAnnotationViewTapped:

◆ mapView:didChangeOpenGLESDisabled:

◆ mapView:didChangeUserTrackingMode:animated:

◆ mapView:didDeselectAnnotationView:

◆ mapView:didFailLoadTerrainWithError:

◆ mapView:didFailToLocateUserWithError:

◆ mapView:didLongPressedAtCoordinate:

◆ mapView:didSelectAnnotationView:

◆ mapView:didSingleTappedAtCoordinate:

◆ mapView:didTouchPois:

◆ mapView:didUpdateUserLocation:updatingLocation:

◆ mapView:mapDidMoveByUser:

◆ mapView:mapDidZoomByUser:

◆ mapView:mapWillMoveByUser:

◆ mapView:mapWillZoomByUser:

◆ mapView:regionDidChangeAnimated:

◆ mapView:regionDidChangeAnimated:wasUserAction:

◆ mapView:regionWillChangeAnimated:

◆ mapView:regionWillChangeAnimated:wasUserAction:

◆ mapView:rendererForOverlay:

◆ mapView:viewForAnnotation:

◆ mapViewDidFailLoadingMap:withError:

◆ mapViewDidFinishLoadingMap:

◆ mapViewDidStopLocatingUser:

◆ mapViewRegionChanged:

◆ mapViewRequireLocationAuth:

◆ mapViewWillStartLoadingMap:

◆ mapViewWillStartLocatingUser:

◆ offlineDataDidReload:

◆ offlineDataWillReload: