Skip to main content

anycluster provides Server-Side clustering of map markers for Geodjango

Project description

anycluster (POSTGIS version)

anycluster provides Server-Side clustering of map markers for Geodjango. It is suitable for large amounts of markers. Depending on your server and personal feeling, it works very well with 200.000 to 500.000 markers.

The postgis version is recommended. There is a mysql version with limited functionality:


  • [09.09.2019] support for Django 2.x and above (python 3), added leaflet support
  • [08.10.2015] major code improvements
  • you now need to add {% csrf_token % } somewhere in your template


This application offers 2 methods of clustering:

  • grid-based clustering
  • clustering based on geometric density of the points (needs PSQL extension)
  • cluster contents of any geographic area defined as Polygon/Multipolygon
  • get all elements contained in a cluster

... and has a builtin caching mechanism: if the user pans a map, only the new areas are processed.

And lots of optional customization possibilities:

  • works with google maps and Leaflet
  • define what happens if you click on a cluster
  • use your own cluster graphics
  • define gridsize and other cluster parameters
  • apply filters to your clusters
  • use specialized markers/pins if count is 1


Using the Demo

To use the demo, follow these steps:

  • install Django 2.x correctly
  • install psycopg2
  • copy the demo folder to your system and include the anycluster folder as a django app.
  • modify the database connection in according to your setup
  • if you want to use google maps: add your google api key to anymap/templates/base.html
  • remember to create the kmeans function as described in the documentation
  • from within the demo folder, run python migrate
  • from within the demo folder, run python filldemodb 50000 to fill the database with 50000 points
  • be patient, as this process is not very effective
  • from within the demo folder, run python runserver 8080
  • open your browser and enter localhost:8080

Performance Tips

  • index your GIS database columns correctly
  • usage of a SSD can be 10-20 times faster compared to HDD

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

anycluster-0.6.2.tar.gz (49.8 kB view hashes)

Uploaded source

Built Distribution

anycluster-0.6.2-py3-none-any.whl (53.4 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page