MarkerClusterer

The MarkerClusterer component clusters child markers. It uses the modern @googlemaps/markerclusterer implementation while keeping an onClick(cluster) convenience prop.

Storybook

Open the MarkerClusterer story

Props

PropTypeDescription
optionsOmit<MarkerClustererOptions, 'map' | 'markers'>Marker clusterer options.
markersMarker[]Optional marker instances to cluster. Child markers register automatically.
onClick(cluster) => voidConvenience cluster click handler.
onClusterClickMarkerClustererOptions['onClusterClick']Native cluster click handler.
onLoad(clusterer) => voidCalled after clusterer creation.
onUnmount(clusterer) => voidCalled before clusterer removal.

Usage

<MarkerClusterer onClick={(cluster) => console.log(cluster.count)}>
	{#each locations as position}
		<Marker {position} />
	{/each}
</MarkerClusterer>
svelte