INVClusterManager

Objective-C


@interface INVClusterManager : NSObject

Swift

class INVClusterManager : NSObject

클러스터링을 관리하는 클래스.
특정 데이터를 기반으로 단일 아이템 또는 아이템의 집합(클러스터)을 지도 위에 표출할 때 사용합니다.

Creating Instances

  • Unavailable

    initWithMapView: 생성자를 사용하세요.

    Declaration

    Objective-C

    - (nonnull instancetype)init;

  • 지도 객체를 이용하여 INVClusterManager 객체를 생성합니다.

    Declaration

    Objective-C

    - (nonnull instancetype)initWithMapView:(nonnull InaviMapView *)mapView;

    Swift

    init(mapView: InaviMapView)

    Parameters

    mapView

    지도 객체.

    Return Value

    INVClusterManager 객체.

Accessing the Delegate

Properties for Clustering

  • 클러스터링이 되기 위해 필요한 최소 아이템 개수.

    기본값은 2입니다.

    Declaration

    Objective-C

    @property (nonatomic) NSUInteger minClusteringCount;

    Swift

    var minClusteringCount: UInt { get set }

  • 클러스터링이 되기 위해 필요한 아이템 사이의 최대 간격. (pt 단위)
    값이 클수록 클러스터가 구성되는 범위가 넓어집니다.

    기본값은 200입니다.

    Declaration

    Objective-C

    @property (nonatomic) NSUInteger maxDistanceBetweenItems;

    Swift

    var maxDistanceBetweenItems: UInt { get set }

  • 클러스터가 지도 위에 표출될 때 아이콘 이미지를 만들어주는 생성기.
    해당 속성을 설정하지 않으면 기본 아이콘 이미지가 설정되어 지도에 표출됩니다.

    Declaration

    Objective-C

    @property (nonatomic) id<INVClusterIconGenerator> _Nonnull clusterIconGenerator;

    Swift

    var clusterIconGenerator: any INVClusterIconGenerator { get set }

Configuring Items for Clustering

  • 아이템을 추가합니다.

    Declaration

    Objective-C

    - (void)addItem:(nonnull id<INVClusterItem>)item;

    Swift

    func add(_ item: any INVClusterItem)

    Parameters

    item

    추가할 아이템.

  • 복수의 아이템을 추가합니다.

    Declaration

    Objective-C

    - (void)addItems:(nonnull NSArray<id<INVClusterItem>> *)items;

    Swift

    func add(_ items: [any INVClusterItem])

    Parameters

    items

    추가할 아이템 배열.

  • 아이템을 제거합니다.

    Declaration

    Objective-C

    - (void)removeItem:(nonnull id<INVClusterItem>)item;

    Swift

    func remove(_ item: any INVClusterItem)

    Parameters

    item

    제거할 아이템.

  • 복수의 아이템을 제거합니다.

    Declaration

    Objective-C

    - (void)removeItems:(nonnull NSArray<id<INVClusterItem>> *)items;

    Swift

    func remove(_ items: [any INVClusterItem])

    Parameters

    items

    제거할 아이템 배열.

  • 모든 아이템을 제거합니다.

    Declaration

    Objective-C

    - (void)clearItems;

    Swift

    func clearItems()

Redraw Clusters

  • 클러스터를 다시 그립니다.

    Declaration

    Objective-C

    - (void)invalidate;

    Swift

    func invalidate()