ZMSGroundOverlay

Objective-C

@interface ZMSGroundOverlay : ZMSOverlay

Swift

class ZMSGroundOverlay : ZMSOverlay

グラウンドオーバーレイクラス

地図上に画像を重畳する。

  • 座標

    画像の基準の座標。

    Note

    緯度 / 経度

    Declaration

    Objective-C

    @property (nonatomic) CLLocationCoordinate2D position;

    Swift

    var position: CLLocationCoordinate2D { get set }

  • 画像

    Note

    NULLの場合は何も表示されない。

    Declaration

    Objective-C

    @property (nonatomic, nullable) UIImage *icon;

    Swift

    var icon: UIImage? { get set }

  • 表示角度

    position を基準に画像を回転させる。

    Note

    position は anchor により変動する。
    有効範囲: 0 - 360度 (時計回り)
    デフォルト値: 0
    有効範囲を超えた分は循環し、360度以内に正規化される。

    Declaration

    Objective-C

    @property (nonatomic) CLLocationDirection bearing;

    Swift

    var bearing: CLLocationDirection { get set }

  • 画像の重心

    この値によって position の位置が変わり、bearing で回転する際の基準点になる。

    Note

    有効範囲: x: 0.0 - 1.0, y: 0.0 - 1.0
    デフォルト値: x: 0.5, y: 0.5
    画像の左上が原点[0.0, 0.0]、[1.0, 1.0]は画像の右下になる。
    有効範囲を超えた分は有効範囲内に正規化される。

    Declaration

    Objective-C

    @property (nonatomic) CGPoint anchor;

    Swift

    var anchor: CGPoint { get set }

  • 領域

    画像を表示する地図上の領域。

    Declaration

    Objective-C

    @property (nonatomic, nullable) ZMSCoordinateBounds *bounds;

    Swift

    var bounds: ZMSCoordinateBounds? { get set }

  • 領域と画像からZMSGroundOverlayを作成する

    Warning

    領域か画像が不正な場合はNULLが戻る。

    Declaration

    Objective-C

    + (nullable instancetype)groundOverlayWithBounds:
                             (nonnull ZMSCoordinateBounds *)bounds
                                            icon:(nullable UIImage *)icon;

    Swift

    convenience init?(bounds: ZMSCoordinateBounds, icon: UIImage?)

    Parameters

    bounds:

    領域
    icon:

    画像

    Return Value

    グラウンドオーバーレイ

  • 座標と画像とズームレベルからZMSGroundOverlayを作成する

    指定されたズームレベルで地図を表示した際に、指定された画像のサイズとスクリーン上のサイズが一致するように設置される。
    指定された座標が画像の中心となるように配置される。

    Warning

    座標か画像かズームレベルが不正な場合はNULLが戻る。

    Note

    ズームレベルの有効範囲: 2.0 - 21.0 (2.0が最も引いた状態)
    有効範囲を超えた分は有効範囲内に正規化される。

    Declaration

    Objective-C

    + (nullable instancetype)groundOverlayWithPosition:
                             (CLLocationCoordinate2D)position
                                              icon:(nullable UIImage *)icon
                                         zoomLevel:(CGFloat)zoomLevel;

    Swift

    convenience init?(position: CLLocationCoordinate2D, icon: UIImage?, zoomLevel: CGFloat)

    Parameters

    position:

    座標(緯度/経度)
    icon:

    画像
    zoomLevel:

    ズームレベル

    Return Value

    グラウンドオーバーレイ