From 7013fc45f4ee892e2857d3ce7473d995c99cb1ef Mon Sep 17 00:00:00 2001
From: Dominik Schmidt <dev@dominik-schmidt.de>
Date: Thu, 13 Aug 2026 00:41:39 +0200
Subject: [PATCH] feat(search): geohash grid aggregation option

Adds `geohashPrecision` to aggregationOption: when greater than 0 the
aggregation becomes a geohash-grid aggregation over `field` (which
must resolve to a geo-point field such as `location`). Each returned
searchBucket carries a geohash cell as key plus its count, suitable
for density/heatmap rendering. Libregraph extension not present in
MS Graph.
---
 api/openapi-spec/v1.0.yaml | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/api/openapi-spec/v1.0.yaml b/api/openapi-spec/v1.0.yaml
index 5c22847..276df1f 100644
--- a/api/openapi-spec/v1.0.yaml
+++ b/api/openapi-spec/v1.0.yaml
@@ -6641,6 +6641,18 @@ components:
             $ref: '#/components/schemas/aggregationOption'
         '@libre.graph.metricDefinition':
           $ref: '#/components/schemas/metricDefinition'
+        '@libre.graph.geohashPrecision':
+          type: integer
+          format: int32
+          description: |
+            When greater than 0, this is a geohash-grid aggregation over `field`,
+            which must resolve to a geo-point field (e.g. `location`). Each
+            returned `searchBucket` carries a geohash cell as `key` and its
+            count, suitable for density/heatmap rendering. The value is the
+            geohash length (1-12); higher means finer cells. Libregraph
+            extension not present in MS Graph.
+          minimum: 1
+          maximum: 12
     metricDefinition:
       type: object
       description: |