NMFMultipartPath


@interface NMFMultipartPath : NMFOverlay

경로선을 여러 파트로 나누어 각각 다른 색상을 부여할 수 있는 특수한 NMFPath. 다양한 색상으로 구성된 경로선을 나타내려면 여러 개의 NMFPath를 사용하는 것보다 이 클래스를 사용하는 것이 효율적입니다. MultipartPathOverlay는 좌표열 파트의 목록와 색상 파트의 목록으로 구성되며, 0번째 좌표열 파트에 0번째 색상 파트의 색상이 적용됩니다. 따라서 좌표열 파트와 색상 파트의 크기가 동일해야 합니다.

  • 좌표열 파트의 목록. 목록의 크기가 1이상이어야 합니다.

    Declaration

    Objective-C

    @property (nonatomic, strong) NSArray<NMGLineString *> *_Nonnull lineParts;

    Swift

    var lineParts: [NMGLineString<AnyObject>] { get set }

  • 색상 파트의 목록. 목록의 크기가 1 이상, 각 파트의 크기가 2 이상이어야 합니다.

    Declaration

    Objective-C

    @property (nonatomic, strong) NSArray<NMFPathColor *> *_Nonnull colorParts;

    Swift

    var colorParts: [NMFPathColor] { get set }

  • 두께. pt 단위.

    기본값은 5입니다.

    Declaration

    Objective-C

    @property (nonatomic) CGFloat width;

    Swift

    var width: CGFloat { get set }

  • 테두리 두께. pt 단위.

    기본값은 1입니다.

    Declaration

    Objective-C

    @property (nonatomic) CGFloat outlineWidth;

    Swift

    var outlineWidth: CGFloat { 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일 경우 패턴을 표시하지 않습니다.

    기본값은 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 }

  • 좌표열 파트의 목록을 지정하여 NMFMultipartPath 객체를 생성합니다. 각 파트의 크기는 2이상이어야 합니다.

    NMFMultipartPath *mPath = [NMFMultipartPath multipartPathWithCoordParts:@[
   @[NMGLatLngMake(37.20, 127.051),
     NMGLatLngMake(37.21, 127.052),
     NMGLatLngMake(37.22, 127.053)],
   @[NMGLatLngMake(37.23, 127.054),
     NMGLatLngMake(37.24, 127.055),
     NMGLatLngMake(37.25, 127.056)]
]];
mPath.mapView = mapView;

    Declaration

    Objective-C

    + (nullable instancetype)multipartPathWith:
    (nonnull NSArray<NSArray<NMGLatLng *> *> *)coordParts;

    Swift

    convenience init?(_ coordParts: [[NMGLatLng]])

    Parameters

    coordParts

    좌표열 파트의 목록.

    Return Value

    NMFMultipartPath 객체.

  • NMGLineString배열을 지정하여 NMFMultipartPath 객체를 생성합니다. 배열내 NMGLineString객체의 isValid 속성이 NO일 경우 nil을 리턴합니다.

    Declaration

    Objective-C

    + (nullable instancetype)multipartPath:
    (nonnull NSArray<NMGLineString *> *)lineParts;

    Swift

    convenience init?(_ lineParts: [NMGLineString<AnyObject>])

    Parameters

    lineParts

    NMGLineString파트의 목록.

    Return Value

    NMFMultipartPath 객체.