# Open Geodata Browser - QGIS Plugin

Browse and access satellite imagery from multiple STAC providers directly in QGIS.

## Features

- **Multi-Provider Support**: Access Microsoft Planetary Computer and AWS EarthSearch
- **Advanced Search**: Filter by spatial extent, date range, cloud cover, and more
- **Direct COG Loading**: Load Cloud-Optimized GeoTIFFs directly into QGIS
- **Batch Operations**: Download multiple assets at once
- **Provider Comparison**: Compare data availability across providers
- **Automatic URL Management**: Automatic signing for Planetary Computer

## Installation

### Prerequisites

Install Open-Geodata-API in your QGIS Python environment:
Using OSGeo4W Shell (Windows)

```
pip install open-geodata-api
```
**OR**<br>
From QGIS Python Console

```
from pip._internal.main import main as pip_main
result = pip_main(['install', '--user', '--upgrade', 'open-geodata-api'])
```

### Plugin Installation

1. Download the plugin zip file
2. In QGIS, go to `Plugins > Manage and Install Plugins`
3. Click "Install from ZIP"
4. Select the downloaded zip file
5. Enable the plugin

## Usage

1. Click the Open Geodata Browser icon in the toolbar
2. Select a data provider (Planetary Computer or EarthSearch)
3. Choose one or more collections
4. Set filters (date range, cloud cover, bounding box, *limit up to 10k*)
5. Click "Search"
6. **Interactive Results**:
    - **Sort**: Click column headers to sort.
    - **Multi-Select**: Use `Ctrl` or `Shift` to select multiple items.
    - **Map Preview**: Selected items show **Red** footprints. Unselected show **Blue**.
    - **Zoom**: Double-click any result to zoom to its extent.
    - **Visibility**: Right-click to **"Hide Footprint"** or **"Show Footprint"** (works for single or multiple items).
7. Select an item (or multiple) from results
8. Load assets directly to QGIS or download them

## Requirements

- QGIS >= 3.0
- Python packages:
  - open-geodata-api >= 1.0.0

## License

GPL v3

## Author

Mirjan Ali Sha (mastools.help@gmail.com) 