Initial commit

2017-08-15 16:59:01 +08:00
commit bdc83e07ef
5766 changed files with 423223 additions and 0 deletions
@@ -0,0 +1,84 @@
+//
+//  BMKTileLayer.h
+//  MapComponent
+//
+//  Created by wzy on 15/8/7.
+//  Copyright © 2015年 baidu. All rights reserved.
+//
+
+#ifndef BMKTileLayer_h
+#define BMKTileLayer_h
+#import "BMKOverlay.h"
+
+/**
+ @brief 该类是覆盖在球面墨卡托投影上的图片tiles的数据源，是抽象类，不能直接使用该类添加瓦片图，需要使用其子类（BMKURLTileLayer或BMKSyncTileLayer）
+ *瓦片图片是jpeg或者png格式，size为256x256
+ */
+@interface BMKTileLayer : NSObject <BMKOverlay>
+
+/// tileLayer的可见最小Zoom值，默认3
+@property (nonatomic, assign) NSInteger minZoom;
+
+/// tileLayer的可见最大Zoom值，默认21，且不能小于minZoom
+@property (nonatomic, assign) NSInteger maxZoom;
+
+/// tileOverlay的可渲染区域，默认世界范围
+@property (nonatomic) BMKMapRect visibleMapRect;
+
+@end
+
+/**
+ @brief 通过提供url模板的方法，提供数据源。不应该继承该类，且必须通过 initWithURLTemplate: 来初始化
+ *瓦片图片是jpeg或者png格式，size为256x256
+ */
+@interface BMKURLTileLayer : BMKTileLayer
+
+/// 同initWithURLTemplate:中的URLTemplate
+@property (readonly) NSString *URLTemplate;
+
+/*!
+ @brief 根据指定的URLTemplate生成tileOverlay
+ @param URLTemplate是一个包含"{x}","{y}","{z}"的字符串,"{x}","{y}"表示tile的坐标，"{z}"表示当tile显示的级别。"{x}","{y}","{z}"会被tile的坐标值所替换，并生成用来加载tile图片数据的URL 。例如： http://server/path?x={x}&y={y}&z={z}。
+ @return 以指定的URLTemplate字符串生成tileOverlay
+ */
+- (id)initWithURLTemplate:(NSString *)URLTemplate;
+
+/**
+ @brief 清除当前瓦片图层缓存图片
+ */
+- (BOOL)cleanTileDataCache;
+
+@end
+
+/**
+ @brief 通过同步方法获取瓦片数据，是一个抽象类，需要通过继承该类，并重载 tileForX:y:zoom: 方法
+ *瓦片图片是jpeg或者png格式，size为256x256
+ */
+@interface BMKSyncTileLayer : BMKTileLayer
+
+/**
+ @brief 通过同步方法获取瓦片数据，子类必须实现该方法
+        这个方法会在多个线程中调用，需要考虑线程安全
+ @param (x, y, zoom)瓦片坐标
+ @return (x, y, zoom)所对应瓦片的UIImage对象
+*/
+- (UIImage *)tileForX:(NSInteger)x y:(NSInteger)y zoom:(NSInteger)zoom;
+
+@end
+
+/**
+ @brief 通过异步方法获取瓦片数据，是一个抽象类，需要通过继承该类，并重载 loadTileForX:y:zoom:result: 方法
+ *瓦片图片是jpeg或者png格式，size为256x256
+ */
+@interface BMKAsyncTileLayer : BMKTileLayer
+
+/**
+ @brief 通过异步方法获取瓦片数据，子类必须实现该方法
+ @param (x, y, zoom)瓦片坐标
+ @return result 用来传入瓦片数据或加载瓦片失败的error访问的回调block
+ */
+- (void)loadTileForX:(NSInteger)x y:(NSInteger)y zoom:(NSInteger)zoom result:(void (^)(UIImage *tileImage, NSError *error))result;
+
+@end
+
+#endif /* BMKTileLayer_h */