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 y variables socioeconómicas.

curl https://madridapie.ciberimaginario.cloud/api/barrios
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 a pie: desigualdad en la siniestralidad peatonal. Grupo Ciberimaginario (URJC) y Dataevidence.tech. Sobre datos del Ayuntamiento de Madrid (CC BY 4.0). madridapie.ciberimaginario.cloud