# CeCarburant

> Aggregator de prețuri la carburanți pentru România: benzină standard/premium, motorină standard/premium și GPL, la nivel de stație.

## Ce conține site-ul

- Hartă interactivă cu stațiile și prețurile consolidate.
- Prețuri reconciliate din Monitorul Prețurilor (ANPC), feed direct SOCAR, Rompetrol direct, OSCAR (doar amplasare) și scraper public de rezervă.
- Validare strictă: limite hard per carburant, eliminarea outlierilor față de mediana națională și deduplicare geografică Haversine în 3 pași.

## Pagini recomandate

- [Harta prețurilor](https://cecarburant.ro/): lista stațiilor, filtre pe carburant și hartă Leaflet/OpenStreetMap.
- [Preț benzină](https://cecarburant.ro/pret-benzina), [motorină](https://cecarburant.ro/pret-motorina), [GPL](https://cecarburant.ro/pret-gpl) și [EV](https://cecarburant.ro/pret-ev): medii, minime, top stații și clasamente.
- [Prețuri pe județe](https://cecarburant.ro/judete): agregate și istoric local per județ.
- [Prețuri pe localități](https://cecarburant.ro/localitati): agregate și istoric per oraș/UAT.
- [Prețuri minime](https://cecarburant.ro/preturi-minime): cele mai mici prețuri pe țară, județe și orașe.
- [Comparator rețele](https://cecarburant.ro/comparator-retele): Petrom, OMV, Rompetrol, MOL, Lukoil, SOCAR, OSCAR și Gazprom.
- [Statistici](https://cecarburant.ro/statistici): evoluție, extreme pe județe și clasamentul rețelelor.
- [Benzinării lângă mine](https://cecarburant.ro/langa-mine) și [calculator consum](https://cecarburant.ro/calculator).
- [Metodologie](https://cecarburant.ro/metodologie): surse, validare, potrivire geografică și limitări.
- [Dataset deschis](https://cecarburant.ro/dataset): CSV/JSON sub CC BY 4.0, cu schemă și citare.
- [Acoperire](https://cecarburant.ro/acoperire): stații, localități, comune active și prospețime.
- [Glosar](https://cecarburant.ro/glosar), [acciză și TVA](https://cecarburant.ro/transparenta-acciza), [despre](https://cecarburant.ro/despre), [contact](https://cecarburant.ro/contact).
- [API public](https://cecarburant.ro/api/v1/preturi): JSON cu stațiile și prețurile consolidate. Fără cheie de acces.
- [Hartă compactă](https://cecarburant.ro/api/v1/harta): payload redus pentru hărți și aplicații.
- [Istoric național](https://cecarburant.ro/api/v1/istoric-national): agregate zilnice min/avg/max pe carburant.
- [API județe](https://cecarburant.ro/api/v1/judete): agregate pe județe.
- [Index combustibil](https://cecarburant.ro/api/v1/index): serie națională, baseline și index 100.
- [Sitemap](https://cecarburant.ro/sitemap.xml)

## API

`GET /api/v1/preturi` acceptă opțional `?fuel=GASOLINE_STANDARD`, `?brand=PETROM`, `?q=Cluj` și `?limit=100`.

`GET /api/v1/harta` întoarce un payload compact pentru hartă: aceleași stații, dar prețurile sunt codificate ca `[preț, cod sursă, data sursă]`.

`GET /api/v1/istoric/{station_id}` returnează observațiile brute pentru o stație, iar `GET /api/v1/istoric-national` returnează istoricul național agregat.

`GET /api/v1/judete` returnează agregatele pe județe, iar `GET /api/v1/judete/{county}` detaliază stațiile și prețurile unui județ.

`GET /api/v1/health` întoarce starea datelor: ultima consolidare, acoperire, prospețime și surse.

Răspunsul conține `generated_at`, `count`, `returned`, `filters` și `data[]` cu stații, coordonate și prețuri per carburant.

## Surse

- Monitorul Prețurilor / ANPC: sursa principală pentru prețurile la nivel de stație.
- SOCAR România: feed direct, prioritate maximă pentru stațiile SOCAR.
- Rompetrol: localizatorul oficial de stații, pentru prețurile pe care Monitorul nu le trimite.
- OSCAR: amplasare și servicii, fără prețuri în feedul public.
- pretcarburant.ro: fallback public, folosit doar când celelalte surse nu acoperă stația.

## Date deschise terțe

Istoricul național agregat provine din PretCarburant.ro Open Data (https://github.com/An3treiu/pretcarburant-data), licență CC BY 4.0, DOI 10.5281/zenodo.19560194. Sunt agregate zilnice, nu observații per stație.

## Citare

Datele sunt agregate din surse publice. Pentru lucrări academice, citează sursele primare (ANPC Monitorul Prețurilor, SOCAR, Rompetrol, OSCAR) și data la care ai interogat API-ul.