# Landvex QGIS Plugin

> QGIS plugin for integrating Landvex urban intelligence data.

## Features

- 📍 **Load Observations** — Display observations as point layer
- 🌡️ **RGI Heatmap** — Reality Gap Index grid visualization
- 🏙️ **UMI Layer** — Urban Morphology Index
- 🎨 **Smart Styling** — Color-coded by condition (1-5)
- 🔍 **Attribute Table** — Full observation data
- 🔄 **Real-time Sync** — Auto-refresh from API

## Installation

### From ZIP

1. Download `landvex-qgis.zip`
2. QGIS → Plugins → Manage and Install Plugins → Install from ZIP
3. Select downloaded ZIP file
4. Restart QGIS

### From Source

```bash
# Clone repository
git clone https://github.com/landvex/qgis-plugin.git

# Copy to QGIS plugins directory
cp -r qgis-plugin ~/.local/share/QGIS/QGIS3/profiles/default/python/plugins/landvex

# Restart QGIS
```

## Configuration

1. Plugins → Landvex → Settings
2. Enter API URL: `https://api.landvex.com/v1`
3. Enter API Key (from Landvex dashboard)
4. Click "Test Connection"

## Usage

### Load Observations

1. Click "Load Observations" button in toolbar
2. Observations appear as point layer
3. Colors indicate condition:
   - 🟢 Green = Excellent (1)
   - 🟡 Yellow = Fair (3)
   - 🔴 Red = Critical (5)

### RGI Heatmap

1. Click "Load RGI Layer"
2. Grid cells show Reality Gap Index
3. Darker = higher gap (worse condition)

### Attribute Table

1. Right-click layer → Open Attribute Table
2. View all observation data
3. Filter by condition, type, status

## Data Structure

### Observation Fields

| Field | Type | Description |
|-------|------|-------------|
| id | String | Observation ID |
| type | String | Infrastructure type |
| condition | Integer | 1-5 (1=best, 5=worst) |
| zoomer | String | Observer name |
| status | String | pending/approved/rejected |
| date | String | Observation date |
| rgi | Float | Reality Gap Index |

## Requirements

- QGIS 3.16+
- Python 3.7+
- Internet connection (for API)

## License

MIT