# carrilbici.opendata.cat

> Dades obertes de la xarxa de carrils bici de Catalunya

## Descripció
Portal de dades obertes sobre la infraestructura ciclista de Catalunya. Inclou quilòmetres de carril bici per municipi, mapa interactiu amb OpenStreetMap, comparatives per habitant i rànkings.

## Contingut
- Quilòmetres de carril bici per municipi
- Classificació per tipus: via segregada, carril pintat, carril compartit, pista ciclable
- Estat: existents, projectats, en construcció
- Mètriques comparatives: km/1.000 habitants, km/km², percentatge segregat
- Mapa interactiu amb dades locals d'OpenStreetMap, Open Data BCN i AMB
- Rànking de municipis per infraestructura ciclista
- Formulari de contacte per suggeriments i fonts de dades

## API pública
API REST de només lectura, sense clau ni registre. Respostes JSON amb CORS obert.
Documentació interactiva: https://carrilbici.opendata.cat/api/docs
Especificació OpenAPI 3.1: https://carrilbici.opendata.cat/api/openapi.json

- `GET /api` — índex: versió, endpoints, fonts i data de la darrera actualització
- `GET /api/stats` — xifres agregades de Catalunya: km per estat i per tipus, cobertura municipal, desglossament per província
- `GET /api/municipis` — llista de municipis amb estadístiques. Filtres: `q`, `comarca`, `provincia`, `min_km`, `max_km`, `min_poblacio`, `amb_carril`. Ordre: `sort` + `order`. Paginació: `limit` (màx. 500) + `offset`
- `GET /api/municipis/{slug}` — fitxa d'un municipi: estadístiques, desglossament per tipus i estat, i posició al rànquing
- `GET /api/comarques` i `GET /api/comarques/{slug}` — comarques amb estadístiques i els seus municipis
- `GET /api/ranking` — rànquing de municipis per `metrica` (`km_total`, `km_existent`, `km_per_1000hab`, `km_per_km2`, `pct_segregat`, `pct_il_luminat`, `num_trams`), amb `min_poblacio`, `provincia` i `comarca`
- `GET /api/trams` — trams individuals d'OpenStreetMap amb els seus atributs. Filtres: `municipi`, `comarca`, `tipus`, `estat`, `segregat`, `bbox`, `min_longitud_m`
- `GET /api/geojson` i `GET /api/geojson/{capa}` — catàleg i descàrrega de les 7 capes GeoJSON amb la geometria de la xarxa
- `GET /api/search` — cerca ràpida de municipis i comarques per a autocompletat

Convencions: distàncies de municipi i comarca en quilòmetres, les dels trams en metres; `km_total` = existent + projectat, i els carrils compartits (`shared_lane`) es compten a part; coordenades EPSG:4326; slugs en minúscules i sense accents.

Límits actuals de les dades: la dimensió comarcal encara no està poblada (les consultes de comarques retornen buit), `superficie_km2` és 0 a la majoria de municipis (i per tant `km_per_km2` no és fiable), i els trams porten només el centroide — la geometria real és a les capes GeoJSON.

## Llicència de les dades
Dades derivades d'OpenStreetMap (ODbL 1.0), de l'Ajuntament de Barcelona i de l'AMB (CC BY 4.0). Cal citar la font.

## Fonts de dades
- OpenStreetMap (Overpass API)
- Open Data BCN (Ajuntament de Barcelona)
- Àrea Metropolitana de Barcelona (AMB)
- Wikidata (superfícies i poblacions municipals)

## Organització
Un projecte d'Opendata.cat — Associació pel Foment de les Dades Obertes
https://opendata.cat

## Desenvolupament
Desenvolupat per Xavier Vinaixa
https://xaviviro.com

## Contacte
carrilbici@opendata.cat
https://carrilbici.opendata.cat/contacte