Creates and manages per-zoom-level clusters for large amounts of markers.

Usage no npm install needed!

<script type="module">
  import googlemapsMarkerclustererplus from 'https://cdn.skypack.dev/@googlemaps/markerclustererplus';


Google Maps JavaScript MarkerClustererPlus

npm Build Release codecov GitHub contributors semantic-release


The library creates and manages per-zoom-level clusters for large amounts of markers.

Note: This library has been refactored into @googlemaps/markerclusterer, check out the new and improved version!

Note: This library is the same as the existing library @google/markerclustererplus, but renamed and in its own repository.


Available via npm as the package @googlemaps/markerclustererplus.

npm i @googlemaps/markerclustererplus


yarn add @googlemaps/markerclustererplus

Alternativly you may add the umd package directly to the html document using the unpkg link.

<script src="https://unpkg.com/@googlemaps/markerclustererplus/dist/index.min.js"></script>

When adding via unpkg, the loader can be accessed at MarkerClusterer.

A version can be specified by using https://unpkg.com/@googlemaps/markerclustererplus@VERSION/dist/....


This library uses the official TypeScript typings for Google Maps Platform, @types/google.maps.

npm i -D @types/google.maps

It may also require the skipLibCheck TypeScript compiler option.


The reference documentation can be found at this link.


import MarkerClusterer from '@googlemaps/markerclustererplus';

const markerCluster = new MarkerClusterer(map, markers);

View the package in action: