A Distance-based Solr spatial clustering plugin
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.


Indoqa Solr Spatial Clustering

This project offers a Distance-based spatial clustering search component for Apache Solr. It addresses the problem of reducing the amount of displayed markers on a map, described as Spatial Clustering, using a Distance-based clustering algorithm based on GVM.

The search component aggregates all possible search results to a maximum amount of pins and adds this information to the standard search result representation. Like faceting, it can be used to query for a paged result slice (eg. for a result list) and a geographic overview of ALL search result items (spatial clusters) at once.

Spatial Clustering



  • Apache Solr 5.2.1+
  • Java 7+


  • Download the latest release
  • run "maven clean install"


  • Copy the plugin jar from 'target/solr-spatialclustering-{version}-jar-with-dependencies.jar' into the /lib directory of your solr core.



To enable spatial clustering, store the geo information (longitude and latitude) in your solr document:

<fieldType name="double" class="solr.TrieDoubleField" precisionStep="0" positionIncrementGap="0" />

<field name="latitude" type="double" indexed="true" stored="true" />
<field name="longitude" type="double" indexed="true" stored="true" />

Note: For legacy support of old Solr 4 'SortableDoubleField', see branch 'legacy/solr-4.3'


Define the search component and map field names for id, longitude and latitude:

<searchComponent class="com.indoqa.solr.spatial.clustering.SpatialClusteringComponent" name="spatial-clustering">
  <str name="fieldId">id</str>
  <str name="fieldLon">longitude</str>
  <str name="fieldLat">latitude</str>

After that, add the spatial component to your query component chain:

<requestHandler name="/search" class="solr.SearchHandler" default="true">
  <arr name="last-components">


Query Parameters

  • spatial-clustering=true -> Enables spatial clustering
  • spatial-clustering.size=20 -> Optionally sets the maximum amount of clusters (=pins)


Similar to facets, the computed clusters are added to the search result after the requested documents. There are two types of result pins:

  • "single": Represents a single document, including the id of the referenced document.
  • "cluster": Represents an aggregated pin covering more than one document, including the cluster size.
<lst name="spatial-clustering">
  <lst name="pin">
    <str name="type">single</str>
    <int name="size">1</int>
    <double name="longitude">16.345518</double>
    <double name="latitude">48.285202</double>
    <string name="reference">document-2313</string>
  <lst name="pin">
    <str name="type">cluster</str>
    <int name="size">3</int>
    <double name="longitude">16.2461115932</double>
    <double name="latitude">48.20259082573333</double>