Class YMKClusterizedPlacemarkCollection

A collection that displays large groups of placemarks efficiently.

Placemarks that are too close to each other with current zoom are rendered as a single cluster. Placemarks and clusters are not shown until clusterPlacemarks method is called explicitly.

Instance Methods

- addEmptyPlacemarksWithPoints:

Creates new empty placemarks and adds them to the current collection.

- addEmptyPlacemarkWithPoint:

Creates a new empty placemark and adds it to the current collection.

- addPlacemarksWithPoints:image:style:

Creates new placemarks and adds them to the current collection.

- addPlacemarkWithPoint:

Creates a new placemark with the default icon and style, and adds it to the current collection.

- addPlacemarkWithPoint:animatedImage:style:

Creates a new placemark with animated icon and adds it to the current collection.

- addPlacemarkWithPoint:animatedModel:style:

Creates a new placemark with animated model and adds it to the current collection.

- addPlacemarkWithPoint:image:

Creates a new placemark with the default style and adds it to the current collection.

- addPlacemarkWithPoint:image:style:

Creates a new placemark and adds it to the current collection.

- addPlacemarkWithPoint:view:

Creates a new view placemark with default style and adds it to the current collection.

- addPlacemarkWithPoint:view:style:

Creates a new view placemark and adds it to the current collection.

- clear

Remove both clusters and placemarks from collection.

- clusterPlacemarksWithClusterRadius:minZoom:

Updates clustered representations of placemark groups.

Method Detail

-addEmptyPlacemarkWithPoint:

- (nonnull YMKPlacemarkMapObject *)addEmptyPlacemarkWithPoint:(nonnull YMKPoint *)point 

Creates a new empty placemark and adds it to the current collection.

Hint: to add a large amount of empty placemarks use addEmptyPlacemarks method.

-addEmptyPlacemarksWithPoints:

- (nonnull NSArray< YMKPlacemarkMapObject * > *)addEmptyPlacemarksWithPoints:(nonnull NSArray< YMKPoint * > *)points 

Creates new empty placemarks and adds them to the current collection.

Relevant for Android: this method provides better performance for adding a large number of empty placemarks than multiple calls of addEmptyPlacemark.

-addPlacemarkWithPoint:

- (nonnull YMKPlacemarkMapObject *)addPlacemarkWithPoint:(nonnull YMKPoint *)point 

Creates a new placemark with the default icon and style, and adds it to the current collection.

-addPlacemarkWithPoint:animatedImage:style:

- (nonnull YMKPlacemarkMapObject *)addPlacemarkWithPoint:(nonnull YMKPoint *)point
                                           animatedImage:(nonnull id< YRTAnimatedImageProvider >)animatedImage
                                                   style:(nonnull YMKIconStyle *)style 

Creates a new placemark with animated icon and adds it to the current collection.

-addPlacemarkWithPoint:animatedModel:style:

- (nonnull YMKPlacemarkMapObject *)addPlacemarkWithPoint:(nonnull YMKPoint *)point
                                           animatedModel:(nonnull id< YRTAnimatedModelProvider >)animatedModel
                                                   style:(nonnull YMKModelStyle *)style 

Creates a new placemark with animated model and adds it to the current collection.

-addPlacemarkWithPoint:image:

- (nonnull YMKPlacemarkMapObject *)addPlacemarkWithPoint:(nonnull YMKPoint *)point
                                                   image:(nonnull UIImage *)image 

Creates a new placemark with the default style and adds it to the current collection.

-addPlacemarkWithPoint:image:style:

- (nonnull YMKPlacemarkMapObject *)addPlacemarkWithPoint:(nonnull YMKPoint *)point
                                                   image:(nonnull UIImage *)image
                                                   style:(nonnull YMKIconStyle *)style 

Creates a new placemark and adds it to the current collection.

Hint: to add a large amount of placemarks use addPlacemarks method.

-addPlacemarkWithPoint:view:

- (nonnull YMKPlacemarkMapObject *)addPlacemarkWithPoint:(nonnull YMKPoint *)point
                                                    view:(nonnull YRTViewProvider *)view 

Creates a new view placemark with default style and adds it to the current collection.

-addPlacemarkWithPoint:view:style:

- (nonnull YMKPlacemarkMapObject *)addPlacemarkWithPoint:(nonnull YMKPoint *)point
                                                    view:(nonnull YRTViewProvider *)view
                                                   style:(nonnull YMKIconStyle *)style 

Creates a new view placemark and adds it to the current collection.

-addPlacemarksWithPoints:image:style:

- (nonnull NSArray< YMKPlacemarkMapObject * > *)addPlacemarksWithPoints:(nonnull NSArray< YMKPoint * > *)points
                                                                  image:(nonnull UIImage *)image
                                                                  style:(nonnull YMKIconStyle *)style 

Creates new placemarks and adds them to the current collection.

Relevant for Android: this method provides better performance for adding a large number of placemarks than multiple calls of addPlacemark.

-clear

- (void)clear

Remove both clusters and placemarks from collection.

-clusterPlacemarksWithClusterRadius:minZoom:

- (void)clusterPlacemarksWithClusterRadius:(double)clusterRadius
                                   minZoom:(NSUInteger)minZoom 

Updates clustered representations of placemark groups.

This method must be called explicitly to render placemarks and clusters when collection is created and update them after collection change.
Parameters:
clusterRadius

Minimal distance in units between objects that remain separate. The size of the unit is equal to the size of a pixel when the camera position's tilt is equal to 0 and the scale factor is equal to 1.

minZoom

Minimal zoom level that displays clusters. All placemarks will be rendered separately at more detailed zoom levels. The value will be clipped between 0 and 19 (most detailed zoom).