地图View类，使用此View可以显示地图窗口，并且对地图进行相关的操作更多...

#include <BMKMapView.h>

类 BMKMapView 继承关系图:

构造函数
(BOOL)	- setCustomTrafficColorForSmooth:slow:congestion:severeCongestion:

(void)	- viewWillAppear
	当mapview即将被显式的时候调用，恢复之前存储的mapview状态。

(void)	- viewWillDisappear
	当mapview即将被隐藏的时候调用，存储当前mapview的状态。

(void)	- cleanCacheWithMapType:
	清空地图缓存

(void)	- mapForceRefresh
	强制刷新mapview

(BOOL)	- zoomIn

(BOOL)	- zoomOut

(BMKCoordinateRegion)	- regionThatFits:
	此接口什么都没做，已废弃。

(void)	- setRegion:animated:

(void)	- setCenterCoordinate:animated:

(nullable UIImage *)	- takeSnapshot

(nullable UIImage *)	- takeSnapshot:

(void)	- setCompassImage:

(void)	- setVisibleMapRect:animated:

(BMKMapRect)	- mapRectThatFits:
	此方法什么都没做，已废弃

(void)	- setVisibleMapRect:edgePadding:animated:

(void)	- fitVisibleMapRect:edgePadding:withAnimated:

(BMKMapRect)	- mapRectThatFits:edgePadding:

(CGPoint)	- convertCoordinate:toPointToView:

(CLLocationCoordinate2D)	- convertPoint:toCoordinateFromView:

(CGRect)	- convertRegion:toRectToView:

(BMKCoordinateRegion)	- convertRect:toRegionFromView:

(CGRect)	- convertMapRect:toRectToView:

(BMKMapRect)	- convertRect:toMapRectFromView:

(CGPoint)	- screenPointFromMapPoint3:

(CGPoint)	- glPointForMapPoint:

(CGPoint *)	- glPointsForMapPoints:count:

(void)	- setMapCenterToScreenPt:

(BMKMapStatus *)	- getMapStatusFromCoordinateRegion:edgePadding:

(BMKMapStatus *)	- getMapStatus

(void)	- setMapStatus:

(void)	- setMapStatus:withAnimation:

(void)	- setMapStatus:withAnimation:withAnimationTime:

(BOOL)	- isSurpportBaiduHeatMap

(float *)	- getProjectionMatrix

(float *)	- getViewMatrix

(void)	- addAnnotation:

(void)	- addAnnotations:

(void)	- removeAnnotation:

(void)	- removeAnnotations:

(nullable BMKAnnotationView *)	- viewForAnnotation:

(nullable BMKAnnotationView *)	- dequeueReusableAnnotationViewWithIdentifier:

(void)	- selectAnnotation:animated:

(void)	- deselectAnnotation:animated:

(void)	- showAnnotations:animated:

(void)	- showAnnotations:padding:animated:

(nullable NSArray< id< BMKAnnotation > > *)	- annotationsInCoordinateBounds:

(BOOL)	- setCustomMapStylePath:

(BOOL)	- setCustomMapStylePath:mode:

(BOOL)	- setCustomMapStyleEnable:

(BOOL)	- setCustomMapStyleWithOption:preLoad:success:failure:

(void)	- addHeatMap:

(void)	- updateHeatMap:

(void)	- removeHeatMap
	移除热力图

(void)	- startHeatMapFrameAnimation
	开始动画

(void)	- stopHeatMapFrameAnimation
	暂停动画

(void)	- setHeatMapFrameAnimationIndex:
	控制渲染帧索引

(void)	- addHexagonHeatMap:
	添加蜂窝热力图，since 6.6.0

(void)	- removeHexagonHeatMap
	删除蜂窝热力图，since 6.6.0

(BMKSwitchIndoorFloorError)	- switchBaseIndoorMapFloor:withID:

(nullable BMKBaseIndoorMapInfo *)	- getFocusedBaseIndoorMapInfo

(void)	- updateLocationViewWithParam:

(void)	- updateLocationData:

(BOOL)	- switchLayerOrder:otherLayer:

(BOOL)	- switchOverlayLayerAndNavigationLayer:

(BOOL)	- switchOverlayLayerAndPOILayer:

(BOOL)	- getPoiTagEnable:

(void)	- setPoiTagEnable:poiTagType:

(void)	- addOverlay:

(void)	- addOverlays:

(void)	- removeOverlay:

(void)	- removeOverlays:

(void)	- insertOverlay:atIndex:

(void)	- exchangeOverlayAtIndex:withOverlayAtIndex:

(void)	- insertOverlay:aboveOverlay:

(void)	- insertOverlay:belowOverlay:

(nullable BMKOverlayView *)	- viewForOverlay:

(BOOL)	- showParticleEffect:

(void)	- closeParticleEffect:

(BOOL)	- customParticleEffect:option:

类方法
(void)	+ customMapStyle:

(void)	+ enableCustomMapStyle:

("废弃方法（空实现）,逻辑由地图SDK控制")	+ __deprecated_msg

("废弃方法（空实现）,逻辑由地图SDK控制")	+ __deprecated_msg

(BOOL)	+ setBaiduMapSDKMetalEnable:

(BOOL)	+ setBaiduMapSDKOverlayNewVersionEnable:

属性
id< BMKMapViewDelegate >	delegate
	地图View的Delegate

id< BMKMapGestureDelegate >	gestureDelegate
	地图View的手势Delegate

BMKMapType	mapType
	当前地图类型，可设定为标准地图、卫星地图

BMKMapLanguageType	languageType

UIColor *	backgroundColor

UIImage *	backgroundImage

BMKCoordinateRegion	region
	当前地图的经纬度范围，设定的该范围可能会被调整为适合地图窗口显示的范围

BMKCoordinateRegion	limitMapRegion
	限制地图的显示范围（地图状态改变时，该范围不会在地图显示范围外。设置成功后，会调整地图显示该范围）

CGPoint	compassPosition
	指南针的位置，设定坐标以BMKMapView左上角为原点，向右向下增长

CGSize	compassSize
	指南针的宽高

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

NSInteger	fontSizeLevel

float	zoomLevel
	地图比例尺级别，在手机上当前可使用的级别为4-21级

float	minZoomLevel
	地图的自定义最小比例尺级别

float	maxZoomLevel
	地图的自定义最大比例尺级别

int	rotation
	地图旋转角度，在手机上当前可使用的范围为－180～180度

int	overlooking
	地图俯视角度，在手机上当前可使用的范围为－45～0度

int	minOverlooking
	地图俯视角度最小值（即角度最大值），在手机上当前可设置的范围为-79～0度

BOOL	buildingsEnabled
	设定地图是否现显示3D楼块效果

BOOL	showMapPoi
	设定地图是否显示底图poi标注(不包含室内图标注)，默认YES

BOOL	trafficEnabled
	设定地图是否打开路况图层

BOOL	baiduHeatMapEnabled
	设定地图是否打开百度城市热力图图层（百度自有数据）,注：地图层级大于11时，可显示热力图

BOOL	gesturesEnabled
	设定地图View能否支持所有手势操作

BOOL	zoomEnabled
	设定地图View能否支持用户多点缩放(双指)

BOOL	zoomEnabledWithTap
	设定地图View能否支持用户缩放(双击或双指单击)

BOOL	scrollEnabled
	设定地图View能否支持用户移动地图

BOOL	overlookEnabled
	设定地图View能否支持俯仰角

BOOL	rotateEnabled
	设定地图View能否支持旋转

BOOL	forceTouchEnabled
	设定地图是否回调force touch事件，默认为NO，仅适用于支持3D Touch的情况，开启后会回调 - mapview:onForceTouch:force:maximumPossibleForce:

BOOL	gestureZoomAnimationEnabled
	设定地图手势缩放是否需要动画，默认YES，设置为NO时手势缩放时将无动画 since 6.5.2

BOOL	showMapScaleBar
	设定是否显式比例尺

CGPoint	mapScaleBarPosition
	比例尺的位置，设定坐标以BMKMapView左上角为原点，向右向下增长

CGSize	mapScaleBarSize
	比例尺的宽高

BMKLogoPosition	logoPosition
	logo位置，默认BMKLogoPositionLeftBottom

BMKMapRect	visibleMapRect
	当前地图范围，采用直角坐标系表示，向右向下增长

UIEdgeInsets	mapPadding

BOOL	updateTargetScreenPtWhenMapPaddingChanged
	设置mapPadding时，地图中心(屏幕坐标：BMKMapStatus.targetScreenPt)是否跟着改变，默认YES

BOOL	ChangeWithTouchPointCenterEnabled

BOOL	ChangeCenterWithDoubleTouchPointEnabled

BOOL	supportBackgroundDraw
	设置是否支持后台绘制,默认NO

NSArray< id< BMKAnnotation > > *	annotations
	当前地图View的已经添加的标注数组

BOOL	isSelectedAnnotationViewFront
	设定是否总让选中的annotaion置于最前面

BOOL	showHexagonHeatMap
	是否显示蜂窝热力图，默认YES，添加热力图后生效，since 6.6.0

BOOL	baseIndoorMapEnabled
	设定地图是否显示室内图（包含室内图标注），默认不显示

BOOL	showIndoorMapPoi
	设定室内图标注是否显示，默认YES，仅当显示室内图（baseIndoorMapEnabled为YES）时生效

BOOL	showsUserLocation
	设定是否显示定位图层

BMKUserTrackingMode	userTrackingMode
	设定定位模式，取值为：BMKUserTrackingMode

BOOL	userLocationVisible
	返回定位坐标点是否在当前地图可视区域内

BOOL	showOperateLayer
	地图是否展示运营图层默认YES，since 6.4.0

BOOL	showDEMLayer
	地图是否展示地形图层默认NO，since 6.5.9

NSArray< id< BMKOverlay > > *	overlays
	当前mapView中已经添加的Overlay数组

详细描述

地图View类，使用此View可以显示地图窗口，并且对地图进行相关的操作

函数文档

◆ __deprecated_msg [1/2]

+ ("废弃方法（空实现）,逻辑由地图SDK控制") __deprecated_msg

2.10.0起废弃，空实现，逻辑由地图SDK控制当应用即将后台时调用，停止一切调用opengl相关的操作。

◆ __deprecated_msg [2/2]

+ ("废弃方法（空实现）,逻辑由地图SDK控制") __deprecated_msg

2.10.0起废弃，空实现，逻辑由地图SDK控制当应用恢复前台状态时调用。

◆ addAnnotation:

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

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

参数

annotation 要添加的标注

由 category BMKMapView(AnnotationAPI) 提供.

◆ addAnnotations:

- (void) addAnnotations: (NSArray< id< BMKAnnotation > > *) annotations

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

参数

annotations 要添加的标注数组

由 category BMKMapView(AnnotationAPI) 提供.

◆ addHeatMap:

- (void) addHeatMap: (BMKHeatMap *) heatMap

添加热力图

参数

heatMap 热力图绘制和显示数据

由 category BMKMapView(HeatMapAPI) 提供.

◆ addHexagonHeatMap:

- (void) addHexagonHeatMap: (BMKHexagonHeatMap *) hexagonHeatMap

添加蜂窝热力图，since 6.6.0

由 category BMKMapView(HexagonHeatMapAPI) 提供.

◆ addOverlay:

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

向地图窗口添加Overlay，需要实现BMKMapViewDelegate的-mapView:viewForOverlay:函数来生成标注对应的View

参数

overlay 要添加的overlay

由 category BMKMapView(OverlaysAPI) 提供.

◆ addOverlays:

- (void) addOverlays: (NSArray< id< BMKOverlay > > *) overlays

向地图窗口添加一组Overlay，需要实现BMKMapViewDelegate的-mapView:viewForOverlay:函数来生成标注对应的View

参数

overlays 要添加的overlay数组

由 category BMKMapView(OverlaysAPI) 提供.

◆ annotationsInCoordinateBounds:

- (nullable NSArray< id< BMKAnnotation > > *) annotationsInCoordinateBounds: (BMKCoordinateBounds) bounds

获取矩形区域内的所有annotations

参数

bounds 矩形区域（经纬度）

由 category BMKMapView(AnnotationAPI) 提供.

◆ cleanCacheWithMapType:

- (void) cleanCacheWithMapType: (BMKMapType) type

清空地图缓存

◆ closeParticleEffect:

- (void) closeParticleEffect: (BMKMapParticleEffect) effect

关闭粒子效果，since 6.5.7

参数

effect 效果类型

由 category BMKMapView(ParticleEffect) 提供.

◆ convertCoordinate:toPointToView:

- (CGPoint) convertCoordinate:		(CLLocationCoordinate2D)	coordinate
toPointToView:		(UIView *)	view

将经纬度坐标转换为View坐标

参数

coordinate	待转换的经纬度坐标
view	指定相对的View

返回: 转换后的View坐标

◆ convertMapRect:toRectToView:

- (CGRect) convertMapRect:		(BMKMapRect)	mapRect
toRectToView:		(UIView *)	view

将直角地理坐标矩形区域转换为View矩形区域

参数

mapRect	待转换的直角地理坐标矩形
view	指定相对的View

返回: 转换后的View矩形区域

◆ convertPoint:toCoordinateFromView:

- (CLLocationCoordinate2D) convertPoint:		(CGPoint)	point
toCoordinateFromView:		(UIView *)	view

将View坐标转换成经纬度坐标

参数

point	待转换的View坐标
view	point坐标所在的view

返回: 转换后的经纬度坐标

◆ convertRect:toMapRectFromView:

- (BMKMapRect) convertRect:		(CGRect)	rect
toMapRectFromView:		(UIView *)	view

将View矩形区域转换成直角地理坐标矩形区域

参数

rect	待转换的View矩形区域
view	rect坐标所在的view

返回: 转换后的直角地理坐标矩形区域

◆ convertRect:toRegionFromView:

- (BMKCoordinateRegion) convertRect:		(CGRect)	rect
toRegionFromView:		(UIView *)	view

将View矩形区域转换成经纬度矩形区域

参数

rect	待转换的View矩形区域
view	rect坐标所在的view

返回: 转换后的经纬度矩形区域

◆ convertRegion:toRectToView:

- (CGRect) convertRegion:		(BMKCoordinateRegion)	region
toRectToView:		(UIView *)	view

将经纬度矩形区域转换为View矩形区域

参数

region	待转换的经纬度矩形
view	指定相对的View

返回: 转换后的View矩形区域

◆ customMapStyle:

+ (void) customMapStyle: ("Please use -(void)setCustomMapStyleEnable:(BOOL)enable") __deprecated_msg

设置自定义地图样式 since 6.0 空实现注：必须在BMKMapView对象初始化之前调用

参数

customMapStyleJsonFilePath 自定义样式文件所在路径，包含文件名

◆ customParticleEffect:option:

- (BOOL) customParticleEffect:		(BMKMapParticleEffect)	effect
option:		(BMKParticleEffectOption *)	option

自定义粒子效果，since 6.5.7

参数

effect	效果类型
option	自定义参数

由 category BMKMapView(ParticleEffect) 提供.

◆ dequeueReusableAnnotationViewWithIdentifier:

- (nullable BMKAnnotationView *) dequeueReusableAnnotationViewWithIdentifier: (NSString *) identifier

根据指定标识查找一个可被复用的标注View，一般在delegate中使用，用此函数来代替新申请一个View

参数

identifier 指定标识

返回: 返回可被复用的标注View

由 category BMKMapView(AnnotationAPI) 提供.

◆ deselectAnnotation:animated:

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

取消指定的标注的选中状态，本版暂不支持animate效果

参数

annotation	指定的标注
animated	本版暂不支持

由 category BMKMapView(AnnotationAPI) 提供.

◆ enableCustomMapStyle:

+ (void) enableCustomMapStyle: ("Please use -(void)setCustomMapStylePath:(NSString *)customMapStyleFilePath") __deprecated_msg

自定义地图样式开关，影响所有BMKMapView对象 since 6.0 空实现

参数

enable 自定义地图样式是否生效

◆ exchangeOverlayAtIndex:withOverlayAtIndex:

- (void) exchangeOverlayAtIndex:		(NSUInteger)	index1
withOverlayAtIndex:		(NSUInteger)	index2

在交换指定索引处的Overlay

参数

index1	索引1
index2	索引2

由 category BMKMapView(OverlaysAPI) 提供.

◆ fitVisibleMapRect:edgePadding:withAnimated:

- (void) fitVisibleMapRect:	(BMKMapRect)	mapRect
edgePadding:	(UIEdgeInsets)	insets
withAnimated:	(BOOL)	animate

根据当前mapView的窗口大小，预留insets指定的边界区域后，将mapRect指定的地理范围显示在剩余的区域内，并尽量充满

参数

mapRect	要显示的地图范围，用直角坐标系表示
insets	屏幕四周预留的边界大小（mapRect的内容不会显示在该边界范围内）
animate	是否采用动画效果

◆ getFocusedBaseIndoorMapInfo

- (nullable BMKBaseIndoorMapInfo *) getFocusedBaseIndoorMapInfo

获取当前聚焦的室内图信息

返回: 当前聚焦的室内图信息。没有聚焦的室内图，返回nil

由 category BMKMapView(IndoorMapAPI) 提供.

◆ getMapStatus

- (BMKMapStatus *) getMapStatus

获取地图状态

返回: 返回地图状态信息

◆ getMapStatusFromCoordinateRegion:edgePadding:

- (BMKMapStatus *) getMapStatusFromCoordinateRegion:		(BMKCoordinateRegion)	region
edgePadding:		(UIEdgeInsets)	insets

根据地理经纬度范围和边距计算BMKMapStatus

参数

region	地理范围
insets	边距

返回: BMKMapStatus

◆ getPoiTagEnable:

- (BOOL) getPoiTagEnable: (BMKPoiTagType) poiTagType

是否展示底图poi标签 since 6.5.5

返回: bool

由 category BMKMapView(MapLayerAPI) 提供.

◆ getProjectionMatrix

- (float *) getProjectionMatrix

获取OpenGL映射矩阵 V5.0.0版本新增，用于3D绘制场景

返回: OpenGL映射矩阵数组

◆ getViewMatrix

- (float *) getViewMatrix

获取OpenGL视图矩阵 V5.0.0版本新增，用于3D绘制场景

返回: OpenGL视图矩阵数组

◆ glPointForMapPoint:

- (CGPoint) glPointForMapPoint: (BMKMapPoint) mapPoint

将BMKMapPoint转换为opengles可以直接使用的坐标

参数

mapPoint BMKMapPoint坐标

返回: opengles 直接支持的坐标

◆ glPointsForMapPoints:count:

- (CGPoint *) glPointsForMapPoints:		(BMKMapPoint *)	mapPoints
count:		(NSUInteger)	count

批量将BMKMapPoint转换为opengles可以直接使用的坐标

参数

mapPoints	BMKMapPoint坐标数据指针
count	个数,count不能大于数组长度

返回: opengles 直接支持的坐标数据指针(需要调用者手动释放)

◆ insertOverlay:aboveOverlay:

- (void) insertOverlay:		(id< BMKOverlay >)	overlay
aboveOverlay:		(id< BMKOverlay >)	sibling

在指定的Overlay之上插入一个overlay

参数

overlay	待添加的Overlay
sibling	用于指定相对位置的Overlay

由 category BMKMapView(OverlaysAPI) 提供.

◆ insertOverlay:atIndex:

- (void) insertOverlay:		(id< BMKOverlay >)	overlay
atIndex:		(NSUInteger)	index

在指定的索引处添加一个Overlay

参数

overlay	待添加的overlay
index	指定的索引

由 category BMKMapView(OverlaysAPI) 提供.

◆ insertOverlay:belowOverlay:

- (void) insertOverlay:		(id< BMKOverlay >)	overlay
belowOverlay:		(id< BMKOverlay >)	sibling

在指定的Overlay之下插入一个overlay

参数

overlay	待添加的Overlay
sibling	用于指定相对位置的Overlay

由 category BMKMapView(OverlaysAPI) 提供.

◆ isSurpportBaiduHeatMap

- (BOOL) isSurpportBaiduHeatMap

判断当前图区是否支持百度热力图（百度自有数据）

返回: 支持返回YES，否则返回NO

◆ mapForceRefresh

- (void) mapForceRefresh

强制刷新mapview

◆ mapRectThatFits:

- (BMKMapRect) mapRectThatFits: ("此方法已废弃") __deprecated_msg

此方法什么都没做，已废弃

◆ mapRectThatFits:edgePadding:

- (BMKMapRect) mapRectThatFits:		(BMKMapRect)	mapRect
edgePadding:		(UIEdgeInsets)	insets

根据当前地图View的窗口大小调整传入的mapRect，返回适合当前地图窗口显示的mapRect，并且在该mapRect四周保留insets指定的边界区域

参数

mapRect	待调整的地理范围，采用直角坐标系表示
insets	mapRect四周要预留的边界大小

返回: 调整后适合当前地图窗口显示的地理范围，采用直角坐标系

◆ regionThatFits:

- (BMKCoordinateRegion) regionThatFits: ("此方法已废弃") __deprecated_msg

此接口什么都没做，已废弃。

◆ removeAnnotation:

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

移除标注

参数

annotation 要移除的标注

由 category BMKMapView(AnnotationAPI) 提供.

◆ removeAnnotations:

- (void) removeAnnotations: (NSArray< id< BMKAnnotation > > *) annotations

移除一组标注

参数

annotations 要移除的标注数组

由 category BMKMapView(AnnotationAPI) 提供.

◆ removeHeatMap

- (void) removeHeatMap

移除热力图

由 category BMKMapView(HeatMapAPI) 提供.

◆ removeHexagonHeatMap

- (void) removeHexagonHeatMap

删除蜂窝热力图，since 6.6.0

由 category BMKMapView(HexagonHeatMapAPI) 提供.

◆ removeOverlay:

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

移除Overlay

参数

overlay 要移除的overlay

由 category BMKMapView(OverlaysAPI) 提供.

◆ removeOverlays:

- (void) removeOverlays: (NSArray< id< BMKOverlay > > *) overlays

移除一组Overlay

参数

overlays 要移除的overlay数组

由 category BMKMapView(OverlaysAPI) 提供.

◆ screenPointFromMapPoint3:

- (CGPoint) screenPointFromMapPoint3: (BMKMapPoint3) mapPoint3

将三维地理坐标转化为屏幕坐标 since 6.5.2

参数

mapPoint3 三维地理坐标

返回: 屏幕坐标

◆ selectAnnotation:animated:

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

选中指定的标注，本版暂不支持animate效果

参数

annotation	指定的标注
animated	本版暂不支持

由 category BMKMapView(AnnotationAPI) 提供.

◆ setBaiduMapSDKMetalEnable:

+ (BOOL) setBaiduMapSDKMetalEnable: (BOOL) metalEnable

V6.5.2版本新增设置地图是否使用Metal绘制，请在创建BMKMapView前设置有效

◆ setBaiduMapSDKOverlayNewVersionEnable:

+ (BOOL) setBaiduMapSDKOverlayNewVersionEnable: (BOOL) newVersionEnable

V6.5.9版本新增设置地图覆盖物是否使用新版逻辑绘制，默认为YES，应用启动期间仅可设置一次

◆ setCenterCoordinate:animated:

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

设定地图中心点坐标

参数

coordinate	要设定的地图中心点坐标，用经纬度表示
animated	是否采用动画效果

◆ setCompassImage:

- (void) setCompassImage: (UIImage *) image

设置罗盘的图片

参数

image 设置的图片

◆ setCustomMapStyleEnable:

- (BOOL) setCustomMapStyleEnable: (BOOL) enable

V5.0.0版本新增,since V6.6.2,英文地图不再支持个性化地图个性化地图样式开关，仅影响当前BMKMapView对象，需在对象创建后调用

参数

enable 当前自定义地图样式是否生效

由 category BMKMapView(CustomMapAPI) 提供.

◆ setCustomMapStylePath:

- (BOOL) setCustomMapStylePath: (NSString *) customMapStyleFilePath

V5.0.0版本新增,since V6.6.2,英文地图不再支持个性化地图设置个性化地图样式路径，仅影响当前BMKMapView对象，需在对象创建后调用

参数

customMapStyleFilePath 本地个性化样式文件所在路径，包含文件名

由 category BMKMapView(CustomMapAPI) 提供.

◆ setCustomMapStylePath:mode:

- (BOOL) setCustomMapStylePath:		(NSString *)	customMapStyleFilePath
mode:		(int)	mode

V5.0.0版本新增,since V6.6.2,英文地图不再支持个性化地图设置个性化地图样式路径，仅影响当前BMKMapView对象，需在对象创建后调用

参数

customMapStyleFilePath	本地个性化样式文件所在路径，包含文件名
mode	加载模式，0:加载本地文件 1:加载在线文件或在线缓存文件

由 category BMKMapView(CustomMapAPI) 提供.

◆ setCustomMapStyleWithOption:preLoad:success:failure:

- (BOOL) setCustomMapStyleWithOption:	(BMKCustomMapStyleOption *)	option
preLoad:	(void(^)(NSString *_Nullable path))	preLoad
success:	(void(^)(NSString *path))	success
failure:	(void(^)(NSError error, NSString _Nullable path))	failure

V5.0.0版本新增,since V6.6.2,英文地图不再支持个性化地图在线个性化样式加载状态回调接口。在线个性化样式创建地址：http://lbsyun.baidu.com/apiconsole/custommap 调用该接口加载个性化样式的默认策略为：

1、优先通过BMKCustomMapStyleOption配置的个性化样式ID，加载在线个性化样式；
2、如果配置的个性化样式ID无效或在线个性化样式请求失败，则加载本地缓存的最新一次请求成功的在线个性化样式；
3、如果本地缓存中没有最新一次请求成功的在线个性化样式，则通过BMKCustomMapStyleOption中配置的本地离线样式路径加载本地样式

4、如果以上样式加载都失败，则显示普通地图样式。

参数

option	在线个性化样式配置选项
preLoad	当预加载成功时会执行的block对象，path：本地缓存的最新一次请求成功的在线个性化样式路径
success	当加载成功时会执行的block对象，path：请求成功的在线个性化样式路径
failure	当加载未成功时会执行的block对象，error：失败错误信息，path：失败后根据策略加载的个性化样式路径（路径可能会为nil）

由 category BMKMapView(CustomMapAPI) 提供.

◆ setCustomTrafficColorForSmooth:slow:congestion:severeCongestion:

- (BOOL) setCustomTrafficColorForSmooth:	(UIColor *)	smooth
slow:	(UIColor *)	slow
congestion:	(UIColor *)	congestion
severeCongestion:	(UIColor *)	severeCongestion

自定义路况颜色。注意：如果需要自定义路况颜色，必须4种路况全都设置。4个参数全部合法时，自定义颜色才有效；否则全部使用默认的。 since 6.0.0 暂不支持

参数

smooth	路况畅通对应的颜色
slow	路况缓行对应的颜色
congestion	路况拥堵对应的颜色
severeCongestion	路况严重拥堵对应的颜色

返回: 自定义颜色合法返回YES，非法返回NO

◆ setHeatMapFrameAnimationIndex:

- (void) setHeatMapFrameAnimationIndex: (NSInteger) index

控制渲染帧索引

由 category BMKMapView(HeatMapAPI) 提供.

◆ setMapCenterToScreenPt:

- (void) setMapCenterToScreenPt: (CGPoint) ptInScreen

设置地图中心点在地图中的屏幕坐标位置

参数

ptInScreen 要设定的地图中心点位置，为屏幕坐标，设置的中心点不能超过屏幕范围，否则无效

◆ setMapStatus:

- (void) setMapStatus: (BMKMapStatus *) mapStatus

设置地图状态

参数

mapStatus 地图状态信息

◆ setMapStatus:withAnimation:

- (void) setMapStatus:		(BMKMapStatus *)	mapStatus
withAnimation:		(BOOL)	bAnimation

设置地图状态

参数

mapStatus	地图状态信息
bAnimation	是否需要动画效果，true:需要做动画

◆ setMapStatus:withAnimation:withAnimationTime:

- (void) setMapStatus:	(BMKMapStatus *)	mapStatus
withAnimation:	(BOOL)	bAnimation
withAnimationTime:	(int)	ulDuration

设置地图状态

参数

mapStatus	地图状态信息
bAnimation	是否需要动画效果，true:需要做动画
ulDuration	指定动画时间，单位：ms

◆ setPoiTagEnable:poiTagType:

- (void) setPoiTagEnable:		(BOOL)	enable
poiTagType:		(BMKPoiTagType)	poiTagType

是否展示底图poi标签 since 6.5.5

参数

enable	是否展示
poiTagType	标签类别

由 category BMKMapView(MapLayerAPI) 提供.

◆ setRegion:animated:

- (void) setRegion:		(BMKCoordinateRegion)	region
animated:		(BOOL)	animated

设定当前地图的显示范围

参数

region	要设定的地图范围，用经纬度的方式表示
animated	是否采用动画效果

◆ setVisibleMapRect:animated:

- (void) setVisibleMapRect:		(BMKMapRect)	mapRect
animated:		(BOOL)	animate

设定当前地图的显示范围,采用直角坐标系表示

参数

mapRect	要设定的地图范围，用直角坐标系表示
animate	是否采用动画效果

◆ setVisibleMapRect:edgePadding:animated:

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

设定地图的显示范围,并使mapRect四周保留insets指定的边界区域

参数

mapRect	要设定的地图范围，用直角坐标系表示
insets	指定的四周边界大小
animate	是否采用动画效果

◆ showAnnotations:animated:

- (void) showAnnotations:		(NSArray< id< BMKAnnotation > > *)	annotations
animated:		(BOOL)	animated

设置地图使显示区域显示所有annotations,如果数组中只有一个则直接设置地图中心为annotation的位置

参数

annotations	指定的标注
animated	是否启动动画

由 category BMKMapView(AnnotationAPI) 提供.

◆ showAnnotations:padding:animated:

- (void) showAnnotations:	(NSArray< id< BMKAnnotation > > *)	annotations
padding:	(UIEdgeInsets)	padding
animated:	(BOOL)	animated

设置地图使显示区域显示所有annotations,如果数组中只有一个则直接设置地图中心为annotation的位置,since 6.5.7

参数

annotations	指定的标注
padding	适配边界
animated	是否启动动画

由 category BMKMapView(AnnotationAPI) 提供.

◆ showParticleEffect:

- (BOOL) showParticleEffect: (BMKMapParticleEffect) effect

显示粒子效果，since 6.5.7

参数

effect 效果类型

返回: 成功返回YES，否则NO

由 category BMKMapView(ParticleEffect) 提供.

◆ startHeatMapFrameAnimation

- (void) startHeatMapFrameAnimation

开始动画

由 category BMKMapView(HeatMapAPI) 提供.

◆ stopHeatMapFrameAnimation

- (void) stopHeatMapFrameAnimation

暂停动画

由 category BMKMapView(HeatMapAPI) 提供.

◆ switchBaseIndoorMapFloor:withID:

- (BMKSwitchIndoorFloorError) switchBaseIndoorMapFloor:		(NSString *)	strFloor
withID:		(NSString *)	strID

设置室内图楼层

参数

strFloor	楼层
strID	室内图ID

返回: 切换结果错误码

由 category BMKMapView(IndoorMapAPI) 提供.

◆ switchLayerOrder:otherLayer:

- (BOOL) switchLayerOrder:		(BMKLayerType)	layer
otherLayer:		(BMKLayerType)	otherLayer

地图交换图层顺序 since 6.5.9

参数

layer	其中一个图层
otherLayer	另一个图层

返回: 成功返回YES，否则返回NO

由 category BMKMapView(MapLayerAPI) 提供.

◆ switchOverlayLayerAndNavigationLayer:

- (BOOL) switchOverlayLayerAndNavigationLayer: (BOOL) isSwitch

地图overlay图层与导航图层交换位置 since 6.5.0

参数

isSwitch YES 交换位置， NO 复原位置

返回: 成功返回YES，否则返回NO

由 category BMKMapView(MapLayerAPI) 提供.

◆ switchOverlayLayerAndPOILayer:

- (BOOL) switchOverlayLayerAndPOILayer: (BOOL) isSwitch

地图overlay图层与POI图层交换位置 since 6.5.0 用于将自定义覆盖物绘制在POI图层之下（例如：解决Polyline绘制遮挡道路名称问题）注意：addOverlay后调用此方法

参数

isSwitch YES 交换位置， NO 复原位置

返回: 成功返回YES，否则返回NO

由 category BMKMapView(MapLayerAPI) 提供.

◆ takeSnapshot

- (nullable UIImage *) takeSnapshot

获得地图当前可视区域截图

返回: 返回view范围内的截取的UIImage

◆ takeSnapshot:

- (nullable UIImage *) takeSnapshot: (CGRect) rect

获得地图区域区域截图

返回: 返回指定区域的截取的UIImage

◆ updateHeatMap:

- (void) updateHeatMap: (BMKHeatMap *) heatMap

更新热力图

参数

heatMap 热力图绘制和显示数据注意：更新时会重置动画

由 category BMKMapView(HeatMapAPI) 提供.

◆ updateLocationData:

- (void) updateLocationData: (BMKUserLocation *) userLocation

动态更新我的位置数据

参数

userLocation 定位数据

由 category BMKMapView(LocationViewAPI) 提供.

◆ updateLocationViewWithParam:

- (void) updateLocationViewWithParam: (BMKLocationViewDisplayParam *) locationViewDisplayParam

动态定制我的位置样式

参数

locationViewDisplayParam 样式参数

由 category BMKMapView(LocationViewAPI) 提供.

◆ viewForAnnotation:

- (nullable BMKAnnotationView *) viewForAnnotation: (id< BMKAnnotation >) annotation

查找指定标注对应的View，如果该标注尚未显示，返回nil

参数

annotation 指定的标注

返回: 指定标注对应的View

由 category BMKMapView(AnnotationAPI) 提供.

◆ viewForOverlay:

- (nullable BMKOverlayView *) viewForOverlay: (id< BMKOverlay >) overlay

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

参数

overlay 指定的overlay 指定overlay对应的View

由 category BMKMapView(OverlaysAPI) 提供.

◆ viewWillAppear

- (void) viewWillAppear

当mapview即将被显式的时候调用，恢复之前存储的mapview状态。

◆ viewWillDisappear

- (void) viewWillDisappear

当mapview即将被隐藏的时候调用，存储当前mapview的状态。

◆ zoomIn

- (BOOL) zoomIn

放大一级比例尺

返回: 是否成功

◆ zoomOut

- (BOOL) zoomOut

缩小一级比例尺

返回: 是否成功

属性说明

◆ annotations

- (NSArray<id <BMKAnnotation> >*) annotations

readnonatomiccopy

当前地图View的已经添加的标注数组

由 category BMKMapView(AnnotationAPI) 提供.

◆ backgroundColor

- (UIColor*) backgroundColor

readwritenonatomicstrong

空白地图的背景色 since 6.5.4 默认白色

◆ backgroundImage

- (UIImage*) backgroundImage

readwritenonatomicstrong

自定义底图加载时的背景网格图片，仅支持png格式 since 6.5.9 默认为背景网格图片注：图片不得大于500KB，像素过大时，务必压缩图片后再设置，避免渲染损耗过多性能导致地图卡顿。

◆ baiduHeatMapEnabled

- (BOOL) baiduHeatMapEnabled

readwritenonatomicassign

设定地图是否打开百度城市热力图图层（百度自有数据）,注：地图层级大于11时，可显示热力图

◆ baseIndoorMapEnabled

- (BOOL) baseIndoorMapEnabled

readwritenonatomicassign

设定地图是否显示室内图（包含室内图标注），默认不显示

由 category BMKMapView(IndoorMapAPI) 提供.

◆ buildingsEnabled

- (BOOL) buildingsEnabled

readwritenonatomicassign

设定地图是否现显示3D楼块效果

◆ centerCoordinate

- (CLLocationCoordinate2D) centerCoordinate

readwritenonatomicassign

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

◆ ChangeCenterWithDoubleTouchPointEnabled

- (BOOL) ChangeCenterWithDoubleTouchPointEnabled

readwritenonatomicassign

设定双击手势放大地图时，BMKMapView的放大效果的中心点。设置为YES时，以双击的位置为中心点进行放大，地图中心点会改变；设置为NO时，以当前地图的中心点为中心进行放大，地图中心点不变；默认值为YES。

◆ ChangeWithTouchPointCenterEnabled

- (BOOL) ChangeWithTouchPointCenterEnabled

readwritenonatomicassign

设定双指手势操作时，BMKMapView的旋转和缩放效果的中心点。设置为YES时，以手势的中心点（二个指头的中心点）为中心进行旋转和缩放，地图中心点会改变；设置为NO时，以当前地图的中心点为中心进行旋转和缩放，地图中心点不变；默认值为NO。

◆ compassPosition

- (CGPoint) compassPosition

readwritenonatomicassign

指南针的位置，设定坐标以BMKMapView左上角为原点，向右向下增长

◆ compassSize

- (CGSize) compassSize

readnonatomicassign

指南针的宽高

◆ delegate

- (id<BMKMapViewDelegate>) delegate

readwritenonatomicweak

地图View的Delegate

◆ fontSizeLevel

- (NSInteger) fontSizeLevel

readwritenonatomicassign

设置地图字体大小 since 6.3.0 共4个级别(0: 小, 1: 标准, 2: 大, 3: 特大) 默认1

◆ forceTouchEnabled

- (BOOL) forceTouchEnabled

readwritenonatomicassign

设定地图是否回调force touch事件，默认为NO，仅适用于支持3D Touch的情况，开启后会回调 - mapview:onForceTouch:force:maximumPossibleForce:

◆ gestureDelegate

- (id<BMKMapGestureDelegate>) gestureDelegate

readwritenonatomicweak

地图View的手势Delegate

◆ gesturesEnabled

- (BOOL) gesturesEnabled

readwritenonatomicassign

设定地图View能否支持所有手势操作

◆ gestureZoomAnimationEnabled

- (BOOL) gestureZoomAnimationEnabled

readwritenonatomicassign

设定地图手势缩放是否需要动画，默认YES，设置为NO时手势缩放时将无动画 since 6.5.2

◆ isSelectedAnnotationViewFront

- (BOOL) isSelectedAnnotationViewFront

readwritenonatomicassign

设定是否总让选中的annotaion置于最前面

由 category BMKMapView(AnnotationAPI) 提供.

◆ languageType

- (BMKMapLanguageType) languageType

readwritenonatomicassign

地图底图语言类型（暂不支持多地图）since 6.4.0 kBMKMapLanguageChinese: 中文地图； kBMKMapLanguageEnglish: 英文地图默认kBMKMapLanguageChinese中文地图；注意：since V6.6.2,因英文地图不支持个性化地图，英文地图切换后中文地图需要重新设置个性化地图文件

◆ limitMapRegion

- (BMKCoordinateRegion) limitMapRegion

readwritenonatomicassign

限制地图的显示范围（地图状态改变时，该范围不会在地图显示范围外。设置成功后，会调整地图显示该范围）

◆ logoPosition

- (BMKLogoPosition) logoPosition

readwritenonatomicassign

logo位置，默认BMKLogoPositionLeftBottom

◆ mapPadding

- (UIEdgeInsets) mapPadding

readwritenonatomicassign

地图预留边界，默认：UIEdgeInsetsZero。注：设置后，会根据mapPadding调整logo、比例尺、指南针的位置。当updateTargetScreenPtWhenMapPaddingChanged==YES时，地图中心(屏幕坐标：BMKMapStatus.targetScreenPt)跟着改变

◆ mapScaleBarPosition

- (CGPoint) mapScaleBarPosition

readwritenonatomicassign

比例尺的位置，设定坐标以BMKMapView左上角为原点，向右向下增长

◆ mapScaleBarSize

- (CGSize) mapScaleBarSize

readnonatomicassign

比例尺的宽高

◆ mapType

- (BMKMapType) mapType

readwritenonatomicassign

当前地图类型，可设定为标准地图、卫星地图

◆ maxZoomLevel

- (float) maxZoomLevel

readwritenonatomicassign

地图的自定义最大比例尺级别

◆ minOverlooking

- (int) minOverlooking

readwritenonatomicassign

地图俯视角度最小值（即角度最大值），在手机上当前可设置的范围为-79～0度

◆ minZoomLevel

- (float) minZoomLevel

readwritenonatomicassign

地图的自定义最小比例尺级别

◆ overlays

- (NSArray<id <BMKOverlay> >*) overlays

readnonatomiccopy

当前mapView中已经添加的Overlay数组

由 category BMKMapView(OverlaysAPI) 提供.

◆ overlookEnabled

- (BOOL) overlookEnabled

readwritenonatomicassign

设定地图View能否支持俯仰角

◆ overlooking

- (int) overlooking

readwritenonatomicassign

地图俯视角度，在手机上当前可使用的范围为－45～0度

◆ region

- (BMKCoordinateRegion) region

readwritenonatomicassign

当前地图的经纬度范围，设定的该范围可能会被调整为适合地图窗口显示的范围

◆ rotateEnabled

- (BOOL) rotateEnabled

readwritenonatomicassign

设定地图View能否支持旋转

◆ rotation

- (int) rotation

readwritenonatomicassign

地图旋转角度，在手机上当前可使用的范围为－180～180度

◆ scrollEnabled

- (BOOL) scrollEnabled

readwritenonatomicassign

设定地图View能否支持用户移动地图

◆ showDEMLayer

- (BOOL) showDEMLayer

readwritenonatomicassign

地图是否展示地形图层默认NO，since 6.5.9

由 category BMKMapView(MapLayerAPI) 提供.

◆ showHexagonHeatMap

- (BOOL) showHexagonHeatMap

readwritenonatomicassign

是否显示蜂窝热力图，默认YES，添加热力图后生效，since 6.6.0

由 category BMKMapView(HexagonHeatMapAPI) 提供.

◆ showIndoorMapPoi

- (BOOL) showIndoorMapPoi

readwritenonatomicassign

设定室内图标注是否显示，默认YES，仅当显示室内图（baseIndoorMapEnabled为YES）时生效

由 category BMKMapView(IndoorMapAPI) 提供.

◆ showMapPoi

- (BOOL) showMapPoi

readwritenonatomicassign

设定地图是否显示底图poi标注(不包含室内图标注)，默认YES

◆ showMapScaleBar

- (BOOL) showMapScaleBar

readwritenonatomicassign

设定是否显式比例尺

◆ showOperateLayer

- (BOOL) showOperateLayer

readwritenonatomicassign

地图是否展示运营图层默认YES，since 6.4.0

由 category BMKMapView(MapLayerAPI) 提供.

◆ showsUserLocation

- (BOOL) showsUserLocation

readwritenonatomicassign

设定是否显示定位图层

由 category BMKMapView(LocationViewAPI) 提供.

◆ supportBackgroundDraw

- (BOOL) supportBackgroundDraw

readwritenonatomicassign

设置是否支持后台绘制,默认NO

◆ trafficEnabled

- (BOOL) trafficEnabled

readwritenonatomicassign

设定地图是否打开路况图层

◆ updateTargetScreenPtWhenMapPaddingChanged

- (BOOL) updateTargetScreenPtWhenMapPaddingChanged

readwritenonatomicassign

设置mapPadding时，地图中心(屏幕坐标：BMKMapStatus.targetScreenPt)是否跟着改变，默认YES

◆ userLocationVisible

- (BOOL) userLocationVisible

readnonatomicassign

返回定位坐标点是否在当前地图可视区域内

由 category BMKMapView(LocationViewAPI) 提供.

◆ userTrackingMode

- (BMKUserTrackingMode) userTrackingMode

readwritenonatomicassign

设定定位模式，取值为：BMKUserTrackingMode

由 category BMKMapView(LocationViewAPI) 提供.

◆ visibleMapRect

- (BMKMapRect) visibleMapRect

readwritenonatomicassign

当前地图范围，采用直角坐标系表示，向右向下增长

◆ zoomEnabled

- (BOOL) zoomEnabled

readwritenonatomicassign

设定地图View能否支持用户多点缩放(双指)

◆ zoomEnabledWithTap

- (BOOL) zoomEnabledWithTap

readwritenonatomicassign

设定地图View能否支持用户缩放(双击或双指单击)

◆ zoomLevel

- (float) zoomLevel

readwritenonatomicassign

地图比例尺级别，在手机上当前可使用的级别为4-21级

该类的文档由以下文件生成:

BaiduMapAPI_Map.framework/Headers/BMKMapView.h

构造函数

类方法

属性

详细描述

函数文档

◆ __deprecated_msg [1/2]

◆ __deprecated_msg [2/2]

◆ addAnnotation:

◆ addAnnotations:

◆ addHeatMap:

◆ addHexagonHeatMap:

◆ addOverlay:

◆ addOverlays:

◆ annotationsInCoordinateBounds:

◆ cleanCacheWithMapType:

◆ closeParticleEffect:

◆ convertCoordinate:toPointToView:

◆ convertMapRect:toRectToView:

◆ convertPoint:toCoordinateFromView:

◆ convertRect:toMapRectFromView:

◆ convertRect:toRegionFromView:

◆ convertRegion:toRectToView:

◆ customMapStyle:

◆ customParticleEffect:option:

◆ dequeueReusableAnnotationViewWithIdentifier:

◆ deselectAnnotation:animated:

◆ enableCustomMapStyle:

◆ exchangeOverlayAtIndex:withOverlayAtIndex:

◆ fitVisibleMapRect:edgePadding:withAnimated:

◆ getFocusedBaseIndoorMapInfo

◆ getMapStatus

◆ getMapStatusFromCoordinateRegion:edgePadding:

◆ getPoiTagEnable:

◆ getProjectionMatrix

◆ getViewMatrix

◆ glPointForMapPoint:

◆ glPointsForMapPoints:count:

◆ insertOverlay:aboveOverlay:

◆ insertOverlay:atIndex:

◆ insertOverlay:belowOverlay:

◆ isSurpportBaiduHeatMap

◆ mapForceRefresh

◆ mapRectThatFits:

◆ mapRectThatFits:edgePadding:

◆ regionThatFits:

◆ removeAnnotation:

◆ removeAnnotations:

◆ removeHeatMap

◆ removeHexagonHeatMap

◆ removeOverlay:

◆ removeOverlays:

◆ screenPointFromMapPoint3:

◆ selectAnnotation:animated:

◆ setBaiduMapSDKMetalEnable:

◆ setBaiduMapSDKOverlayNewVersionEnable:

◆ setCenterCoordinate:animated:

◆ setCompassImage:

◆ setCustomMapStyleEnable:

◆ setCustomMapStylePath:

◆ setCustomMapStylePath:mode:

◆ setCustomMapStyleWithOption:preLoad:success:failure:

◆ setCustomTrafficColorForSmooth:slow:congestion:severeCongestion:

◆ setHeatMapFrameAnimationIndex:

◆ setMapCenterToScreenPt:

◆ setMapStatus:

◆ setMapStatus:withAnimation:

◆ setMapStatus:withAnimation:withAnimationTime:

◆ setPoiTagEnable:poiTagType:

◆ setRegion:animated:

◆ setVisibleMapRect:animated:

◆ setVisibleMapRect:edgePadding:animated:

◆ showAnnotations:animated:

◆ showAnnotations:padding:animated:

◆ showParticleEffect:

◆ startHeatMapFrameAnimation

◆ stopHeatMapFrameAnimation

◆ switchBaseIndoorMapFloor:withID:

◆ switchLayerOrder:otherLayer:

◆ switchOverlayLayerAndNavigationLayer:

◆ switchOverlayLayerAndPOILayer: