# Imagini radar România – Arhivă publică

Acest server oferă acces public la imagini radar meteorologice salvate periodic de pe site-ul oficial [meteoromania.ro](https://www.meteoromania.ro/), în format `.png`. Fișierele sunt organizate în directoare pe ani/luni/zile, cu nume de fișiere în format `HHMM.png` (ora UTC).

Exemplu:
```
/2025/05/29/0710.png
```

## Coordonate geospațiale

Fiecare imagine este suprapusă pe hartă folosind proiecția Web Mercator (`EPSG:3857`) și următorul bounding box:

```js
const radarBounds = [
  [42.010, 17.975],  // Sud-Vest
  [49.160, 31.475]   // Nord-Est
];
```

## Utilizări recomandate

Aceste imagini pot fi folosite în diverse aplicații:

- Suprapunerea peste trasee GPX (de ex. activități sportive, drumeții, ciclism);
- Integrarea în sisteme GIS sau vizualizatoare Leaflet/MapLibre;
- Sincronizarea cu senzori locali (ex. detecție fulgere, presiune atmosferică);
- Analiza retrospectivă a condițiilor meteo pe baza orei și locației;
- Generarea de animații radar folosind imagini succesive la interval de 10 minute.

## Specificații tehnice

- **Format**: PNG
- **Frecvență**: la fiecare 10 minute
- **Timp**: UTC (`HHMM`)
- **Rezoluție**: nativă ANM (fără post-procesare)
- **Structură directoare**: `/YYYY/MM/DD/HHMM.png`

## Acces rapid la ultima imagine

Pentru aplicații care necesită întotdeauna cea mai recentă imagine radar, sunt disponibile:

### `/latest.png`
Copia celei mai recente imagini radar descărcate. Acest fișier se actualizează automat de fiecare dată când o nouă imagine este procesată cu succes.

### `/latest.json`
Fișier JSON cu metadate despre ultima imagine disponibilă:

```json
{
  "filename": "1041.png",
  "original_path": "2025/05/29/1041.png",
  "radar_timestamp_utc": "2025-05-29T10:41:00.000Z",
  "downloaded_at_utc": "2025-05-29T10:43:15.234Z"
}
```

**Câmpurile JSON:**
- `filename` - numele original al fișierului (format `HHMM.png`)
- `original_path` - calea relativă în arhiva structurată pe date
- `radar_timestamp_utc` - timestamp-ul UTC al momentului când imaginea radar a fost generată
- `downloaded_at_utc` - timestamp-ul UTC al momentului când imaginea a fost descărcată/procesată

## Vizualizare live

Poți testa suprapunerea imaginilor radar pe hartă accesând:

👉 [`test-overlay.html`](https://meteoromania.vad.is.xdev.ro/test-overlay.html)

## Contact

Acest serviciu este oferit în scop educativ, demonstrativ și de cercetare. Nu are legătură oficială cu ANM. Pentru detalii tehnice: **bogdan@xdev.ro**