123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384 |
- //
- // 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 */
|