NMCComplexBuilder


@interface NMCComplexBuilder<
    __covariant KeyType : NSObject <NMCClusteringKey> *> : NSObject

NMCClusterer를 생성하는 빌더 클래스. 복잡한 전략과 기능을 제공합니다. 간단한 기능만 필요하다면 NMCBuilder를 사용하는 것을 권장합니다.

  • 두 NMCNode를 클러스터링할 기준 거리를 구하는 전략.

    Declaration

    Objective-C

    @property (nonatomic, nonnull) id<NMCThresholdStrategy> thresholdStrategy;

    Swift

    var thresholdStrategy: any NMCThresholdStrategy { get set }

  • 두 NMCNode간의 거리를 측정하는 전략.

    Declaration

    Objective-C

    @property (nonatomic, nonnull) id<NMCDistanceStrategy> distanceStrategy;

    Swift

    var distanceStrategy: any NMCDistanceStrategy { get set }

  • 두 NMCCluster의 좌표를 정하는 전략.

    Declaration

    Objective-C

    @property (nonatomic, nonnull) id<NMCPositioningStrategy> positioningStrategy;

    Swift

    var positioningStrategy: any NMCPositioningStrategy { get set }

  • 부모 NMCCluster의 자식 NMCNode들의 태그를 병합하는 전략.

    Declaration

    Objective-C

    @property (nonatomic, nonnull) id<NMCTagMergeStrategy> tagMergeStrategy;

    Swift

    var tagMergeStrategy: any NMCTagMergeStrategy { get set }

  • NMCClusterer에서 노출하는 마커를 관리하는 매니저.

    Declaration

    Objective-C

    @property (nonatomic, nonnull) id<NMCMarkerManager> markerManager;

    Swift

    var markerManager: any NMCMarkerManager { get set }

  • 클러스터 마커의 정보를 NMFMarker 객체에 반영하는 업데이터.

    기본값은 NMCDefaultClusterMarkerUpdater 인스턴스입니다.

    Declaration

    Objective-C

    @property (nonatomic, nonnull) id<NMCClusterMarkerUpdater> clusterMarkerUpdater;

    Swift

    var clusterMarkerUpdater: any NMCClusterMarkerUpdater { get set }

  • 단말 마커의 정보를 NMFMarker 객체에 반영하는 업데이터.

    기본값은 NMCDefaultLeafMarkerUpdater 인스턴스입니다.

    Declaration

    Objective-C

    @property (nonatomic, nonnull) id<NMCLeafMarkerUpdater> leafMarkerUpdater;

    Swift

    var leafMarkerUpdater: any NMCLeafMarkerUpdater { get set }

  • 클러스터링할 최소 줌 레벨. 카메라의 줌 레벨이 최소 줌 레벨보다 낮다면 두 데이터가 화면상 기준 거리보다 가깝더라도 더 이상 클러스터링되지 않습니다. 예를 들어, 클러스터링할 최소 줌 레벨이 4라면, 카메라의 줌 레벨을 3레벨 이하로 축소하더라도 4레벨의 클러스터가 더 이상 클러스터링되지 않고 그대로 유지됩니다.

    기본값은 NMF_MIN_ZOOM입니다.

    Declaration

    Objective-C

    @property (nonatomic) NSInteger minClusteringZoom;

    Swift

    var minClusteringZoom: Int { get set }

  • 클러스터링할 최대 줌 레벨. 카메라의 줌 레벨이 최대 줌 레벨보다 높다면 두 데이터가 화면상 기준 거리보다 가깝더라도 더 이상 클러스터링되지 않습니다. 예를 들어, 클러스터링할 최대 줌 레벨이 16이라면, 카메라의 줌 레벨을 17레벨 이상으로 확대하면 모든 데이터가 클러스터링되지 않고 낱개로 나타납니다. 따라서 클러스터링할 최대 줌 레벨이 지도의 최대 줌 레벨보다 크거나 같다면 카메라를 최대 줌 레벨로 확대하더라도 일부 데이터는 여전히 클러스터링된 채 더 이상 펼쳐지지 않을 수 있습니다.

    기본값은 NMF_MAX_ZOOM - 1입니다.

    Declaration

    Objective-C

    @property (nonatomic) NSInteger maxClusteringZoom;

    Swift

    var maxClusteringZoom: Int { get set }

  • 인덱싱할 최소 줌 레벨. 클러스터링할 최소 줌 레벨보다 작거나 같아야 합니다.

    NMCClusterer는 효율적인 클러스터링을 위해 공간 인덱스를 사용하는데 인덱스를 구축하는 데 자원이 소모됩니다. 따라서 인덱싱할 최소 줌 레벨을 적절하게 제한하면 성능이 향상될 수 있습니다. 반면 과도하게 제한하면 인덱싱할 줌 레벨 미만의 줌 레벨에서 렌더링 성능이 저하될 수 있습니다. 일반적으로 지도의 최소 줌 레벨과 동일하게 지정할 때 가장 좋은 효율을 낼 수 있습니다.

    기본값은 NMF_MIN_ZOOM입니다.

    Declaration

    Objective-C

    @property (nonatomic) NSInteger minIndexingZoom;

    Swift

    var minIndexingZoom: Int { get set }

  • 인덱싱할 최대 줌 레벨을 반환합니다. 클러스터링할 최대 줌 레벨보다 크거나 같아야 합니다.

    NMCClusterer는 효율적인 클러스터링을 위해 공간 인덱스를 사용하는데 인덱스를 구축하는 데 자원이 소모됩니다. 따라서 인덱싱할 최대 줌 레벨을 적절하게 제한하면 성능이 향상될 수 있습니다. 반면 과도하게 제한하면 인덱싱할 줌 레벨을 초과하는 줌 레벨에서 렌더링 성능이 저하될 수 있습니다. 일반적으로 지도의 최대 줌 레벨보다 1 작게 지정할 때 가장 좋은 효율을 낼 수 있습니다.

    기본값은 NMF_MAX_ZOOM - 1입니다.

    Declaration

    Objective-C

    @property (nonatomic) NSInteger maxIndexingZoom;

    Swift

    var maxIndexingZoom: Int { get set }

  • 클러스터링할 최대 화면 거리. 두 마커의 화면상 거리가 이 값보다 작을 경우에만 클러스터링 후보가 됩니다. 즉, 두 마커의 화면상 거리가 이 값보다 크다면, NMCDistanceStrategy.getDistance:Node1:Node2:가 반환한 둘 간의 거리가 NMCThresholdStrategy.getThreshold:보다 크더라도 클러스터링되지 않습니다. 한편 최대 화면 거리는 탐색 공간을 제한하는 역할을 하므로 값을 크게 지정할수록 성능이 저하됩니다.

    따라서 NMCDistanceStrategy와 NMCThresholdStrategy를 별도로 지정했다면 전략을 고려해 적절한 값을 지정해야 합니다. 예를 들어 NMCDefaultDistanceStrategy와 NMCDefaultThresholdStrategy를 사용한다면 NMCDefaultThresholdStrategy의 생성자 파라메터로 지정한 거리와 동일한 값을 지정했을 때 가장 좋은 효율을 낼 수 있습니다.

    기본값은 NMC_DEFAULT_SCREEN_DISTANCE입니다.

    Declaration

    Objective-C

    @property (nonatomic) double maxScreenDistance;

    Swift

    var maxScreenDistance: Double { get set }

  • 카메라 확대/축소시 클러스터가 펼쳐지는/합쳐지는 애니메이션의 지속 시간.0일 경우 애니메이션이 적용되지 않습니다.

    기본값은 NMC_DEFAULT_ANIMATION_DURATION입니다.

    Declaration

    Objective-C

    @property (nonatomic) double animationDuration;

    Swift

    var animationDuration: Double { get set }

  • 화면상 마커를 갱신할 때 NMFMapViewCameraDelegate.mapViewCameraIdle:대신 NMFMapViewCameraDelegate.mapView:cameraIsChangingByReason:를 사용할지 여부. NMFMapViewCameraDelegate.mapView:cameraIsChangingByReason:를 사용하면 더 빠르게 갱신되지만 성능이 하락합니다.

    기본값은 NO입니다.

    Declaration

    Objective-C

    @property (nonatomic) BOOL updateOnChange;

    Swift

    var updateOnChange: Bool { get set }

  • NMCClusterer 객체를 생성합니다.

    Declaration

    Objective-C

    - (NMCClusterer<KeyType> *_Nonnull)build;

    Swift

    func build() -> NMCClusterer

    Return Value

    NMCClusterer 객체.