QMapView.h

//
//  QMapView.h
//  QMapKit
//
//  Created by tabsong on 17/5/15.
//  Copyright © 2017年 tencent. All rights reserved.
//

#import <UIKit/UIKit.h>
#import "QGeometry.h"
#import "QAnnotation.h"
#import "QAnnotationView.h"
#import "QOverlayView.h"
#import "QBasicMapViewLayer.h"
#import "QTypes.h"
#import "QUserLocationPresentation.h"
#import "QTileOverlay.h"
#import "QCustomLayer.h"
#import "QText.h"

typedef NS_ENUM(NSInteger, QUserTrackingMode)
{
    QUserTrackingModeNone              = 0,    
    QUserTrackingModeFollow            = 1,    
    QUserTrackingModeFollowWithHeading = 2     
};

typedef NS_ENUM(NSUInteger, QMapLogoAnchor)
{
    QMapLogoAnchorRightBottom   = 0,    
    QMapLogoAnchorLeftBottom,           
    QMapLogoAnchorLeftTop,              
    QMapLogoAnchorRightTop,             
    QMapLogoAnchorMax                   
};

@class QUserLocation;
@protocol QMapViewDelegate;


#pragma mark - QMapView

@interface QMapView : UIView

#pragma mark - TileOverlay

@property (nonatomic, assign, getter = isHandDrawMapEnabled) BOOL handDrawMapEnabled;

@property (nonatomic, assign) BOOL showsTraffic;

#pragma mark - Resources

+ (void)loadPrefferedResourceFilesFromDirectory:(NSString *)path DEPRECATED_ATTRIBUTE;

#pragma mark - Basic

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

/*@
 *  @brief  地图类型
 */
@property (nonatomic, assign) QMapType mapType;


- (void)setStyleType:(QMapStyleType)styleType DEPRECATED_ATTRIBUTE;

- (void)setMapStyle:(int)styleType;

@property (nonatomic) BOOL showsScale;

@property (nonatomic) BOOL showsBuildings;

@property (nonatomic) BOOL shows3DBuildings;

@property (nonatomic) BOOL showsPoi;

@property (nonatomic) BOOL showsCompass;

- (void)setCompassOffset:(CGPoint)offset;

- (void)setForeignLanguage:(QMapLanguage)language;

- (void)setCenterOffsetY:(float)offset DEPRECATED_ATTRIBUTE;

- (void)setCenterOffset:(CGPoint)offset;

- (void)setCenterOffset:(CGPoint)offset animated:(BOOL)animated;

- (void)setLogoOffset:(CGPoint)offset DEPRECATED_ATTRIBUTE;

- (void)setLogoMargin:(CGPoint)margin anchor:(QMapLogoAnchor)anchor;

- (void)setLogoScale:(CGFloat)scale;

- (void)setScaleViewOffset:(CGPoint)offset;

- (void)setRoadEventVisible:(BOOL)visible DEPRECATED_ATTRIBUTE;

@property (nonatomic, readonly) QBasicMapViewLayer *animationLayer;

#pragma mark - MapStatus

@property (nonatomic, assign) CLLocationCoordinate2D centerCoordinate;

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

@property (nonatomic, assign) CGFloat zoomLevel;

@property (nonatomic, readonly) CGFloat minZoomLevel;

@property (nonatomic, readonly) CGFloat maxZoomLevel;

- (void)setMinZoomLevel:(CGFloat)minZoomLevel maxZoomLevel:(CGFloat)maxZoomLevel;

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

@property (nonatomic, assign) CGFloat rotation;

- (void)setRotation:(CGFloat)rotation animated:(BOOL)animated;

@property (nonatomic, assign) CGFloat overlooking;

- (void)setOverlooking:(CGFloat)overlooking animated:(BOOL)animated;

@property (nonatomic) QMapRect visibleMapRect;

- (void)setVisibleMapRect:(QMapRect)mapRect animated:(BOOL)animated;

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

@property (nonatomic) QCoordinateRegion region;

- (void)setRegion:(QCoordinateRegion)region animated:(BOOL)animated;

- (void)setRegion:(QCoordinateRegion)region edgePadding:(UIEdgeInsets)insets animated:(BOOL)animated;

- (QMapRect)mapRectThatFits:(QMapRect)mapRect edgePadding:(UIEdgeInsets)insets;

- (QMapRect)mapRectThatFits: (QMapRect)mapRect
        containsCalloutView:(BOOL)bContainsCalloutView
                annotations:(NSArray<id<QAnnotation> >*)annotations
                edgePadding:(UIEdgeInsets)insets;

- (CGFloat)zoomLevelThatFits:(QMapRect)mapRect edgePadding:(UIEdgeInsets)insets outCenterCoordinate:(CLLocationCoordinate2D *)outCoordinate;

-(void)setLimitMapRect:(QMapRect)mapRect mode:(QMapLimitRectFitMode)mode;

- (float *)glViewMatrix;

- (float *)glProjectionMatrix;

- (CGPoint)glVertexForCoordinate:(CLLocationCoordinate2D)coordinate;

- (CGFloat)glPointRatio;

#pragma mark - Gesture Control

@property(nonatomic, getter=isZoomEnabled) BOOL zoomEnabled;

@property (nonatomic, assign, getter = isKeepCenterDuringZoom) BOOL keepCenterDuringZoom;

@property(nonatomic, getter=isScrollEnabled) BOOL scrollEnabled;

@property (nonatomic, assign, getter=isOverlookingEnabled) BOOL overlookingEnabled;

@property (nonatomic, assign, getter=isRotateEnabled) BOOL rotateEnabled;

#pragma mark - Coordinate Convert

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

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

- (CGRect)convertRegion:(QCoordinateRegion)region toRectToView:(UIView *)view;

- (QCoordinateRegion)convertRect:(CGRect)rect toRegionFromView:(UIView *)view;

@end

@interface QMapView (UserLocation)

- (void)configureUserLocationPresentation:(QUserLocationPresentation *)presentation;

@property (nonatomic, assign) BOOL showsUserLocation;

@property (nonatomic, readonly) QUserLocation *userLocation;

@property (nonatomic) CLLocationAccuracy desiredAccuracy;

@property (nonatomic) CLLocationDistance distanceFilter;


@property (nonatomic) CLLocationDegrees headingFilter;

@property(assign, nonatomic) BOOL allowsBackgroundLocationUpdates;

@property(assign, nonatomic) BOOL pausesLocationUpdatesAutomatically;

@property (nonatomic) QUserTrackingMode userTrackingMode;

- (void)setUserTrackingMode:(QUserTrackingMode)mode animated:(BOOL)animated;

@property (nonatomic, readonly, getter=isUserLocationVisible) BOOL userLocationVisible;

- (void)setUserLocationHidden:(BOOL)hidden;


@end

@interface QMapView (Annotation)

@property(nonatomic, readonly) NSArray *annotations;

@property (nonatomic, readonly) NSArray<id<QAnnotation>> *selectedAnnotations;

- (void)addAnnotation:(id <QAnnotation>)annotation;

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

- (void)removeAnnotation:(id <QAnnotation>)annotation;

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

- (QAnnotationView *)viewForAnnotation:(id <QAnnotation>)annotation;

- (QAnnotationView *)dequeueReusableAnnotationViewWithIdentifier:(NSString *)identifier;

- (void)bringAnnotationToFront:(id <QAnnotation>)annotation DEPRECATED_ATTRIBUTE;

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

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

@end


#pragma mark - Overlay

@interface QMapView (Overlay)

@property (nonatomic, readonly) NSArray *overlays;

- (void)addOverlay:(id <QOverlay>)overlay;

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

- (void)removeOverlay:(id <QOverlay>)overlay;

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

- (QOverlayView *)viewForOverlay:(id <QOverlay>)overlay;

@end


#pragma mark - CustomLayer

@interface QMapView (CustomLayer)

- (void)addCustomLayer:(QCustomLayer *)layer;

- (void)removeCustomLayer:(QCustomLayer *)layer;

@end

#pragma mark - Snapshot

@interface QMapView (Snapshot)

- (UIImage *)takeSnapshot __attribute__ ((deprecated("use - (void)takeSnapshotInRect:(CGRect)rect completion:(void (^)(UIImage *resultImage))completion instead")));

- (void)takeSnapshotInRect:(CGRect)rect completion:(void (^)(UIImage *resultImage))completion;

- (void)takeSnapshotInRect:(CGRect)rect timeout:(CFTimeInterval)timeout completion:(void (^)(UIImage *resultImage))completion;

@end

#pragma mark - QPoiInfo

@interface QPoiInfo : NSObject

@property (nonatomic, copy) NSString *uid;

@property (nonatomic, copy) NSString *name;

@property (nonatomic, assign) CLLocationCoordinate2D coordinate;

@end

@interface QIndoorPoiInfo : QPoiInfo

@property (nonatomic, copy) NSString *levelName;

@property (nonatomic, copy) NSString *buildingGUID;

@property (nonatomic, copy) NSString *buildingName;

@end

@interface QPointEventInfo : QPoiInfo

@property (nonatomic, copy) NSString *source;

@property (nonatomic, copy) NSString *eventName;

@property (nonatomic, copy) NSString *road;

@property (nonatomic, copy) NSString *detail;

@property (nonatomic, assign) NSTimeInterval startTime;

@property (nonatomic, assign) NSTimeInterval endTime;

@property (nonatomic, assign) NSTimeInterval updateTime;

@end

@interface QMapView (Debug)

- (NSString *)getDebugError;

@end

#pragma mark - QMapViewDelegate

@protocol QMapViewDelegate <NSObject>

@optional

- (void)mapViewInitComplete:(QMapView *)mapView;

- (void)mapViewDidFailLoadingMap:(QMapView *)mapView withError:(NSError *)error;

- (void)mapView:(QMapView *)mapView regionWillChangeAnimated:(BOOL)animated gesture:(BOOL)bGesture;

- (void)mapViewRegionChange:(QMapView *)mapView;

- (void)mapView:(QMapView *)mapView regionDidChangeAnimated:(BOOL)animated gesture:(BOOL)bGesture;

- (void)mapViewDrawFrame:(QMapView *)mapView;

- (void)mapView:(QMapView *)mapView didTapAtCoordinate:(CLLocationCoordinate2D)coordinate;

- (void)mapView:(QMapView *)mapView didTapPoi:(QPoiInfo *)poi;

- (void)mapView:(QMapView *)mapView didTapOverlay:(id<QOverlay>)overlay;

- (QAnnotationView *)mapView:(QMapView *)mapView viewForAnnotation:(id <QAnnotation>)annotation;

- (UIView *)mapView:(QMapView *)mapView customCalloutForAnnotationView:(QAnnotationView *)annotationView;

- (void)mapView:(QMapView *)mapView didAddAnnotationViews:(NSArray<QAnnotationView *> *)views;

- (void)mapView:(QMapView *)mapView didSelectAnnotationView:(QAnnotationView *)view;

- (void)mapView:(QMapView *)mapView didDeselectAnnotationView:(QAnnotationView *)view;

- (void)mapView:(QMapView *)mapView annotationView:(QAnnotationView *)view didChangeDragState:(QAnnotationViewDragState)newState
   fromOldState:(QAnnotationViewDragState)oldState;

- (void)mapView:(QMapView *)mapView annotationView:(QAnnotationView *)view calloutAccessoryControlTapped:(UIControl *)control;

- (void)mapView:(QMapView *)mapView annotationViewCalloutTapped:(QAnnotationView *)view;

- (QOverlayView *)mapView:(QMapView *)mapView viewForOverlay:(id <QOverlay>)overlay;

- (void)mapView:(QMapView *)mapView didAddOverlayViews:(NSArray *)overlayViews;

- (void)mapViewWillStartLocatingUser:(QMapView *)mapView;

- (void)mapViewDidStopLocatingUser:(QMapView *)mapView;

- (void)mapView:(QMapView *)mapView didUpdateUserLocation:(QUserLocation *)userLocation fromHeading:(BOOL)fromHeading;
- (void)mapView:(QMapView *)mapView didFailToLocateUserWithError:(NSError *)error;

- (void)mapView:(QMapView *)mapView didChangeUserTrackingMode:(QUserTrackingMode)mode animated:(BOOL)animated;

@end