Reutilización de datos

API REST documentada

Todos los datos procesados están disponibles vía API JSON con CORS habilitado. Licencia CC BY 4.0.

Formato y convenciones

La API devuelve siempre JSON UTF-8 con CORS abierto. Las respuestas se devuelven envueltas en un objeto con los datos y, cuando aplica, el conteo n y parámetros como limit. Los errores se devuelven como HTTP 404 con un pequeño cuerpo HTML.

Endpoints

GET /api/summary

Hallazgos globales del estudio: metadatos, correlaciones principales, rankings, Gini, resultados de OLS y Random Forest.

curl https://madridapie.ciberimaginario.cloud/api/summary
GET /api/barrios

Los 131 barrios con todas sus métricas de siniestralidad, variables socioeconómicas y variables de tráfico/diseño viario.

curl https://madridapie.ciberimaginario.cloud/api/barrios

Campos disponibles por barrio:

  • Identificación: cod_barrio, nom_barrio, cod_distrito, nom_distrito
  • Demografía: poblacion, superficie_ha, densidad_hab_ha, edad_media, pct_mayores_65, tam_hogar, pct_migrantes
  • Socioeconómicas: renta_persona, renta_hogares, tasa_paro, indice_vuln
  • Siniestralidad: n_total, n_peatones, n_fallecidos, n_graves, pct_peatones, severidad_por_mil, tasa_peaton_1000_ano
  • Tráfico y diseño viario: ancho_medio_pond, pct_calle_estrecha, pct_calle_amplia, n_carriles_pond, pct_calles_3plus_carriles, n_cruces_semaforizados, densidad_cruces_km2, intensidad_media, intensidad_hora_punta, carga_media, vmed_pond
  • Rankings: rank_pct_peatones, rank_severidad, rank_tasa_peaton
GET /api/barrio/<cod_barrio>

Detalle de un barrio concreto + su evolución anual de siniestralidad.

curl https://madridapie.ciberimaginario.cloud/api/barrio/115
GET /api/accidentes

Accidentes filtrables. Parámetros: cod_barrio, year, tipo_persona, gravedad, limit (máx 5.000).

curl "https://madridapie.ciberimaginario.cloud/api/accidentes?cod_barrio=115&tipo_persona=Peatón&year=2024"
GET /api/correlaciones

Matriz completa de correlaciones (Pearson) entre predictores y outcomes, con p-valores.

curl https://madridapie.ciberimaginario.cloud/api/correlaciones
GET /api/modelo

Resultados de la regresión múltiple OLS y del Random Forest (importancias por permutación).

curl https://madridapie.ciberimaginario.cloud/api/modelo
GET /api/serie_anual

Serie temporal 2019-2025 a nivel ciudad: total, peatones, fallecidos.

GET /api/serie_horaria

Distribución de accidentes por franja horaria (0-23).

GET /api/geojson

GeoJSON de los 131 barrios (EPSG:4326) con todas las métricas embebidas en properties. Preparado para cargarlo directamente en Leaflet, QGIS, Mapbox o ArcGIS.

GET /api/descarga/<formato>

Descarga el dataset procesado completo. Formatos: csv o json.

curl -O https://madridapie.ciberimaginario.cloud/api/descarga/csv

PDF de cada barrio

GET /barrio/<cod_barrio>/informe.pdf

Genera dinámicamente un informe PDF completo del barrio con sus indicadores, evolución y tipos de accidente.

Ejemplo de uso en Python

import requests

# Obtener los 131 barrios
r = requests.get("https://madridapie.ciberimaginario.cloud/api/barrios")
data = r.json()
print(f"Barrios: {data['n']}")

# Filtrar peatones atropellados en Puerta Bonita en 2024
r = requests.get("https://madridapie.ciberimaginario.cloud/api/accidentes",
    params={"cod_barrio": 115, "tipo_persona": "Peatón", "year": 2024})
for acc in r.json()["accidentes"][:5]:
    print(acc["fecha"], acc["tipo_accidente"], acc["gravedad_nivel"])

Licencia y atribución

Los datos originales son del Ayuntamiento de Madrid (datos.madrid.es), licencia CC BY 4.0. El procesamiento y análisis son del Grupo Ciberimaginario (URJC), licencia CC BY 4.0. Al reutilizar los datos, por favor cita:

Gertrudix, M. & [Apellido], M. (2026). Madrid Vertical: desigualdad en la siniestralidad peatonal. Grupo Ciberimaginario, Universidad Rey Juan Carlos. Sobre datos del Ayuntamiento de Madrid (CC BY 4.0). madridapie.ciberimaginario.cloud