Collections search bbox queries

[jonhealy1]

Related Issue(s):

• GET /collections search bbox #463

Description:

This PR introduces spatial search capabilities for collections and a new CLI tool package for managing SFEOS deployments.

Key Features:

1. Collection Spatial Search

   • Added bbox parameter support to /collections endpoint for filtering collections by geographic extent
   • Collections are automatically indexed with a bbox_shape field (GeoJSON polygon) derived from their spatial extent
   • Supports both 2D and 3D bounding boxes (altitude values are ignored for spatial queries)
   • Efficient geospatial queries using Elasticsearch/OpenSearch geo_shape type

2. SFEOS Tools CLI Package

   • New installable Python package (sfeos_tools/) for managing SFEOS deployments
   • Initial command: add-bbox-shape - migrates legacy collections to support spatial search
   • Flexible connection options via CLI flags or environment variables
   • Supports both Elasticsearch and OpenSearch backends
   • Install with: pip install sfeos-tools[elasticsearch] or pip install sfeos-tools[opensearch]

3. Migration Support

   • Legacy collections (created before this feature) can be migrated using the CLI tool or by updating the collection via the API and the Transactions Extension
   • Automatic bbox_shape generation for new/updated collections
   • Backward compatible - existing collections remain searchable via other parameters

Usage Examples:

# Search collections by bounding box
GET /collections?bbox=-10,35,40,70

# Migrate legacy collections
sfeos-tools add-bbox-shape --backend elasticsearch --no-ssl

PR Checklist:

• Code is formatted and linted (run pre-commit run --all-files)
• Tests pass (run make test)
• Documentation has been updated to reflect changes, if applicable
• Changes are added to the changelog