> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eyesotope.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Maps & Sites

> Interactive map with satellite overlays, sites, annotations, and field management

# Maps & Sites

The Map module is a full-featured interactive map that combines your field data, satellite imagery, sites, and annotations into a single view. It's powered by Leaflet with multiple base map styles and advanced overlay capabilities.

## The Sites Map

Navigate to **Sites** in the left sidebar to open the full-screen interactive map. The map shows all your fields, sites, and annotations together.

### Map Controls

* **Layers toggle** — Show/hide field names, sites, annotations, and satellite imagery
* **Season selector** — Switch between seasons to see different field sets
* **Map type** — Choose from multiple base map styles (auto-switches based on light/dark theme)
* **Stats badge** — Shows counts of fields, sites, and annotations at a glance

### Field Interactions

* **Click** any field polygon to open its detail panel
* **Right-click** for a context menu with quick actions
* **Deep linking** — Use `?field=&season=` URL parameters to zoom directly to a specific field

***

## Satellite Overlay Layer

The map includes a powerful satellite imagery overlay for viewing vegetation indices across **all your fields at once**:

1. Enable the **Satellite Imagery** layer from the layers control
2. A **Satellite Panel** slides in from the right with controls:
   * **Index type** — NDVI, EVI, EVI2, NRI, DSWI, NDWI, True Color, or False Color
   * **Cloud coverage slider** — Filter by maximum cloud percentage (0–100%)
   * **Date timeline** — Step through available imagery dates
   * **Overlay count** — Shows how many fields have data for the selected date
3. Satellite imagery is **clipped to field polygon shapes** for clean visualization
4. Minimize the panel to a floating chip to maximize map space

<Info>
  Index type and cloud threshold settings are saved to your browser and persist between sessions.
</Info>

***

## Sites

Sites are specific geographic points or areas of interest on your farm:

* Storage facilities
* Water sources
* Access roads
* Weather stations
* Other landmarks

### Adding a Site

1. Navigate to **Sites** in the left sidebar
2. Click **+ Add Site**
3. Place the marker on the map or enter coordinates
4. Fill in the site name, type, and description
5. Save

### Managing Sites

* **Drag to move** — Enter move mode to drag site markers to new positions
* **Unplaced sites** — Sites without coordinates appear in a separate list with "Place on map" buttons
* **Site panel** — Click a site to open its detail panel with full CRUD operations

***

## Map Annotations

Draw custom shapes and markers directly on the map:

* **Polygon tool** — Draw custom boundary shapes
* **Polyline tool** — Draw paths and routes
* **Marker tool** — Place individual point markers
* Annotations are saved and visible to your team

***

## Drag-and-Drop Operations

Apply inputs (fertilizers, chemicals, seeds) to fields directly from the map:

1. **Desktop** — Drag an input or seed from the inventory panel and drop it onto a field polygon
2. **Mobile** — Tap the input, then tap the target field to apply
3. A modal opens to confirm the application details

***

## Custom Maps

Organize your geographic data into collections:

1. Go to **Custom Maps** in the sidebar
2. Create a new collection
3. Add layers, markers, and annotations
4. Share with your team

### Collection Detail

Click on a map collection to view and edit its contents:

* Add or remove map features
* Adjust styles and colors
* Export map data

## Permissions

| Action            | Admin | Manager | Operator | Viewer |
| ----------------- | :---: | :-----: | :------: | :----: |
| View maps/sites   |   ✅   |    ✅    |     ✅    |    ✅   |
| Create maps/sites |   ✅   |    ✅    |     ✅    |    ❌   |
| Edit maps/sites   |   ✅   |    ✅    |     ✅    |    ❌   |
| Delete maps/sites |   ✅   |    ✅    |     ❌    |    ❌   |
