MAMap.h

Go to the documentation of this file.

//
//  MAMap.h
//  MAMapKit
//
//  Created by 翁乐 on 3/17/16.
//  Copyright © 2020 Amap. All rights reserved.
//
 
#import <Foundation/Foundation.h>
#import <UIKit/UIKit.h>
#import "MAOverlay.h"
#import "MAOverlayRenderer.h"
#import "MAAnnotation.h"
#import "MAAnnotationView.h"
#import "MACircle.h"
#import <AMapFoundationKit/AMapUtility.h>
#import "MAUserLocation.h"
#import "MAMapStatus.h"
#import "MAUserLocationRepresentation.h"
#import "MAMapCustomStyleOptions.h"
#import "MAPolylineRenderer.h"
#import "MAMapWebViewProcotol.h"
#import <WebKit/WebKit.h>
#import "MACustomSchemeModel.h"
 
typedef NS_ENUM(NSInteger, MAMapType)
{
    MAMapTypeStandard = 1,  
    MAMapTypeSatellite,     
    MAMapTypeStandardNight  
};
 
typedef NS_ENUM(NSInteger, MAUserTrackingMode)
{
    MAUserTrackingModeNone              = 0,    
    MAUserTrackingModeFollow            = 1,    
    MAUserTrackingModeFollowWithHeading = 2     
};
 
#pragma mark - 动画相关的key
 
NS_ASSUME_NONNULL_BEGIN
 
@protocol MAMapDelegate;
 
@interface MAMap : NSObject
 
@property (nonatomic, weak) id<MAMapDelegate> delegate;
 
@property (nonatomic) MAMapType mapType;
 
@property (nonatomic) CLLocationCoordinate2D centerCoordinate;
 
@property (nonatomic) MAMapRect visibleMapRect;
 
@property (nonatomic, assign) MACoordinateRegion limitRegion;
@property (nonatomic, assign) MAMapRect limitMapRect;
 
@property (nonatomic) CGFloat zoomLevel;
@property (nonatomic) CGFloat minZoomLevel;
@property (nonatomic) CGFloat maxZoomLevel;
@property (nonatomic, getter = isZoomEnabled) BOOL zoomEnabled;
 
@property (nonatomic) CGFloat rotationDegree;
@property (nonatomic, getter = isRotateEnabled) BOOL rotateEnabled;
 
@property (nonatomic) CGFloat cameraDegree;
@property (nonatomic, getter = isRotateCameraEnabled) BOOL rotateCameraEnabled;
 
@property (nonatomic, getter = isScrollEnabled) BOOL scrollEnabled;
 
@property (nonatomic, getter = isShowsBuildings) BOOL showsBuildings;
 
@property (nonatomic, assign, getter = isShowsLabels) BOOL showsLabels;
 
@property (nonatomic, getter = isShowTraffic) BOOL showTraffic;
 
@property (nonatomic, readonly) BOOL isAbroad;
 
@property (nonatomic, class, getter=isShowsWorldMap) BOOL showsWorldMap;
 
+ (NSArray<MACustomSchemeModel*>*)customSchemeArray;
 
- (instancetype)initWithWebView:(nonnull NSObject<MAMapWebViewProcotol>*)webView;
 
- (void)createMap;
 
- (void)setVisibleMapRect:(MAMapRect)mapRect animated:(BOOL)animated;
 
- (void)setVisibleMapRect:(MAMapRect)mapRect edgePadding:(UIEdgeInsets)insets animated:(BOOL)animated;
 
- (void)setCenterCoordinate:(CLLocationCoordinate2D)coordinate animated:(BOOL)animated;
 
- (void)setZoomLevel:(CGFloat)zoomLevel animated:(BOOL)animated;
 
- (void)setRotationDegree:(CGFloat)rotationDegree animated:(BOOL)animated;
 
- (void)setCameraDegree:(CGFloat)cameraDegree animated:(BOOL)animated;
 
- (MAMapStatus *)getMapStatus;
 
- (void)setMapStatus:(MAMapStatus *)status animated:(BOOL)animated;
 
- (void)convertCoordinate:(CLLocationCoordinate2D)coordinate completeCallback:(void(^)(CGPoint point))completeCallback;
 
- (void)convertPoint:(CGPoint)point completeCallback:(void(^)(CLLocationCoordinate2D coordinate))completeCallback;
 
- (NSString *)mapContentApprovalNumber;
 
- (NSString *)satelliteImageApprovalNumber;
 
- (void)longPressGesture:(UILongPressGestureRecognizer *)gestureRecognizer;
 
@end
 
@interface MAMap (NetworkIntercept)
 
+ (void)startRequestWithURLProtocol:(NSURLProtocol*)urlProtocol;
+ (void)stopRequestWithURLProtocol:(NSURLProtocol*)urlProtocol;
 
@end
 
@interface MAMap (Annotation)
 
@property (nonatomic, readonly) NSArray *annotations;
 
@property (nonatomic, copy) NSArray *selectedAnnotations;
 
- (void)addAnnotation:(id <MAAnnotation>)annotation;
 
- (void)addAnnotations:(NSArray *)annotations;
 
- (void)removeAnnotation:(id <MAAnnotation>)annotation;
 
- (void)removeAnnotations:(NSArray *)annotations;
 
- (MAAnnotationView *)viewForAnnotation:(id <MAAnnotation>)annotation;
 
- (void)selectAnnotation:(id <MAAnnotation>)annotation animated:(BOOL)animated;
 
- (void)deselectAnnotation:(id <MAAnnotation>)annotation animated:(BOOL)animated;
 
- (void)showAnnotations:(NSArray *)annotations animated:(BOOL)animated;
 
- (void)showAnnotations:(NSArray *)annotations edgePadding:(UIEdgeInsets)insets animated:(BOOL)animated;
 
@end
 
 
@interface MAMap (UserLocation)
 
@property (nonatomic) BOOL showsUserLocation;
 
@property (nonatomic, readonly) MAUserLocation *userLocation;
 
@property (nonatomic) BOOL customizeUserLocationAccuracyCircleRepresentation;
 
@property (nonatomic, readonly) MACircle *userLocationAccuracyCircle;
 
@property (nonatomic) MAUserTrackingMode userTrackingMode;
 
- (void)setUserLocation:(CLLocation*)location coordinateType:(AMapCoordinateType)type;
 
- (void)setUserHeading:(CLHeading*)heading;
 
- (void)setUserTrackingMode:(MAUserTrackingMode)mode animated:(BOOL)animated;
 
- (void)updateUserLocationRepresentation:(MAUserLocationRepresentation *)representation;
 
@end
 
@interface MAMap (Overlay)
 
@property (nonatomic, readonly) NSArray *overlays;
 
- (void)addOverlay:(id <MAOverlay>)overlay;
 
- (void)addOverlays:(NSArray *)overlays;
 
- (void)removeOverlay:(id <MAOverlay>)overlay;
 
- (void)removeOverlays:(NSArray *)overlays;
 
- (MAOverlayRenderer *)rendererForOverlay:(id <MAOverlay>)overlay;
 
- (void)showOverlays:(NSArray *)overlays animated:(BOOL)animated;
 
- (void)showOverlays:(NSArray *)overlays edgePadding:(UIEdgeInsets)insets animated:(BOOL)animated;
 
@end
 
#pragma mark - MAMapDelegate
@protocol MAMapDelegate <NSObject>
 
@optional
 
- (void)mapReady:(MAMap *)map;
 
- (void)mapRegionChanged:(MAMap *)map;
 
- (void)mapRegionDidChanged:(MAMap *)map;
 
- (MAAnnotationView *)map:(MAMap *)map viewForAnnotation:(id <MAAnnotation>)annotation;
 
- (void)map:(MAMap *)map didAnnotationViewTapped:(MAAnnotationView *)annotationView;
 
- (void)map:(MAMap *)map didSelectAnnotationView:(MAAnnotationView *)view;
 
- (void)map:(MAMap *)map didDeselectAnnotationView:(MAAnnotationView *)view;
 
- (void)map:(MAMap *)map annotationView:(MAAnnotationView *)view didChangeDragState:(MAAnnotationViewDragState)newState
   fromOldState:(MAAnnotationViewDragState)oldState;
 
- (MAOverlayRenderer *)map:(MAMap *)map rendererForOverlay:(id <MAOverlay>)overlay;
 
- (void)map:(MAMap *)map didAddOverlayRenderers:(NSArray *)overlayRenderers;
 
- (void)map:(MAMap *)map didPolylineRendererTapped:(MAPolylineRenderer *)polylineRenderer;
 
- (void)map:(MAMap *)map didAnnotationViewCalloutTapped:(MAAnnotationView *)view;
 
- (void)map:(MAMap *)map didChangeUserTrackingMode:(MAUserTrackingMode)mode animated:(BOOL)animated;
 
- (void)map:(MAMap *)map didSingleTappedAtCoordinate:(CLLocationCoordinate2D)coordinate;
 
- (void)map:(MAMap *)map didLongPressedAtCoordinate:(CLLocationCoordinate2D)coordinate;
 
@end
 
NS_ASSUME_NONNULL_END