97 lines
3.7 KiB
Objective-C
97 lines
3.7 KiB
Objective-C
//
|
|
// MAGroundOverlay.h
|
|
// MapKit_static
|
|
//
|
|
// Created by Li Fei on 11/12/13.
|
|
// Copyright © 2016 Amap. All rights reserved.
|
|
//
|
|
|
|
#import "MAConfig.h"
|
|
|
|
#if MA_INCLUDE_OVERLAY_GROUND
|
|
|
|
#import <UIKit/UIKit.h>
|
|
#import "MAShape.h"
|
|
#import "MAOverlay.h"
|
|
|
|
///该类用于确定覆盖在地图上的图片，及其覆盖区域, 通常MAGroundOverlay是MAGroundOverlayRenderer的model
|
|
///This class is used to determine the images overlaid on the map and their coverage areas. Typically, MAGroundOverlay is the model of MAGroundOverlayRenderer.
|
|
@interface MAGroundOverlay : MAShape<MAOverlay>
|
|
|
|
///绘制在地图上的覆盖图片
|
|
///Overlay image drawn on the map
|
|
@property (nonatomic, readonly) UIImage *icon;
|
|
|
|
///透明度. 最终透明度 = 纹理透明度 * alpha. 有效范围为[0.f, 1.f], 默认为1.f
|
|
///Transparency. Final transparency = texture transparency * alpha. Valid range is [0.f, 1.f], default is 1.f
|
|
@property (nonatomic, assign) CGFloat alpha __attribute((deprecated("Deprecated, since 7.7.0, please use alpha in MAGroundOverlayRenderer")));
|
|
|
|
///覆盖图片在地图尺寸等同于其像素的zoom值
|
|
///The zoom level at which the overlay image's size on the map equals its pixel dimensions.
|
|
@property (nonatomic, readonly) CGFloat zoomLevel;
|
|
|
|
///图片在地图中的覆盖范围
|
|
///Image coverage area on the map
|
|
@property (nonatomic, readonly) MACoordinateBounds bounds;
|
|
|
|
/**
|
|
* @brief 根据bounds值和icon生成GroundOverlay
|
|
* Generate GroundOverlay based on bounds and icon
|
|
* @param bounds 图片的在地图的覆盖范围
|
|
* Image coverage area on the map
|
|
* @param icon 覆盖图片
|
|
* Overlay image
|
|
* @return 以bounds和icon 新生成GroundOverlay
|
|
* Create a new GroundOverlay with bounds and icon
|
|
*/
|
|
+ (instancetype)groundOverlayWithBounds:(MACoordinateBounds)bounds
|
|
icon:(UIImage *)icon;
|
|
|
|
/**
|
|
* @brief 根据coordinate,icon,zoomLevel生成GroundOverlay
|
|
* Generate GroundOverlay based on coordinate, icon, and zoomLevel
|
|
* @param coordinate 图片的在地图上的中心点
|
|
* The center point of the image on the map
|
|
* @param zoomLevel 图片在地图尺寸等同于像素的zoom值
|
|
* The zoom value where the image size on the map equals its pixel dimensions
|
|
* @param icon 覆盖图片
|
|
* Overlay image
|
|
* @return 以coordinate,icon,zoomLevel 新生成GroundOverlay
|
|
* Create a new GroundOverlay with coordinate, icon, zoomLevel
|
|
*/
|
|
+ (instancetype)groundOverlayWithCoordinate:(CLLocationCoordinate2D)coordinate
|
|
zoomLevel:(CGFloat)zoomLevel
|
|
icon:(UIImage *)icon;
|
|
|
|
/**
|
|
* @brief 更新GroundOverlay. since 5.0.0
|
|
* Update GroundOverlay. since 5.0.0
|
|
* @param bounds 图片的在地图的覆盖范围
|
|
* Image coverage on the map
|
|
* @param icon 覆盖图片
|
|
* Overlay image
|
|
* @return 返回是否成功
|
|
* Return success status
|
|
*/
|
|
- (BOOL)setGroundOverlayWithBounds:(MACoordinateBounds)bounds icon:(UIImage *)icon;
|
|
|
|
/**
|
|
* @brief 更新GroundOverlay, 内部会自动计算覆盖物大小，以满足zoomLevel下显示大小为icon大小. since 5.0.0
|
|
* Update GroundOverlay, the system will automatically calculate the overlay size to ensure the display size matches the icon size at the zoomLevel. since 5.0.0
|
|
* @param coordinate 图片在地图上的中心点
|
|
* The center point of the image on the map
|
|
* @param zoomLevel 图片在地图尺寸等同于像素的zoom值
|
|
* The zoom value where the image size on the map equals its pixel dimensions
|
|
* @param icon 覆盖图片
|
|
* Overlay image
|
|
* @return 返回是否成功
|
|
* Return success status
|
|
*/
|
|
- (BOOL)setGroundOverlayWithCoordinate:(CLLocationCoordinate2D)coordinate
|
|
zoomLevel:(CGFloat)zoomLevel
|
|
icon:(UIImage *)icon;
|
|
|
|
@end
|
|
|
|
#endif
|