MBMapView.h

浏览该文件的文档.

//
//  MBMapView.h
//  Navigation
//
//  Created by delon on 12-12-26.
//
//

#import <UIKit/UIKit.h>
#import <CoreLocation/CoreLocation.h>

#import "MBEngine.h"
#import "MBAnnotation.h"
#import "MBNaviBaseTypes.h"

typedef NS_ENUM(NSInteger, MBOptionalGesture) {
    MBOptionalGesture_singleTouchZoom = 1,
    MBOptionalGesture_doubleTouchesElevate = 2,
    MBOptionalGesture_doubleTouchesRotate = 3
};

typedef NS_ENUM(NSInteger, MBRenderConfig) {
    MBRenderConfig_maxCustomIconSize = 1,
    MBRenderConfig_orderAnnotDynamically = 2,
    MBRenderConfig_annotationDropInterval = 5,
    MBRenderConfig_annotationDropFrameNum = 6,
    MBRenderConfig_calloutTextAlignment = 7,
};

typedef NS_ENUM(NSInteger, MBAnimationType) {
    MBAnimationType_linear,   //暂不支持
    MBAnimationType_flyOver   //当前只支持直升机风格
};

typedef NS_ENUM(NSInteger, MBLevelCase) {
    MBLevelCase_maxIndoor,      //最大室内图
    MBLevelCase_maxMap,         //最大普通地图
    MBLevelCase_maxCountryMap,  //最大全国地图
    MBLevelCase_maxWorldMap,    //最大世界地图
    MBLevelCase_highest         //最小普通地图
};

typedef NS_ENUM(NSInteger, MBSatelliteImageSource) {
    MBSatelliteImageSource_bing = 0,
    MBSatelliteImageSource_google = 1,
    MBSatelliteImageSource_googleTerrain = 2,
    MBSatelliteImageSource_greatWallMotor = 3,
    MBSatelliteImageSource_xinjiang = 4,
    MBSatelliteImageSource_max
};

typedef NS_ENUM(NSInteger, MBMapDataMode) {
    MBMapDataMode_online,
    MBMapDataMode_offline,
    MBMapDataMode_both
};

typedef NS_ENUM(NSInteger, MBUrlType) {
    MBUrlType_basicMap = 0,
    MBUrlType_trafficTiles,

};

typedef NS_ENUM(NSInteger, MBRenderQuality) {
    MBRenderQuality_low = 1,
    MBRenderQuality_medium = 2,
    MBRenderQuality_high = 3
};

typedef NS_ENUM(NSInteger, MBCameraSetting) {
    MBCameraSetting_worldCenter = 1,
    MBCameraSetting_scale       = 2,
    MBCameraSetting_heading     = 4,
    MBCameraSetting_elevation   = 8,
    MBCameraSetting_viewport    = 16,
    MBCameraSetting_viewShift   = 32,
    MBCameraSetting_dpiFactor   = 64,
    MBCameraSetting_zoomLevel   = 128
};

typedef NS_ENUM(NSInteger, MBMapMode) {
    MapMode_normal = 0,
    MapMode_navigation = 1
};

typedef NS_OPTIONS(NSUInteger, MBPOIType) {
    MBPOIType_NONE = 0,
    
    MBPOIType_railwayStation = 0x1,
    MBPOIType_airport = 0x2,
    MBPOIType_dock = 0x4,
    MBPOIType_subwayStation = 0x8,   
    
    MBPOIType_community = 0x10,      
    MBPOIType_school = 0x20,
    MBPOIType_hospital = 0x40,
    MBPOIType_park = 0x80,
    MBPOIType_hotel = 0x100,
    MBPOIType_seeingSite = 0x200,    
    MBPOIType_toilet = 0x400,
    
    MBPOIType_gasStation = 0x800,
    MBPOIType_parkingLot = 0x1000,
    MBPOIType_trafficLight = 0x2000,
    
    MBPOIType_bank = 0x8000,
    MBPOIType_chinaPost = 0x10000,   
    
    MBPOIType_McDonald = 0x20000,
    MBPOIType_KFC = 0x40000,
    
    MBPOIType_subwayExit = 0x80000,  
    
    MBPOIType_others = 0x100000,     
    
    MBPOIType_ALL = 0xFFFFFFFF
};

@class MBOverlay, MBMapState;

@protocol MBMapViewDelegate;

@interface MBMapView : UIView
@property (nonatomic, readonly, assign) MBSdkAuthError authErrorType;

@property (nonatomic, assign) MBPoint worldCenter;

@property (nonatomic, assign) MBNdsPoint centerNds;

@property (nonatomic, assign) MBRect boundArea;

@property (nonatomic, assign) float zoomLevel;

@property (nonatomic, assign) float scale;

@property (nonatomic, assign) float elevation;

@property (nonatomic, assign) float heading;

@property (nonatomic, assign) float viewShift;

@property (nonatomic, assign) MBPoint centerOffset;

@property (nonatomic, assign) MBRect viewport;

@property(nonatomic,assign) float fovy;

@property (nonatomic, readonly, assign) MBRect worldRect;
@property (nonatomic, readonly, assign) MBRect worldRectNds;

@property (nonatomic, readonly, assign) MBPoint shiftXY;

@property (nonatomic, assign) BOOL nightMode;

@property (nonatomic, readonly, copy) NSArray *annotations;

@property (nonatomic, readonly, copy) NSArray *overlays;

@property (nonatomic, assign) BOOL suspendDisplay;

@property (nonatomic, weak) id<MBMapViewDelegate> delegate;

@property (nonatomic, copy) NSString *styleClass;

- (CGFloat)minScale;

- (CGFloat)maxScale;

- (void)reloadMapData;

- (void)setClipRect:(MBRect)clipRect;

@property (nonatomic, assign) MBDataPreference dataPreference;

- (MBPoint)world2Screen:(MBPoint)pt;

- (MBPoint)screen2World:(MBPoint)pt;

- (MBNdsPoint)screen2WorldNds:(MBPoint)pt;
- (MBPoint)world2ScreenNds:(MBNdsPoint)pt;

- (void)loadStyleSheet:(NSString *)filename;
- (void)drawView;

- (void)setSatelliteImageSource:(MBSatelliteImageSource)dataSource;

- (MBRect)worldRect2Screen:(MBRect)rc;

- (MBRect)screenRect2World:(MBRect)rc;

- (BOOL)isPointVisible:(MBPoint)pos;

- (BOOL)isRectVisible:(MBRect)rect;
- (BOOL)isRectVisibleNds:(MBRect)rect;
- (float)unitWorld2Screen:(float)worldUnit;
- (float)unitWorld2ScreenNds:(float)worldUnit;
- (float)unitScreen2World:(float)screenUnit;
- (float)unitScreen2WorldNds:(float)screenUnit;
- (NSString *)getImagePostfix;
- (void)fitWorldArea:(MBRect)area;

- (void)fitWorldArea:(MBRect)area rect:(CGRect)rect;

- (float)zoomLevel2Scale:(float)zoomLevel;

- (NSInteger)meter2Pixel:(int)meter;

- (float)getTraditionalMapScale;

- (void)addAnnotation:(MBAnnotation *)annotation;

- (void)removeAnnotation:(MBAnnotation *)annotation;

- (void)removeAnnotations:(NSArray *)annotations;

- (void)selectAnnotation:(MBAnnotation *)annotation;

- (void)addOverlay:(MBOverlay *)overlay;

- (void)insertOverlayAtIndex:(MBOverlay *)overlay index:(NSInteger)index;

- (void)removeOverlay:(MBOverlay *)overlay;

- (void)removeOverlays:(NSArray *)overlays;

- (void)bringOverlayToTop:(MBOverlay *)overlay;

- (void)sendOverlayToBack:(MBOverlay *)overlay;

- (void)exchangeOverylayIndices:(MBOverlay *)l r:(MBOverlay *)r;

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

- (void)setScale:(CGFloat)scale animated:(BOOL)animated;

- (void)setHeading:(CGFloat)heading animated:(BOOL)animated;

- (void)beginAnimations;

- (void)cancelAnimations;

- (void)commitAnimations:(int)duration type:(MBAnimationType)type;

- (void)startZoom:(BOOL)toZoomIn;

- (void)endZoom;

- (BOOL)isInAnimation;

- (void)setWorldCenter:(MBPoint)worldCenter animated:(BOOL)animated;

- (void)setViewShiftX:(float)rx y:(float)ry;

- (void)compactCache;

- (void)clearCache;
- (void)switchToBackground;
- (void)switchToForeground;

@property (nonatomic, assign) BOOL enableBackground;

@property (nonatomic, assign) BOOL enableBasicMap;

@property (nonatomic, assign) BOOL enableSatelliteMap;

@property (nonatomic, assign) BOOL enableTrafficEvent;

@property (nonatomic, assign) BOOL enableBuilding;

@property (nonatomic, assign) BOOL enableTmc;

@property (nonatomic, assign) BOOL enableUpdateTmc;

@property (nonatomic, assign) float dpiFactor;

@property (nonatomic, assign) MBRenderQuality renderQuality;

@property (nonatomic, strong) MBMapState *mapState;

@property (nonatomic, assign) MBRangeF zoomLevelRange;

@property (nonatomic, assign) int tmcRefreshInterval;

- (void)setTiServerUrl:(NSString *)url;

- (void)setConfigType:(MBRenderConfig)type values:(int*)values num:(NSInteger)num;
- (void)getConfigType:(MBRenderConfig)type values:(int*)values num:(NSInteger)num;

- (void)setConfigType:(MBRenderConfig)type enable:(BOOL)enable;
- (BOOL)getConfigTypeEnable:(MBRenderConfig)type;

- (void)setDataUrlPrefix:(MBUrlType)type urlPrefix:(NSString *)url;

- (UIImage *)screenshot;

@property (nonatomic, assign) BOOL enableUserRasterMap;

- (BOOL)isBuildingOpaque;

@property (nonatomic, assign) float highestBuildingZoom;

@property (nonatomic, assign) BOOL highlightTmc;

- (float)getZoomLevelOf:(MBLevelCase)levelCase;

+ (MBNdsPoint)ndsPointFromMBPoint:(MBPoint)pos;

+ (MBPoint)ndsPointToMBPoint:(MBNdsPoint)pos;

+ (MBNdsPoint)ndsPointFrom:(CLLocationCoordinate2D)location;

+ (CLLocationCoordinate2D)ndsPointToXY:(MBNdsPoint)pos;

+ (MBRect)getFitRect:(MBPoint *)points num:(NSInteger)poiNum;

- (void)optionalGesture:(MBOptionalGesture)gesture enable:(BOOL)enable;

- (BOOL)isOptionalGestureEnabled:(MBOptionalGesture)gesture;
- (NSInteger)detachAllOverlays;
- (void)detachOverlay:(MBOverlay *)overlay;
- (void)detachAnnotation:(MBAnnotation *)annotation;
- (NSInteger)detachAllAnnotations;
- (UIImage *)screenshotWithRect:(MBRect)rect dpiFactor:(float)dpi;

#pragma mark -- UIE Project Only
- (BOOL)onTouchDown:(int)touchCount touchIds:(ssize_t*) touchIds pos:(const MBPoint*) positions;
- (void)onTouchMove:(int)touchCount touchIds:(ssize_t*)touchIds pos:(const MBPoint*)positions;
- (void)onTouchUp:(int)touchCount touchIds:(ssize_t*)touchIds pos:(const MBPoint*)positions;
- (void)onTouchCancelled:(int)touchCount touchIds:(ssize_t*)touchIds pos:(const MBPoint*)positions;
- (void)onTap:(const MBPoint*) pos;
- (void)resetTouch;
- (void)onTouchClicked:(const MBPoint*)pos;
- (void)onTouchDoubleClicked:(const MBPoint*)pos;

@end