Skip to main content

Documentation Index

Fetch the complete documentation index at: https://algolia.com/llms.txt

Use this file to discover all available pages before exploring further.

The aroundPrecision parameter controls how finely Algolia groups results by their distance from the search center. This affects how the Geo ranking criterion treats nearby records.

​
Usage

  • The geo criterion must be in your ranking formula (default behavior).
  • If you set a value below 10, Algolia uses 10 as the minimum.
  • Use an integer for a fixed grouping size in meters.
  • Use a list of range objects to define custom precision ranges based on distance bands.

​
Options

​
integer
Groups results by distance in fixed increments. For example, aroundPrecision: 100 means records from 0 to 99 m are ranked equally, as are 100 to 199 m, and so on.
​
list<object>
Provides variable precision at different distance ranges. Each object must include a from and a value. For example: [{ "from": 0, "value": 25 }, { "from": 1000, "value": 2000 }] means records between 0 and 999 m have a precision of 25 m, and records above 1,000 m have a precision of 2,000 m.

​
Examples

​
Specify a number

Current API clients

var response = await client.SearchSingleIndexAsync<Hit>(
  "INDEX_NAME",
  new SearchParams(
    new SearchParamsObject { Query = "query", AroundPrecision = new AroundPrecision(100) }
  )
);

index.Search(new Query("query")
{
    AroundPrecision = 100 // 100 meters precision
});

​
Specify range objects

Current API clients

var response = await client.SearchSingleIndexAsync<Hit>(
  "INDEX_NAME",
  new SearchParams(
    new SearchParamsObject
    {
      Query = "query",
      AroundPrecision = new AroundPrecision(
        new List<Range>
        {
          new Range { From = 0, Value = 25 },
          new Range { From = 2000, Value = 1000 },
        }
      ),
    }
  )
);

$results = $index->search('query', [
    'aroundPrecision' => [
        ['from' => 0, 'value' => 25], // 25 meters precision by default
        ['from' => 2000, 'value' => 1000] // 1,000 meters precision after 2 km
    ],
]);
Last modified on March 16, 2026