supercluster

A very fast JavaScript library for clustering geospatial points in browsers and Node. It groups nearby markers so maps with many points stay readable.

Share on XLicense: ISC

Overview

supercluster is a JavaScript library for clustering geospatial points in browsers and Node. It was built to power clustering in Mapbox GL JS and groups nearby markers so a map with many points stays readable. You create an index with a radius and maximum zoom, load an array of GeoJSON Point features, then ask for the clusters inside a bounding box at a given zoom. It installs from npm or Yarn, or loads from a CDN or script tag.

Key features

  • load() indexes an array of GeoJSON Point features
  • getClusters() returns clusters for a bounding box and zoom
  • Configurable radius and maximum zoom
  • Works as an ES module, from a CDN or via script tag

Best for

Developers showing many map markers who want them grouped by zoom level, in Mapbox GL JS, Leaflet or their own code.

Upstream
mapbox/supercluster
Fork on GitHub
Guo-astro/supercluster
Upstream stars
2.4k
Category
Maps and geospatial
Language
JavaScript
License
ISC
Forked
2020-11-01
Sync status
In syncLast synced 2026-09-29