MMKClusterizedPlacemarkCollection

class MMKClusterizedPlacemarkCollection : MMKBaseMapObjectCollection

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.

Summary

Instance methods

func addPlacemark() -> MMKPlacemarkMapObject
Creates a new empty placemark and adds it to the current collection

func addPlacemark(placemarkCreatedCallback: @escaping MMKPlacemarkCreatedCallback) -> MMKPlacemarkMapObject
Creates a new empty placemark and adds it to the current collection

func addEmptyPlacemark(with point: MMKPoint) -> MMKPlacemarkMapObject
Creates a new empty placemark and adds it to the current collection

func addEmptyPlacemarks(with points: [MMKPoint]) -> [MMKPlacemarkMapObject]
Creates new empty placemarks and adds them to the current collection

func addPlacemark(with point: MMKPoint) -> MMKPlacemarkMapObject
Creates a new placemark with the default icon and style, and adds it to the current collection

func addPlacemark(with point: MMKPoint, image: UIImage) -> MMKPlacemarkMapObject
Creates a new placemark with the default style and adds it to the current collection

func addPlacemark(with point: MMKPoint,
                       image: UIImage,
                       style: MMKIconStyle) -> MMKPlacemarkMapObject
Creates a new placemark and adds it to the current collection

func addPlacemark(with point: MMKPoint,
                        view: MRTViewProvider) -> MMKPlacemarkMapObject
Creates a new view placemark with default style and adds it to the current collection

func addPlacemark(with point: MMKPoint,
                        view: MRTViewProvider,
                       style: MMKIconStyle) -> MMKPlacemarkMapObject
Creates a new view placemark and adds it to the current collection

func addPlacemark(with point: MMKPoint,
               animatedImage: MRTAnimatedImageProvider,
                       style: MMKIconStyle) -> MMKPlacemarkMapObject
Creates a new placemark with animated icon and adds it to the current collection

func addPlacemarks(with points: [MMKPoint],
                         image: UIImage,
                         style: MMKIconStyle) -> [MMKPlacemarkMapObject]
Creates new placemarks and adds them to the current collection

func clusterPlacemarks(withClusterRadius clusterRadius: Double, minZoom: UInt)
Updates clustered representations of placemark groups

Instance methods

addPlacemark()

func addPlacemark() -> MMKPlacemarkMapObject

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


addPlacemark(placemarkCreatedCallback:)

func addPlacemark(placemarkCreatedCallback: @escaping MMKPlacemarkCreatedCallback) -> MMKPlacemarkMapObject

Creates a new empty placemark and adds it to the current collection. Callback can be used to setup placemark style and position Callback will be called before MapObjectCollectionListener#onMapObjectAdded


addEmptyPlacemark(with:)

func addEmptyPlacemark(with point: MMKPoint) -> MMKPlacemarkMapObject

Creates a new empty placemark and adds it to the current collection. Hint: to add a large amount of empty placemarks use addEmptyPlacemarks method.

Alert

Use addPlacemark() + setGeometry(point)


addEmptyPlacemarks(with:)

func addEmptyPlacemarks(with points: [MMKPoint]) -> [MMKPlacemarkMapObject]

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.


addPlacemark(with:)

func addPlacemark(with point: MMKPoint) -> MMKPlacemarkMapObject

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

Alert

Use addPlacemark() + setGeometry(point) + setIcon(your_own_blue_dot_icon). Default icon (also known as blue dot) is no longer provided.


addPlacemark(with:image:)

func addPlacemark(with point: MMKPoint, image: UIImage) -> MMKPlacemarkMapObject

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

Alert

Use addPlacemark() + setGeometry(point) + setIcon(image)


addPlacemark(with:image:style:)

func addPlacemark(with point: MMKPoint,
                       image: UIImage,
                       style: MMKIconStyle) -> MMKPlacemarkMapObject

Creates a new placemark and adds it to the current collection. Hint: to add a large amount of placemarks use addPlacemarks method.

Alert

Use addPlacemark() + setGeometry(point) + setIcon(image, style)


addPlacemark(with:view:)

func addPlacemark(with point: MMKPoint,
                        view: MRTViewProvider) -> MMKPlacemarkMapObject

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

Alert

Use addPlacemark() + setGeometry(point) + setView(view)


addPlacemark(with:view:style:)

func addPlacemark(with point: MMKPoint,
                        view: MRTViewProvider,
                       style: MMKIconStyle) -> MMKPlacemarkMapObject

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

Alert

Use addPlacemark() + setGeometry(point) + setView(view, style)


addPlacemark(with:animatedImage:style:)

func addPlacemark(with point: MMKPoint,
               animatedImage: MRTAnimatedImageProvider,
                       style: MMKIconStyle) -> MMKPlacemarkMapObject

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

Alert

Use addPlacemark() + setGeometry(point) + useAnimation() + setIcon(animatedImage, style)


addPlacemarks(with:image:style:)

func addPlacemarks(with points: [MMKPoint],
                         image: UIImage,
                         style: MMKIconStyle) -> [MMKPlacemarkMapObject]

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.


clusterPlacemarks(withClusterRadius:minZoom:)

func clusterPlacemarks(withClusterRadius clusterRadius: Double, minZoom: UInt)

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).