tkmView Class Reference

Inherits from	UIView
Declared in	tkmView.h

`cityName`

当前地图中心点所在城市名称

@property (nonatomic, readonly) NSString *cityName

Declared In

tkmView.h

`position`

当前地图中心点的经纬度

@property (nonatomic, strong) tkmPosition *position

Declared In

tkmView.h

`zoom`

当前地图缩放程度

@property (nonatomic, assign) CGFloat zoom

Discussion

Note: 各级别间为2的位数关系，范围须在zoomLowerLevel~zoomUpperLevel之间

Declared In

tkmView.h

`zoomLevel`

当前地图缩放等级

@property (nonatomic, assign) NSInteger zoomLevel

Discussion

Note: 各级别间为2的位数关系，范围须在zoomLowerLevel~zoomUpperLevel之间

Declared In

tkmView.h

`direction`

当前地图的朝向

@property (nonatomic, assign) CGFloat direction

Discussion

Note: 用角度来表示方向，范围为[0~360)，自正北的逆时针方向，故正东为90，正南为180，正西为270

Declared In

tkmView.h

`zoomLowerLevel`

缩放最小级别，比例尺最大

@property (nonatomic, assign) NSInteger zoomLowerLevel

Declared In

tkmView.h

`zoomUpperLevel`

缩放最大级别，比例尺最小

@property (nonatomic, assign) NSInteger zoomUpperLevel

Declared In

tkmView.h

`poiPinShow`

poi图针是否显示

@property (nonatomic, assign) BOOL poiPinShow

Declared In

tkmView.h

`longPressPinShow`

是否允许添加长按气泡

@property (nonatomic, assign) BOOL longPressPinShow

Declared In

tkmView.h

`showCustomButtons`

是否显示自定义按钮

@property (nonatomic, assign) BOOL showCustomButtons

Declared In

tkmView.h

`gpsMode`

GPS模式

```
* TKM_MGM_Common    普通模式
```
```
* TKM_MGM_Follow    跟随模式
```
```
* TKM_MGM_Compass   罗盘模式
```

@property (nonatomic, assign) tkmMapGPSMode gpsMode

Declared In

tkmView.h

`workMode`

地图的工作模式

```
* TKM_MWM_Normal    普通工作模式
```
```
* TKM_MWM_Distance  测距模式
```
```
* TKM_MWM_Picking   拾取模式
```

@property (nonatomic, assign) tkmMapWorkMode workMode

Declared In

tkmView.h

`displayMode`

地图的显示模式

```
* TKM_MDM_Normal    矢量地图模式
```
```
* TKM_MDM_Setallite 卫星图模式
```

@property (nonatomic, assign) tkmMapDisplayMode displayMode

Declared In

tkmView.h

`enabledRotating`

地图是否允许旋转

@property (nonatomic, assign) BOOL enabledRotating

Declared In

tkmView.h

`enabledManualZooming`

地图是否允许手动缩放

@property (nonatomic, assign) BOOL enabledManualZooming

Declared In

tkmView.h

`enabledManualMoving`

地图是否允许手动缩放

@property (nonatomic, assign) BOOL enabledManualMoving

Declared In

tkmView.h

`delegate`

实现协议的委托实例

@property (nonatomic, weak) id<tkmViewDelegate> delegate

Declared In

tkmView.h

`normalState`

是否为普通模式，即非定位模式

@property (nonatomic, readonly) BOOL normalState

Declared In

tkmView.h

`isSouthing`

地图当前是否为正北指向

@property (nonatomic, readonly) BOOL isSouthing

Declared In

tkmView.h

`scalePosition`

比例尺的位置(左上点)

@property (nonatomic, assign) CGPoint scalePosition

Declared In

tkmView.h

`compassCenter`

指南针按键位置(中心点)

@property (nonatomic, assign) CGPoint compassCenter

Declared In

tkmView.h

`compassPosition`

指南针按键位置(左上点)

@property (nonatomic, assign) CGPoint compassPosition

Declared In

tkmView.h

`zoomButtonsVertical`

缩放按钮是否纵向排列

@property (nonatomic, assign) BOOL zoomButtonsVertical

Declared In

tkmView.h

`zoomButtonsPosition`

地图上的缩放按钮组的位置(左上点)

@property (nonatomic, assign) CGPoint zoomButtonsPosition

Declared In

tkmView.h

`zoomButtonsCenter`

地图上的缩放按钮组的位置(中心点)

@property (nonatomic, assign) CGPoint zoomButtonsCenter

Declared In

tkmView.h

`– refreshMap`

刷新地图

- (void)refreshMap

Declared In

tkmView.h

`– refreshMapImmediately`

立即刷新地图

- (void)refreshMapImmediately

Declared In

tkmView.h

`– setButton:frame:`

设置

- (void)setButton:(NSString *)buttonName frame:(CGRect)frame

Parameters

`buttonName`	子控件 `@"gps" 定位按钮` `@"tools" 工具箱按钮` `@"ruler" 测距按钮` `@"clear" 清楚按钮` `@"zoomin" 放大按钮` `@"zoomout" 缩小按钮` `@"compass" 罗盘按钮` `@"scale" 比例尺`
`frame`	位置frame

buttonName

子控件

```
@"gps"      定位按钮
```
```
@"tools"    工具箱按钮
```
```
@"ruler"    测距按钮
```
```
@"clear"    清楚按钮
```
```
@"zoomin"   放大按钮
```
```
@"zoomout"  缩小按钮
```
```
@"compass"  罗盘按钮
```
```
@"scale"    比例尺
```

frame

位置frame

Declared In

tkmView.h

`– compassMode:`

罗盘模式开关

- (void)compassMode:(BOOL)mode

Parameters

`mode`	为YES时进入罗盘模式，为NO时退出

Declared In

tkmView.h

`– viewWillDisappear`

地图视图隐藏

- (void)viewWillDisappear

Declared In

tkmView.h

`– viewDidAppear`

地图视图出现

- (void)viewDidAppear

Declared In

tkmView.h

`– bottomButtonGoUpTo:`

地图的底部按钮上浮

- (void)bottomButtonGoUpTo:(float)upLine

Parameters

`upLine`	上浮到的底线高度

Declared In

tkmView.h

`– bottomButtonFallBack`

地图底部按钮落回

- (void)bottomButtonFallBack

Declared In

tkmView.h

`– bottomButtonQuickFall`

底部按钮

- (void)bottomButtonQuickFall

Declared In

tkmView.h

`– gpsModeSwitch`

定位模式切换

- (tkmMapGPSMode)gpsModeSwitch

Return Value

切换后的模式

Declared In

tkmView.h

`– enterPickingMode:`

进入拾取模式

- (BOOL)enterPickingMode:(tkmMapPickingMode)mode

Parameters

`mode`	拾取对象的形状

Declared In

tkmView.h

`– exitPickingModeWithShapeName:`

退出拾取模式与直接对workMode赋值不同的是可以获得拾取的图形

- (tkmShape *)exitPickingModeWithShapeName:(NSString *)name

Parameters

`name`	图形的名称

Return Value

拾取的图形

Declared In

tkmView.h

`– addShape:`

添加图形

- (void)addShape:(tkmShape *)shape

Parameters

`shape`	要向地图中添加的图形

Declared In

tkmView.h

`– removeShape:`

移除图形

- (void)removeShape:(tkmShape *)shape

Parameters

`shape`	要从地图中移除的图形

Declared In

tkmView.h

`– removeAllShapes`

移除全部已经加入视图中的图形

- (void)removeAllShapes

Declared In

tkmView.h

`– addPin:withName:atPosition:forwards:offsetX:offsetY:`

添加地图图针

- (tkmMapPin *)addPin:(UIImage *)icon withName:(NSString *)name atPosition:(tkmPosition *)position forwards:(CGFloat)direction offsetX:(CGFloat)offsetX offsetY:(CGFloat)offsetY

Parameters

`icon`	图针图标
`name`	图针名称
`position`	图针经纬度
`direction`	方向
`offsetX`	图标偏移X
`offsetY`	图标偏移Y

Return Value

地图图针

Declared In

tkmView.h

`– removePin:`

移除图针

- (void)removePin:(tkmMapPin *)pin

Parameters

`pin`	被移除的图针

Declared In

tkmView.h

`– removePOIPin`

移除长按选点图针

- (void)removePOIPin

Declared In

tkmView.h

`– addMapTipView:`

向地图中添加tip

- (void)addMapTipView:(tkmMapPin *)tipView

Parameters

`tipView`	待添加的tip视图

Declared In

tkmView.h

`– removeTipView:`

从地图中移除地图

- (void)removeTipView:(UIView *)tipView

Parameters

`tipView`	待移除的tip视图

Declared In

tkmView.h

`– convertScreenPositionToLatlon:`

将屏幕坐标转为经纬度

- (tkmPosition *)convertScreenPositionToLatlon:(CGPoint)point

Parameters

`point`	地图视图上的坐标

Return Value

对应的实际经纬度

Declared In

tkmView.h

`– convertLatlonToScreenPosition:`

将经纬度转为屏幕坐标

- (CGPoint)convertLatlonToScreenPosition:(tkmPosition *)position

Parameters

`position`	经纬度

Return Value

地图视图中的坐标

Declared In

tkmView.h

`– isPositionVisible:`

经纬度是否在当前屏幕内可见

- (BOOL)isPositionVisible:(tkmPosition *)position

Parameters

`position`	经纬度

Return Value

为YES时，经纬度在屏幕范围

Declared In

tkmView.h

`– moveMapToLocation:zoomLevel:`

移动地图到相对应的地点和级别

- (BOOL)moveMapToLocation:(tkmPosition *)location zoomLevel:(CGFloat)level

Parameters

`location`	地图中心点经纬度
`level`	地图缩放级别

Return Value

是否成功跳转并缩放

Declared In

tkmView.h

`– moveMapToCity:`

移动地图到相对应的城市

- (BOOL)moveMapToCity:(NSString *)cityname

Parameters

`cityname`	城市名

Return Value

是否成功跳转到城市

Declared In

tkmView.h

`– zoomToRect:`

将视图缩放到指定区域的程度此方法不适用于纬度跨度过大的区域范围

- (BOOL)zoomToRect:(CGRect)rect

Parameters

`rect`	指定的区域

Return Value

是否成功跳转并缩放

Declared In

tkmView.h

`– zoomToRect:intoViewRect:`

将视图缩放到指定区域的程度

- (BOOL)zoomToRect:(CGRect)rect intoViewRect:(CGRect)scrRect

Parameters

`rect`	指定的区域
`scrRect`	屏幕上指定的区域

Return Value

是否成功跳转并缩放

Declared In

tkmView.h

`– getViewStatus`

备份地图的状态

- (tkmViewStatus *)getViewStatus

Return Value

地图的状态实例

Declared In

tkmView.h

`– recoverViewStatus:`

恢复地图状态

- (void)recoverViewStatus:(tkmViewStatus *)status

Parameters

`status`	地图状态

Declared In

tkmView.h

`– getButtonsLayout:`

获取地图上的按钮布局信息

- (NSDictionary *)getButtonsLayout:(NSArray *)namelist

Parameters

`namelist`	名字列表，可以是视图保留按钮的名字，也可以是自定义按钮的名字，视图保留的名字如下： `@"gps" 定位按钮` `@"tools" 工具箱按钮` `@"ruler" 测距按钮` `@"clear" 清楚按钮` `@"zoomin" 放大按钮` `@"zoomout" 缩小按钮` `@"compass" 罗盘按钮`

namelist

名字列表，可以是视图保留按钮的名字，也可以是自定义按钮的名字，视图保留的名字如下：

```
@"gps"      定位按钮
```
```
@"tools"    工具箱按钮
```
```
@"ruler"    测距按钮
```
```
@"clear"    清楚按钮
```
```
@"zoomin"   放大按钮
```
```
@"zoomout"  缩小按钮
```
```
@"compass"  罗盘按钮
```

Return Value

按钮名字于其位置的对应字典

Declared In

tkmView.h

`– getAllButtonsLayout`

获取地图上的所有按钮布局信息

- (NSDictionary *)getAllButtonsLayout

Return Value

按钮名字于其位置的对应字典，与[tkmView getButtonLayout:]类似

Declared In

tkmView.h

`– recoverButtonsLayout:`

按保存的地图按钮布局信息恢复按钮位置

- (void)recoverButtonsLayout:(NSDictionary *)layout

Parameters

`layout`	从[tkmView getButtonLayout:]或者[tkmView getAllButtonsLayout]中获取的字典

Declared In

tkmView.h

`– addButton:withName:`

向地图视图添加按钮

- (BOOL)addButton:(UIButton *)button withName:(NSString *)name

Parameters

`button`	按钮
`name`	按钮的名称，名字不要使用视图保留的按钮名字，视图保留的名字如下： `@"gps" 定位按钮` `@"tools" 工具箱按钮` `@"ruler" 测距按钮` `@"clear" 清楚按钮` `@"zoomin" 放大按钮` `@"zoomout" 缩小按钮` `@"compass" 罗盘按钮` `@"scale" 比例尺`

button

按钮

name

按钮的名称，名字不要使用视图保留的按钮名字，视图保留的名字如下：

```
@"gps"      定位按钮
```
```
@"tools"    工具箱按钮
```
```
@"ruler"    测距按钮
```
```
@"clear"    清楚按钮
```
```
@"zoomin"   放大按钮
```
```
@"zoomout"  缩小按钮
```
```
@"compass"  罗盘按钮
```
```
@"scale"    比例尺
```

Return Value

是否添加成功，如果成功为YES

Declared In

tkmView.h

`– getButtonByName:`

以名字获取按钮

- (UIButton *)getButtonByName:(NSString *)name

Parameters

`name`	按钮的名字

Return Value

名称为name的按钮，如果不存在则返回nil

Declared In

tkmView.h

`– removeButtonWithName:`

按名字清除按钮

- (void)removeButtonWithName:(NSString *)name

Parameters

`name`	需要清除的按钮名称

Declared In

tkmView.h

`– removeAllCustomButton`

清除所有用户添加的按钮

- (void)removeAllCustomButton

Declared In

tkmView.h

`– addedButtonNames`

获得所有添加到地图上的用户按钮的名字

- (NSArray *)addedButtonNames

Return Value

所有添加到地图上的用户按钮的名字数组

Declared In

tkmView.h

`– captureMapImage`

获取当前屏幕地图的截图

- (UIImage *)captureMapImage

Return Value

地图的截图对象

Declared In

tkmView.h

tkmView Class Reference

Declared In

See Also

Declared In

Discussion

Declared In

Discussion

Declared In

Discussion

Declared In

Declared In

Declared In

Declared In

Declared In

Declared In

Declared In

Declared In

Declared In

Declared In

Declared In

Declared In

See Also

Declared In

Declared In

Declared In

Declared In

Declared In

Declared In

Declared In

Declared In

Declared In

Declared In

Declared In

Parameters

Declared In

Parameters

Declared In

Declared In

Declared In

Parameters

Declared In

Declared In

Declared In

Return Value

Declared In

Parameters

Declared In

Parameters

Return Value

See Also

Declared In

Parameters

See Also

Declared In

Parameters

See Also

Declared In

Declared In

Parameters

Return Value

See Also

Declared In

Parameters

See Also

Declared In

Declared In

Parameters

See Also

Declared In

Parameters

Declared In

Parameters

Return Value

See Also

Declared In

Parameters

Return Value

See Also

Declared In

Parameters