百度地图SDK for iOS v4.1.1 类参考
BMKMapView.h
1 /*
2  * BMKMapView.h
3  * BMapKit
4  *
5  * Copyright 2011 Baidu Inc. All rights reserved.
6  *
7  */
8 #import <BaiduMapAPI_Base/BMKBaseComponent.h>
9 #import "BMKAnnotation.h"
10 #import "BMKAnnotationView.h"
11 #import "BMKOverlayView.h"
12 #import "UIKit/UIKit.h"
13 #import "BMKMapStatus.h"
14 #import "BMKLocationViewDisplayParam.h"
15 #import "BMKHeatMap.h"
16 #import "BMKBaseIndoorMapInfo.h"
17 
18 @protocol BMKMapViewDelegate;
19 
21 @interface BMKMapPoi : NSObject
23 @property (nonatomic,strong) NSString* text;
25 @property (nonatomic,assign) CLLocationCoordinate2D pt;
27 @property (nonatomic,strong) NSString* uid;
28 @end
29 
30 typedef enum {
31  BMKUserTrackingModeNone = 0,
32  BMKUserTrackingModeHeading,
33  BMKUserTrackingModeFollow,
34  BMKUserTrackingModeFollowWithHeading,
35 } BMKUserTrackingMode;
36 
38 typedef enum {
39  BMKLogoPositionLeftBottom = 0,
40  BMKLogoPositionLeftTop,
41  BMKLogoPositionCenterBottom,
42  BMKLogoPositionCenterTop,
43  BMKLogoPositionRightBottom,
44  BMKLogoPositionRightTop,
45 } BMKLogoPosition;
46 
48 typedef enum {
49  BMKSwitchIndoorFloorSuccess = 0,
50  BMKSwitchIndoorFloorFailed,
51  BMKSwitchIndoorFloorNotFocused,
52  BMKSwitchIndoorFloorNotExist,
53 } BMKSwitchIndoorFloorError;
54 
56 @interface BMKMapView : UIView
57 
59 @property (nonatomic, weak) id<BMKMapViewDelegate> delegate;
60 
62 @property (nonatomic) BMKMapType mapType;
63 
65 @property (nonatomic) BMKCoordinateRegion region;
66 
68 @property (nonatomic) BMKCoordinateRegion limitMapRegion;
69 
71 @property (nonatomic) CGPoint compassPosition;
73 @property (nonatomic, readonly) CGSize compassSize;
74 
76 @property (nonatomic) CLLocationCoordinate2D centerCoordinate;
77 
79 @property (nonatomic) float zoomLevel;
81 @property (nonatomic) float minZoomLevel;
83 @property (nonatomic) float maxZoomLevel;
84 
86 @property (nonatomic) int rotation;
87 
89 @property (nonatomic) int overlooking;
91 @property(nonatomic, getter=isBuildingsEnabled) BOOL buildingsEnabled;
93 @property(nonatomic, assign) BOOL showMapPoi;
95 @property(nonatomic, getter=isTrafficEnabled) BOOL trafficEnabled;
97 @property(nonatomic, getter=isBaiduHeatMapEnabled) BOOL baiduHeatMapEnabled;
98 
100 @property(nonatomic) BOOL gesturesEnabled;
102 @property(nonatomic, getter=isZoomEnabled) BOOL zoomEnabled;
104 @property(nonatomic, getter=isZoomEnabledWithTap) BOOL zoomEnabledWithTap;
106 @property(nonatomic, getter=isScrollEnabled) BOOL scrollEnabled;
108 @property(nonatomic, getter=isOverlookEnabled) BOOL overlookEnabled;
110 @property(nonatomic, getter=isRotateEnabled) BOOL rotateEnabled;
111 
113 @property(nonatomic) BOOL forceTouchEnabled;
114 
116 @property (nonatomic) BOOL showMapScaleBar;
117 
119 @property (nonatomic) CGPoint mapScaleBarPosition;
120 
122 @property (nonatomic, readonly) CGSize mapScaleBarSize;
123 
125 @property (nonatomic) BMKLogoPosition logoPosition;
126 
128 @property (nonatomic) BMKMapRect visibleMapRect;
129 
135 @property (nonatomic) UIEdgeInsets mapPadding;
137 @property (nonatomic) BOOL updateTargetScreenPtWhenMapPaddingChanged;
138 
145 @property(nonatomic, getter=isChangeWithTouchPointCenterEnabled) BOOL ChangeWithTouchPointCenterEnabled;
146 
153 @property(nonatomic, getter=isChangeCenterWithDoubleTouchPointEnabled) BOOL ChangeCenterWithDoubleTouchPointEnabled;
154 
160 + (void)customMapStyle:(NSString*) customMapStyleJsonFilePath;
165 + (void)enableCustomMapStyle:(BOOL) enable;
166 
176 - (BOOL)setCustomTrafficColorForSmooth:(UIColor *)smooth slow:(UIColor *)slow congestion:(UIColor *)congestion severeCongestion:(UIColor *)severeCongestion;
177 
183 +(void)willBackGround __deprecated_msg("废弃方法(空实现),逻辑由地图SDK控制");
189 +(void)didForeGround __deprecated_msg("废弃方法(空实现),逻辑由地图SDK控制");
193 -(void)viewWillAppear;
194 
198 -(void)viewWillDisappear;
199 
203 - (void)mapForceRefresh;
204 
209 - (BOOL)zoomIn;
210 
215 - (BOOL)zoomOut;
216 
222 - (BMKCoordinateRegion)regionThatFits:(BMKCoordinateRegion)region;
223 
229 - (void)setRegion:(BMKCoordinateRegion)region animated:(BOOL)animated;
230 
236 - (void)setCenterCoordinate:(CLLocationCoordinate2D)coordinate animated:(BOOL)animated;
237 
242 -(UIImage*) takeSnapshot;
243 
248 -(UIImage*) takeSnapshot:(CGRect)rect;
249 
254 - (void)setCompassImage:(UIImage *)image;
255 
261 - (void)setVisibleMapRect:(BMKMapRect)mapRect animated:(BOOL)animate;
262 
268 - (BMKMapRect)mapRectThatFits:(BMKMapRect)mapRect;
269 
276 - (void)setVisibleMapRect:(BMKMapRect)mapRect edgePadding:(UIEdgeInsets)insets animated:(BOOL)animate;
277 
284 - (void)fitVisibleMapRect:(BMKMapRect)mapRect edgePadding:(UIEdgeInsets)insets withAnimated:(BOOL)animate;
285 
292 - (BMKMapRect)mapRectThatFits:(BMKMapRect)mapRect edgePadding:(UIEdgeInsets)insets;
293 
300 - (CGPoint)convertCoordinate:(CLLocationCoordinate2D)coordinate toPointToView:(UIView *)view;
301 
308 - (CLLocationCoordinate2D)convertPoint:(CGPoint)point toCoordinateFromView:(UIView *)view;
309 
316 - (CGRect)convertRegion:(BMKCoordinateRegion)region toRectToView:(UIView *)view;
317 
324 - (BMKCoordinateRegion)convertRect:(CGRect)rect toRegionFromView:(UIView *)view;
325 
332 - (CGRect)convertMapRect:(BMKMapRect)mapRect toRectToView:(UIView *)view;
333 
340 - (BMKMapRect)convertRect:(CGRect)rect toMapRectFromView:(UIView *)view;
341 
347 - (CGPoint)glPointForMapPoint:(BMKMapPoint)mapPoint;
348 
355 - (CGPoint *)glPointsForMapPoints:(BMKMapPoint *)mapPoints count:(NSUInteger)count;
356 
361 - (void)setMapCenterToScreenPt:(CGPoint)ptInScreen;
362 
367 - (BMKMapStatus*)getMapStatus;
368 
373 - (void)setMapStatus:(BMKMapStatus*)mapStatus;
374 
380 - (void)setMapStatus:(BMKMapStatus*)mapStatus withAnimation:(BOOL)bAnimation;
381 
388 - (void)setMapStatus:(BMKMapStatus*)mapStatus withAnimation:(BOOL)bAnimation withAnimationTime:(int)ulDuration;
389 
394 - (BOOL)isSurpportBaiduHeatMap;
395 
396 @end
397 
399 
401 @property (nonatomic, assign) BOOL baseIndoorMapEnabled;
402 
404 @property (nonatomic, assign) BOOL showIndoorMapPoi;
405 
412 - (BMKSwitchIndoorFloorError)switchBaseIndoorMapFloor:(NSString*)strFloor withID:(NSString*)strID;
413 
418 - (BMKBaseIndoorMapInfo*)getFocusedBaseIndoorMapInfo;
419 
420 @end
421 
423 
425 @property (nonatomic) BOOL showsUserLocation;
426 
428 @property (nonatomic) BMKUserTrackingMode userTrackingMode;
429 
431 @property (nonatomic, readonly, getter=isUserLocationVisible) BOOL userLocationVisible;
432 
437 - (void)updateLocationViewWithParam:(BMKLocationViewDisplayParam*)locationViewDisplayParam;
438 
443 -(void)updateLocationData:(BMKUserLocation*)userLocation;
444 @end
445 
447 
449 @property (nonatomic, readonly) NSArray *annotations;
450 
451 //设定是否总让选中的annotaion置于最前面
452 @property (nonatomic, assign) BOOL isSelectedAnnotationViewFront;
453 
458 - (void)addAnnotation:(id <BMKAnnotation>)annotation;
459 
464 - (void)addAnnotations:(NSArray *)annotations;
465 
470 - (void)removeAnnotation:(id <BMKAnnotation>)annotation;
471 
476 - (void)removeAnnotations:(NSArray *)annotations;
477 
483 - (BMKAnnotationView *)viewForAnnotation:(id <BMKAnnotation>)annotation;
484 
490 - (BMKAnnotationView *)dequeueReusableAnnotationViewWithIdentifier:(NSString *)identifier;
491 
497 - (void)selectAnnotation:(id <BMKAnnotation>)annotation animated:(BOOL)animated;
498 
504 - (void)deselectAnnotation:(id <BMKAnnotation>)annotation animated:(BOOL)animated;
505 
511 - (void)showAnnotations:(NSArray *)annotations animated:(BOOL)animated;
512 
518 - (NSArray *)annotationsInCoordinateBounds:(BMKCoordinateBounds) bounds;
519 
520 @end
523 
528 - (void)addOverlay:(id <BMKOverlay>)overlay;
529 
534 - (void)addOverlays:(NSArray *)overlays;
535 
540 - (void)removeOverlay:(id <BMKOverlay>)overlay;
541 
546 - (void)removeOverlays:(NSArray *)overlays;
547 
553 - (void)insertOverlay:(id <BMKOverlay>)overlay atIndex:(NSUInteger)index;
554 
560 - (void)exchangeOverlayAtIndex:(NSUInteger)index1 withOverlayAtIndex:(NSUInteger)index2;
561 
567 - (void)insertOverlay:(id <BMKOverlay>)overlay aboveOverlay:(id <BMKOverlay>)sibling;
568 
574 - (void)insertOverlay:(id <BMKOverlay>)overlay belowOverlay:(id <BMKOverlay>)sibling;
575 
577 @property (nonatomic, readonly) NSArray *overlays;
578 
584 - (BMKOverlayView *)viewForOverlay:(id <BMKOverlay>)overlay;
585 
586 @end
588 
593 - (void)addHeatMap:(BMKHeatMap*)heatMap;
594 
598 - (void)removeHeatMap;
599 
600 @end
601 
603 @protocol BMKMapViewDelegate <NSObject>
604 @optional
605 
610 - (void)mapViewDidFinishLoading:(BMKMapView *)mapView;
611 
616 - (void)mapViewDidFinishRendering:(BMKMapView *)mapView;
617 
623 - (void)mapView:(BMKMapView *)mapView onDrawMapFrame:(BMKMapStatus*)status;
624 
630 - (void)mapView:(BMKMapView *)mapView regionWillChangeAnimated:(BOOL)animated;
631 
637 - (void)mapView:(BMKMapView *)mapView regionDidChangeAnimated:(BOOL)animated;
638 
645 - (BMKAnnotationView *)mapView:(BMKMapView *)mapView viewForAnnotation:(id <BMKAnnotation>)annotation;
646 
652 - (void)mapView:(BMKMapView *)mapView didAddAnnotationViews:(NSArray *)views;
653 
659 - (void)mapView:(BMKMapView *)mapView didSelectAnnotationView:(BMKAnnotationView *)view;
660 
666 - (void)mapView:(BMKMapView *)mapView didDeselectAnnotationView:(BMKAnnotationView *)view;
667 
675 - (void)mapView:(BMKMapView *)mapView annotationView:(BMKAnnotationView *)view didChangeDragState:(BMKAnnotationViewDragState)newState
676  fromOldState:(BMKAnnotationViewDragState)oldState;
677 
683 - (void)mapView:(BMKMapView *)mapView annotationViewForBubble:(BMKAnnotationView *)view;
684 
691 - (BMKOverlayView *)mapView:(BMKMapView *)mapView viewForOverlay:(id <BMKOverlay>)overlay;
692 
698 - (void)mapView:(BMKMapView *)mapView didAddOverlayViews:(NSArray *)overlayViews;
699 
705 - (void)mapView:(BMKMapView *)mapView onClickedBMKOverlayView:(BMKOverlayView *)overlayView;
706 
712 - (void)mapView:(BMKMapView *)mapView onClickedMapPoi:(BMKMapPoi*)mapPoi;
713 
719 - (void)mapView:(BMKMapView *)mapView onClickedMapBlank:(CLLocationCoordinate2D)coordinate;
720 
726 - (void)mapview:(BMKMapView *)mapView onDoubleClick:(CLLocationCoordinate2D)coordinate;
727 
733 - (void)mapview:(BMKMapView *)mapView onLongClick:(CLLocationCoordinate2D)coordinate;
734 
742 - (void)mapview:(BMKMapView *)mapView onForceTouch:(CLLocationCoordinate2D)coordinate force:(CGFloat)force maximumPossibleForce:(CGFloat)maximumPossibleForce;
743 
748 - (void)mapStatusDidChanged:(BMKMapView *)mapView;
749 
756 - (void)mapview:(BMKMapView *)mapView baseIndoorMapWithIn:(BOOL)flag baseIndoorMapInfo:(BMKBaseIndoorMapInfo *)info;
757 
758 @end
此类表示地图状态信息
Definition: BMKMapStatus.h:15
该类是地图覆盖物View的基类,提供绘制overlay的接口但本身并无实现,所有地图覆盖物View需要继承自此类 ...
Definition: BMKOverlayView.h:12
NSString * text
点标注的名称
Definition: BMKMapView.h:23
矩形,用直角地理坐标表示
Definition: BMKTypes.h:125
此类表示定位图层自定义样式参数
Definition: BMKLocationViewDisplayParam.h:24
表示一个经纬度区域
Definition: BMKTypes.h:95
NSString * uid
点标注的uid,可能为空
Definition: BMKMapView.h:27
Definition: BMKMapView.h:398
热力图的绘制数据和显示样式类
Definition: BMKHeatMap.h:28
点击地图标注返回数据结构
Definition: BMKMapView.h:21
此类表示室内图基础信息
Definition: BMKBaseIndoorMapInfo.h:17
标注view
Definition: BMKAnnotationView.h:33
地图View类,使用此View可以显示地图窗口,并且对地图进行相关的操作
Definition: BMKMapView.h:56
Definition: BMKMapView.h:422
地图View类(和Overlay操作相关的接口)
Definition: BMKMapView.h:522
CLLocationCoordinate2D pt
点标注的经纬度坐标
Definition: BMKMapView.h:25
Definition: BMKMapView.h:587
Definition: BMKUserLocation.h:13
Definition: BMKMapView.h:446
表示一个经纬度区域
Definition: BMKTypes.h:101
地理坐标点,用直角地理坐标表示
Definition: BMKTypes.h:113