# Photos

Photo timeline and map view

## Endpoints

### GET /api/v1/photos/map

Get photos in a bounding box for map view

**Authentication:** Required (Bearer JWT)

#### Parameters

| Name   | In    | Required | Description              |
| ------ | ----- | -------- | ------------------------ |
| `lat1` | query | Yes      | Bounding box latitude 1  |
| `lon1` | query | Yes      | Bounding box longitude 1 |
| `lat2` | query | Yes      | Bounding box latitude 2  |
| `lon2` | query | Yes      | Bounding box longitude 2 |

#### Responses

| Status | Description           |
| ------ | --------------------- |
| 200    | Map markers           |
| 400    | Bad request           |
| 401    | Unauthorized          |
| 500    | Internal server error |

---

### GET /api/v1/photos/timeline

Get timeline of photos grouped by date

**Authentication:** Required (Bearer JWT)

#### Parameters

| Name       | In    | Required | Description                |
| ---------- | ----- | -------- | -------------------------- |
| `group_by` | query | No       | Grouping: day, month, year |
| `year`     | query | No       | Filter by year             |
| `month`    | query | No       | Filter by month            |
| `limit`    | query | No       | Max items (default 10000)  |

#### Responses

| Status | Description           |
| ------ | --------------------- |
| 200    | Photo timeline groups |
| 401    | Unauthorized          |
| 500    | Internal server error |

---