QMapView.h

//
//  QMapView.h
//  QMap
//
//  Created by songjian on 14-8-18.
//  Copyright (c) 2014年 Tencent. All rights reserved.
//

#import <UIKit/UIKit.h>
#import "QFoundation.h"
#import "QGeometry.h"
#import "QTypes.h"
#import "QOverlay.h"
#import "QOverlayView.h"
#import "QAnnotationView.h"

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

#pragma mark - QMapView
@class QUserLocation;

@protocol QMapViewDelegate;

Q_EXTERN @interface QMapView : UIView <NSCoding>

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

@property (nonatomic) QMapType mapType;

@property (nonatomic, assign, getter = isShowTraffic) BOOL showTraffic;

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

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

@property (nonatomic, assign, getter = isKeepCenterEnabled) BOOL keepCenterEnabled;

@property (nonatomic) BOOL showsScale;

@property (nonatomic) CLLocationCoordinate2D centerCoordinate;

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

@property (nonatomic) QCoordinateRegion region;

- (id)initWithFrame:(CGRect)frame;

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

@property (nonatomic) QMapRect visibleMapRect;

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

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

- (QCoordinateRegion)regionThatFits:(QCoordinateRegion)region;

- (QMapRect)mapRectThatFits:(QMapRect)mapRect;

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

- (void)setDisplayLauguage:(QMapLanguage)language;

#pragma mark - ZoomLevel

@property (nonatomic, assign) double zoomLevel;

@property (nonatomic, readonly) double minZoomLevel;

@property (nonatomic, readonly) double maxZoomLevel;

- (void)setZoomLevel:(double)newZoomLevel animated:(BOOL)animated;

- (void)setCenterCoordinate:(CLLocationCoordinate2D)coordinate zoomLevel:(double)newZoomLevel animated:(BOOL)animated;

- (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;

#pragma mark - Annotation

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

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

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

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

@property (nonatomic, readonly) NSArray *annotations;

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

- (NSSet *)annotationsInMapRect:(QMapRect)mapRect;

@property(nonatomic, readonly) CGRect annotationVisibleRect;

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

@property (nonatomic, copy) NSArray *selectedAnnotations;

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

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

- (void)showAnnotations:(NSArray *)annotations animated:(BOOL)animated;

#pragma mark - UserLocation

@property (nonatomic, getter = isShowsUserLocation) BOOL showsUserLocation;

@property(nonatomic, assign) CLLocationDistance distanceFilter;

@property (nonatomic, readonly, strong) QUserLocation *userLocation;

@property (nonatomic) BOOL forceUpdatingHeading;

@property (nonatomic) QUserTrackingMode userTrackingMode;

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

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

@end

@interface QMapView(OverlaysAPI)

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

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

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

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

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

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

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

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

@property (nonatomic, readonly) NSArray *overlays;

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

@end

@interface QMapView (Snapshot)

- (UIImage *)takeSnapshotInRect:(CGRect)rect;

- (void)takeSnapshotInRect:(CGRect)rect withCompletionBlock:(void (^)(UIImage *resultImage, CGRect rect))block;

@end

Q_EXTERN @protocol QMapViewDelegate <NSObject>

@optional

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

#pragma mark - Region

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

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

#pragma mark - Overlay

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

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

#pragma mark - Annotation

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

- (void)mapView:(QMapView *)mapView didAddAnnotationViews:(NSArray *)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;

#pragma mark - UserLocation

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

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

- (void)mapView:(QMapView *)mapView didUpdateUserLocation:(QUserLocation *)userLocation  __attribute__ ((deprecated("use -(void)mapView:(QMapView *)mapView didUpdateUserLocation:(QUserLocation *)userLocation updatingLocation:(BOOL)updatingLocation instead")));

- (void)mapView:(QMapView *)mapView didUpdateUserLocation:(QUserLocation *)userLocation updatingLocation:(BOOL)updatingLocation;

- (void)mapView:(QMapView *)mapView didFailToLocateUserWithError:(NSError *)error;

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

@end