NMFMarker


@interface NMFMarker : NMFOverlay

아이콘과 캡션을 이용해 지도 위의 한 지점을 표시하는 오버레이.

  • tag

    사용자가 임의로 지정할 수 있는 태그. 마커를 그루핑하거나 구분하기 위한 목적으로 사용할 수 있습니다.

    Declaration

    Objective-C

    @property (nonatomic) NSUInteger tag;

    Swift

    var tag: UInt { get set }

  • 아이콘.

    Declaration

    Objective-C

    @property (nonatomic, strong) NMFOverlayImage *_Nonnull iconImage;

    Swift

    var iconImage: NMFOverlayImage { get set }

  • 아이콘에 덧입힐 색상. 덧입힐 색상을 지정하면 덧입힐 색상이 아이콘 이미지의 색상과 가산 혼합됩니다. 단, 덧입힐 색상의 알파는 무시됩니다.

    기본값은 UIColor.clearColor입니다.

    Declaration

    Objective-C

    @property (nonatomic, strong) UIColor *_Nonnull iconTintColor;

    Swift

    var iconTintColor: UIColor { get set }

  • 아이콘의 너비. pt 단위. NMF_MARKER_SIZE_AUTO일 경우 이미지의 너비를 따릅니다.

    기본값은 NMF_MARKER_SIZE_AUTO입니다.

    Declaration

    Objective-C

    @property (nonatomic) CGFloat width;

    Swift

    var width: CGFloat { get set }

  • 아이콘의 높이. pt 단위. NMF_MARKER_SIZE_AUTO일 경우 이미지의 높이를 따릅니다.

    기본값은 NMF_MARKER_SIZE_AUTO입니다.

    Declaration

    Objective-C

    @property (nonatomic) CGFloat height;

    Swift

    var height: CGFloat { get set }

  • 아이콘에 원근 효과를 적용할지 여부. 원근 효과를 적용할 경우 가까운 아이콘은 크게, 먼 아이콘은 작게 표시됩니다.

    기본값은 NO입니다.

    Declaration

    Objective-C

    @property (nonatomic) BOOL iconPerspectiveEnabled;

    Swift

    var iconPerspectiveEnabled: Bool { get set }

  • 캡션에 원근 효과를 적용할지 여부. 원근 효과를 적용할 경우 가까운 캡션은 크게, 먼 캡션은 작게 표시됩니다.

    기본값은 NO입니다.

    Declaration

    Objective-C

    @property (nonatomic) BOOL captionPerspectiveEnabled;

    Swift

    var captionPerspectiveEnabled: Bool { get set }

  • 마커를 평평하게 설정할지 여부. 마커가 평평할 경우 지도가 회전하거나 기울어지면 마커 이미지도 함께 회전하거나 기울어집니다. 단, 마커가 평평하더라도 이미지의 크기는 항상 동일하게 유지됩니다.

    기본값은 NO입니다.

    Declaration

    Objective-C

    @property (nonatomic, getter=isFlat) BOOL flat;

    Swift

    var isFlat: Bool { get set }

  • 마커와 지도 심벌이 겹칠 경우 지도 심벌을 숨길지 여부.

    기본값은 NO입니다.

    Declaration

    Objective-C

    @property (nonatomic) BOOL isHideCollidedSymbols;

    Swift

    var isHideCollidedSymbols: Bool { get set }

  • 마커와 다른 마커가 겹칠 경우 다른 마커를 숨길지 여부.

    기본값은 NO입니다.

    Declaration

    Objective-C

    @property (nonatomic) BOOL isHideCollidedMarkers;

    Swift

    var isHideCollidedMarkers: Bool { get set }

  • 마커와 다른 마커의 캡션이 겹칠 경우 다른 마커의 캡션을 숨길지 여부.

    기본값은 NO입니다.

    Declaration

    Objective-C

    @property (nonatomic) BOOL isHideCollidedCaptions;

    Swift

    var isHideCollidedCaptions: Bool { get set }

  • 마커가 isHideCollidedMarkers이 YES인 다른 마커와 겹치더라도 아이콘을 무조건 표시할지 여부.

    기본값은 NO입니다.

    Declaration

    Objective-C

    @property (nonatomic) BOOL isForceShowIcon;

    Swift

    var isForceShowIcon: Bool { get set }

  • 마커가 isHideCollidedCaptions이 YES인 다른 마커와 겹치더라도 캡션을 무조건 표시할지 여부.

    기본값은 NO입니다.

    Declaration

    Objective-C

    @property (nonatomic) BOOL isForceShowCaption;

    Swift

    var isForceShowCaption: Bool { get set }

  • 좌표. 마커를 지도에 추가하기 전에 반드시 이 속성에 값을 지정해야 합니다.

    Declaration

    Objective-C

    @property (nonatomic, strong) NMGLatLng *_Nonnull position;

    Swift

    var position: NMGLatLng { get set }

  • 불투명도. 0일 경우 완전히 투명, 1일 경우 완전히 불투명함을 의미합니다.

    기본값은 1입니다.

    Declaration

    Objective-C

    @property (nonatomic) CGFloat alpha;

    Swift

    var alpha: CGFloat { get set }

  • 앵커. 앵커는 아이콘 이미지에서 기준이 되는 지점을 의미합니다. 앵커로 지정된 지점이 정보 창의 좌표에 위치합니다. 값의 범위는 (0, 0)~(1, 1)이며, (0, 0)일 경우 이미지의 왼쪽 위, (1, 1)일 경우 이미지의 오른쪽 아래를 의미합니다.

    기본값은 (0.5, 1)입니다.

    Declaration

    Objective-C

    @property (nonatomic) CGPoint anchor;

    Swift

    var anchor: CGPoint { get set }

  • 아이콘의 각도. 도 단위. 각도를 지정하면 아이콘이 해당 각도만큼 시계 방향으로 회전합니다.

    기본값은 0입니다.

    Declaration

    Objective-C

    @property (nonatomic) CGFloat angle;

    Swift

    var angle: CGFloat { get set }

  • 캡션 텍스트. 빈 문자열일 경우 캡션이 표시되지 않습니다.

    기본값은 빈 문자열입니다.

    Declaration

    Objective-C

    @property (nonatomic, copy) NSString *_Nonnull captionText;

    Swift

    var captionText: String { get set }

  • 캡션의 텍스트 색상.

    기본값은 UIColor.blackColor입니다.

    Declaration

    Objective-C

    @property (nonatomic, strong) UIColor *_Nonnull captionColor;

    Swift

    var captionColor: UIColor { get set }

  • 캡션의 외곽 색상.

    기본값은 UIColor.whiteColor입니다.

    Declaration

    Objective-C

    @property (nonatomic, strong) UIColor *_Nonnull captionHaloColor;

    Swift

    var captionHaloColor: UIColor { get set }

  • 캡션의 텍스트 크기. pt 단위.

    기본값은 12입니다.

    Declaration

    Objective-C

    @property (nonatomic) CGFloat captionTextSize;

    Swift

    var captionTextSize: CGFloat { get set }

  • 캡션의 너비. pt 단위. 지정할 경우 한 줄의 너비가 희망 너비를 초과하는 캡션 텍스트가 자동으로 개행됩니다. 자동 개행은 어절 단위로 이루어지므로, 하나의 어절이 길 경우 캡션의 너비가 희망 너비를 초과할 수 있습니다. 0일 경우 너비를 제한하지 않습니다.

    기본값은 0입니다.

    Declaration

    Objective-C

    @property (nonatomic) CGFloat captionRequestedWidth;

    Swift

    var captionRequestedWidth: CGFloat { get set }

  • 캡션이 보이는 최소 줌 레벨. 지도의 줌 레벨이 캡션의 최소 줌 레벨보다 작을 경우 아이콘만 나타나고 주 캡션 및 보조 캡션은 나타나지 않습니다.

    기본값은 NMF_MIN_ZOOM입니다.

    Declaration

    Objective-C

    @property (nonatomic) double captionMinZoom;

    Swift

    var captionMinZoom: Double { get set }

  • 캡션이 보이는 최대 줌 레벨. 지도의 줌 레벨이 캡션의 최대 줌 레벨보다 클 경우 아이콘만 나타나고 주 캡션 및 보조 캡션은 나타나지 않습니다.

    기본값은 NMF_MAX_ZOOM입니다.

    Declaration

    Objective-C

    @property (nonatomic) double captionMaxZoom;

    Swift

    var captionMaxZoom: Double { get set }

  • 보조 캡션의 텍스트. 보조 캡션은 주 캡션의 아래에 나타납니다. 빈 문자열일 경우 보조 캡션이 표시되지 않습니다.

    기본값은 빈 문자열입니다.

    Declaration

    Objective-C

    @property (nonatomic, copy) NSString *_Nonnull subCaptionText;

    Swift

    var subCaptionText: String { get set }

  • 보조 캡션의 텍스트 색상.

    기본값은 UIColor.blackColor입니다.

    Declaration

    Objective-C

    @property (nonatomic, strong) UIColor *_Nonnull subCaptionColor;

    Swift

    var subCaptionColor: UIColor { get set }

  • 보조 캡션의 외곽 색상.

    기본값은 UIColor.whiteColor입니다.

    Declaration

    Objective-C

    @property (nonatomic, strong) UIColor *_Nonnull subCaptionHaloColor;

    Swift

    var subCaptionHaloColor: UIColor { get set }

  • 보조 캡션의 텍스트 크기. pt 단위.

    기본값은 12입니다.

    Declaration

    Objective-C

    @property (nonatomic) CGFloat subCaptionTextSize;

    Swift

    var subCaptionTextSize: CGFloat { get set }

  • 보조 캡션의 너비. pt 단위. 지정할 경우 한 줄의 너비가 희망 너비를 초과하는 캡션 텍스트가 자동으로 개행됩니다. 자동 개행은 어절 단위로 이루어지므로, 하나의 어절이 길 경우 캡션의 너비가 희망 너비를 초과할 수 있습니다. 0일 경우 너비를 제한하지 않습니다.

    기본값은 0입니다.

    Declaration

    Objective-C

    @property (nonatomic) CGFloat subCaptionRequestedWidth;

    Swift

    var subCaptionRequestedWidth: CGFloat { get set }

  • 보조 캡션이 보이는 최소 줌 레벨. 지도의 줌 레벨이 보조 캡션의 최소 줌 레벨보다 작을 경우 아이콘 및 주 캡션만 나타나고 보조 캡션은 나타나지 않습니다.

    기본값은 NMF_MIN_ZOOM입니다.

    Declaration

    Objective-C

    @property (nonatomic) double subCaptionMinZoom;

    Swift

    var subCaptionMinZoom: Double { get set }

  • 보조 캡션이 보이는 최대 줌 레벨. 지도의 줌 레벨이 보조 캡션의 최대 줌 레벨보다 클 경우 아이콘 및 주 캡션만 나타나고 보조 캡션은 나타나지 않습니다.

    기본값은 NMF_MAX_ZOOM입니다.

    Declaration

    Objective-C

    @property (nonatomic) double subCaptionMaxZoom;

    Swift

    var subCaptionMaxZoom: Double { get set }

  • 캡션 아이콘의 정렬 방향.

    기본값은 NMFAlignBottom입니다.

    Warning

    Deprecated. captionAligns 속성을 사용하세요.

    Declaration

    Objective-C

    @property (nonatomic) NMFAlign captionAlign;

    Swift

    var captionAlign: NMFAlign { get set }

  • 캡션을 아이콘의 어느 방향에 위치시킬지를 지정합니다. 캡션은 captionAligns 배열에 지정된 순서대로 우선적으로 위치합니다. 만약 캡션이 다른 마커와 겹치지 않거나 겹치더라도 해당 마커의 isHideCollidedCaptions가 NO라면 캡션은 반드시 captionAligns[0]에 위치합니다. 그렇지 않을 경우 겹치지 않은 다음 방향에 위치하며, 어느 방향으로 위치시켜도 다른 마커와 겹칠 경우 캡션이 숨겨집니다.

    기본값은 NMFAlignType.bottom입니다.

    See

    NMFAlignType

    Declaration

    Objective-C

    @property (nonatomic) NSArray<NMFAlignType *> *_Nonnull captionAligns;

    Swift

    var captionAligns: [NMFAlignType] { get set }

  • 아이콘과 캡션 간의 여백.

    기본값은 0입니다.

    Declaration

    Objective-C

    @property (nonatomic) CGFloat captionOffset;

    Swift

    var captionOffset: CGFloat { get set }

  • 마커에 열려 있는 정보 창.

    Declaration

    Objective-C

    @property (nonatomic, strong, readonly, nullable) NMFInfoWindow *infoWindow;

    Swift

    var infoWindow: NMFInfoWindow? { get }

  • 위치를 지정하여 마커를 생성합니다.

    Declaration

    Objective-C

    + (nonnull instancetype)markerWithPosition:(nonnull NMGLatLng *)position;

    Swift

    convenience init(position: NMGLatLng)

    Parameters

    position

    좌표.

    Return Value

    NMFMarker 객체.

  • 위치와 아이콘을 지정하여 마커를 생성합니다.

    Declaration

    Objective-C

    + (nonnull instancetype)markerWithPosition:(nonnull NMGLatLng *)position
                                 iconImage:(nonnull NMFOverlayImage *)iconImage;

    Swift

    convenience init(position: NMGLatLng, iconImage: NMFOverlayImage)

    Parameters

    position

    좌표.
    iconImage

    아이콘.

    Return Value

    NMFMarker 객체.