Realizar evaluaciones en lote mediante la API de HEAT
Los usuarios avanzados pueden realizar evaluaciones de HEAT en lote mediante código, utilizando la API (interfaz de programación de aplicaciones).
La API conecta su código con el modelo de cálculo de HEAT. Permite repetir una evaluación para distintos lugares, años o escenarios y recopilar los resultados en un mismo flujo de trabajo.
Realice múltiples evaluaciones mediante código
- Configure una evaluación en la herramienta web HEAT. Elija los modos, las vías de impacto, los casos y las unidades que necesita; complete la evaluación y exporte el archivo RDS de entrada. Consulte Cómo funciona HEAT.
- Prepare las variantes. Utilice una tabla con una fila por ejecución y nombres de campos que coincidan con los del archivo exportado. El tutorial incluye un pequeño ejemplo.
- Realice una prueba pequeña. Compare los resultados devueltos con los de la herramienta web antes de ampliar el lote.
- Recopile e interprete los resultados. Conserve los datos de entrada, la versión del modelo y los supuestos junto con los resultados.
Acceso y preparación
Necesita experiencia con R o con un lenguaje de programación similar. Solicite una cookie de acceso a la API escribiendo a heatwalkingcycling@who.int. Proporcione su propia cookie de forma privada; no la comparta en scripts, repositorios ni resultados.
La plantilla exportada determina la estructura de la evaluación. Cambiar de lugar requiere datos de población, mortalidad, contaminación atmosférica, colisiones y valoración propios del país, además de los identificadores de ubicación. Los diccionarios de variables explican los campos; el tutorial no actualiza automáticamente todos los datos de fondo.
Ayuda, diccionarios de variables y descargas
- Referencia técnica (en inglés): solicitudes, objetos de entrada, resultados devueltos y un ejemplo mínimo en R.
- Diccionario de variables de entrada (en inglés): nombres de los campos y preguntas utilizados en la interfaz web.
- Diccionario de parámetros de fondo (en inglés): definiciones, unidades y referencias de los valores predeterminados.
- Descargar el script del tutorial en R y los archivos de ejemplo (ZIP, en inglés). El archivo contiene
HEAT_API_tutorial.R, una tabla de escenarios de ejemplo e instrucciones. No contiene ninguna cookie de acceso. Ver el script de R como texto (en inglés). - Descargar el póster de la API de HEAT (PDF, en inglés): una introducción visual al flujo de trabajo.
Estudios de caso multinacionales
Vea cómo se utilizaron evaluaciones repetidas para explorar mayores niveles de actividad en la Región Europea de la OMS:
- ¿Qué podría ganar Europa con más ciclismo?
- ¿Qué podría ganar Europa si se caminara más?
- ¿Qué podría ganar Europa si se duplicara el ciclismo?
Instrucciones técnicas y documentación originales de la API de HEAT (en inglés). Consúltelas si estas orientaciones no resuelven todas sus dudas, o escriba a heatwalkingcycling@who.int.