NMFPath


@interface NMFPath : NMFOverlay

지도에 경로선을 나타내는 오버레이. 하나의 선을 나타낸다는 측면에서는 NMFPolylineOverlay와 유사하나, 다음과 같이 경로선에 특화된 특징이 있습니다.

  • 테두리와 패턴 이미지를 적용할 수 있습니다.
  • 지도를 기울이더라도 두께가 일정하게 유지됩니다.
  • 자기교차(self-intersection)가 일어나더라도 테두리, 패턴 이미지가 자연스럽게 나타납니다.
  • 진척률을 지정할 수 있으며, 지나온/지나갈 경로에 각각 다른 색상과 테두리를을 지정할 수 있습니다.
  • 점선 패턴, 끝 지점/연결점의 모양은 지정할 수 없습니다.

  • 경로선의 색상. 경로선의 색상은 반투명일 수 없으며, 완전히 투명하거나 완전히 불투명해야 합니다. 색상의 알파가 0이 아닌 경우 완전히 불투명한 것으로 간주됩니다. 색상이 투명할 경우 테두리도 그려지지 않습니다.

    기본값은 UIColor.whiteColor입니다.

    Declaration

    Objective-C

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

    Swift

    var color: UIColor { get set }

  • 경로선의 테두리 색상. 경로선의 테두리 색상은 반투명일 수 없으며, 완전히 투명하거나 완전히 불투명해야 합니다. 색상의 알파가 0이 아닌 경우 완전히 불투명한 것으로 간주됩니다.

    기본값은 UIColor.blackColor입니다.

    Declaration

    Objective-C

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

    Swift

    var outlineColor: UIColor { get set }

  • 지나온 경로선의 색상. 지나온 경로선의 색상은 반투명일 수 없으며, 완전히 투명하거나 완전히 불투명해야 합니다. 색상의 알파가 0이 아닌 경우 완전히 불투명한 것으로 간주됩니다. 색상이 투명할 경우 테두리도 그려지지 않습니다.

    기본값은 UIColor.whiteColor입니다.

    Declaration

    Objective-C

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

    Swift

    var passedColor: UIColor { get set }

  • 지나온 경로선의 테두리 색상. 지나온 경로선의 테두리 색상은 반투명일 수 없으며, 완전히 투명하거나 완전히 불투명해야 합니다. 색상의 알파가 0이 아닌 경우 완전히 불투명한 것으로 간주됩니다. 색상이 투명할 경우 테두리도 그려지지 않습니다.

    기본값은 UIColor.blackColor입니다.

    Declaration

    Objective-C

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

    Swift

    var passedOutlineColor: UIColor { get set }

  • 두께. pt 단위.

    기본값은 5입니다.

    Declaration

    Objective-C

    @property (nonatomic) CGFloat width;

    Swift

    var width: CGFloat { get set }

  • 테두리 두께. pt 단위. 0일 경우 테두리가 그려지지 않습니다.

    기본값은 1입니다.

    Declaration

    Objective-C

    @property (nonatomic) CGFloat outlineWidth;

    Swift

    var outlineWidth: CGFloat { get set }

  • 경로선 오버레이를 나타내는 NMGLineString객체. 경로선 오버레이를 생성한 이후 경로선을 갱신하기 위한 목적으로 사용할 수 있습니다.

    Declaration

    Objective-C

    @property (nonatomic) NMGLineString *_Nonnull path;

    Swift

    var path: NMGLineString<AnyObject> { get set }

  • 진척률. 값의 범위는 -1~1입니다. 경로는 진척률을 기준으로 지나온 경로와 지나갈 경로로 구분됩니다. 지나온 경로에는 passedColor와 passedOutlineColor가 사용되고 지나갈 경로에는 color와 outlineColor가 사용됩니다.

    • 진척률을 양수로 지정하면 첫 좌표부터 진척률만큼 떨어진 지점까지의 선형은 지나온 경로로, 나머지는 지나갈 경로로 간주됩니다.
    • 진척률을 음수로 지정하면 마지막 좌표부터 -진척률만큼 떨어진 지점까지의 선형은 지나온 경로로, 나머지는 지나갈 경로로 간주됩니다.
    • 진척률을 0으로 지정하면 모든 선형이 지나갈 경로로 간주됩니다.

    기본값은 0입니다.

    Declaration

    Objective-C

    @property (nonatomic) double progress;

    Swift

    var progress: Double { get set }

  • 패턴 이미지의 간격. pt 단위. 0일 경우 패턴을 표시하지 않습니다.

    기본값은 25입니다.

    Declaration

    Objective-C

    @property (nonatomic) NSUInteger patternInterval;

    Swift

    var patternInterval: UInt { get set }

  • 패턴 이미지. 패턴 이미지의 크기가 경로선의 두께보다 클 경우 경로선의 두께에 맞게 축소됩니다. nil일 경우 패턴을 표시하지 않습니다.

    Declaration

    Objective-C

    @property (nonatomic, strong, nullable) NMFOverlayImage *patternIcon;

    Swift

    var patternIcon: NMFOverlayImage? { 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 }

  • 좌표열을 지정하여 경로선 오버레이를 생성합니다. coords의 크기는 2 이상이어야 합니다.

    사용 예시

    NMFLatLng *p1 = [[NMFLatLng alloc]initWithLat:37.20 lng:127.051]];
NMFLatLng *p2 = [[NMFLatLng alloc]initWithLat:37.21 lng:127.052]];
NMFLatLng *p3 = [[NMFLatLng alloc]initWithLat:37.22 lng:127.053]];
NMFPath *route = [NMFPath pathWithPoints:@[p1, p2, p3]];
route.mapView = mapView;

    Declaration

    Objective-C

    + (nullable instancetype)pathWithPoints:(nonnull NSArray<NMGLatLng *> *)coords;

    Swift

    convenience init?(points coords: [NMGLatLng])

    Parameters

    coords

    좌표열.

    Return Value

    NMFPath 객체.

  • NMGLineString을 지정하여 경로선 오버레이를 생성합니다. NMGLineString객체의 isValid속성이 NO일 경우 nil을 리턴합니다.

    Declaration

    Objective-C

    + (nullable instancetype)pathWithLineString:(nonnull NMGLineString *)path;

    Swift

    convenience init?(lineString path: NMGLineString<AnyObject>)

    Parameters

    path

    NMGLineString 객체.

    Return Value

    NMFPath 객체.