Struct GeohashIndex 

pub struct GeohashIndex {
    pub collection: String,
    pub field: String,
    pub precision: u8,
    /* private fields */
}

Per-collection geohash index.

Maintains a mapping of document ID → geohash string for all Point geometries in a collection. Non-Point geometries are silently skipped (geohash only works for points in v1).

Fields

collection: String

Collection name.

field: String

Geometry field name.

precision: u8

Geohash precision (1-12).

Implementations

impl GeohashIndex

pub fn new(collection: &str, field: &str, precision: u8) -> Self

pub fn index_document( &mut self, doc_id: &str, geometry: &Geometry, ) -> Option<String>

Index a geometry. Only Point geometries are indexed; others are skipped. Returns the geohash string if indexed, None if skipped.

pub fn remove_document(&mut self, doc_id: &str)

Remove a document from the geohash index.

pub fn prefix_search(&self, prefix: &str) -> Vec<&str>

Find all document IDs whose geohash matches the given prefix.

This is the core operation: a geohash prefix of length N matches all points within a cell of size determined by N. Shorter prefix = larger area.

pub fn nearby_search( &self, lng: f64, lat: f64, search_precision: Option<u8>, ) -> Vec<&str>

Find all document IDs near a point, using geohash prefix matching.

Computes the geohash of the query point and its 8 neighbors, then collects all documents in those cells. This gives approximate results — the caller should apply exact distance filtering afterward.

search_precision controls the cell size: lower = larger area, more results but less precise. Default: same as index precision.

pub fn get_geohash(&self, doc_id: &str) -> Option<&str>

Get the geohash for a specific document.

pub fn len(&self) -> usize

Number of indexed documents.

pub fn is_empty(&self) -> bool

Whether the index is empty.

pub fn checkpoint_to_bytes(&self) -> Result<Vec<u8>, RTreeCheckpointError>

Checkpoint: serialize all entries for persistence.

pub fn from_checkpoint(bytes: &[u8]) -> Result<Self, RTreeCheckpointError>

Restore from checkpoint.