84 lines
2.8 KiB
Objective-C
84 lines
2.8 KiB
Objective-C
//
|
||
// 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 */ |