API para las Elecciones Generales 2011

Hace unos días, Jesús Ceberio escribía en su blog sobre la necesidad de una ley de transparencia de la información pública. Hasta ahora todo han sido buenas palabras y gestos, pocos hechos y muy medidos. Es increíble que los ciudadanos no tengamos un acceso fluido y transparente a la mayoría de datos e información que --no lo olviden señores políticos-- es nuestra, no suya.

En El País creemos en ello y con motivo del sorteo de la Lotería de Navidad liberamos dos APIs (Eskup es otro ejemplo) que permitieron acceder a la misma información que estábamos presentando en nuestra web. Ahora le toca el turno al resultado del escrutinio de las Elecciones Generales 2011.

Datos accesibles

Todos aquellos que siguieron el escrutinio las dos últimas convocatorias de Elecciones (Catalanas de 2010 y Autonómicas y Municipales de 2011) pudieron observar cómo todas las páginas de resultados tenían un enlace para descargar los datos en XML. Todos los datos de CC AA, circunscripciones, provincias y/o municipios que nosotros mismos íbamos usando, eran descargables desde ese mismo instante.

En estas elecciones haremos lo mismo y añadiremos tres ficheros más, por CC AA y provincias, que darán una visión global del resultado del escrutinio.

Por tanto:

• Publicaremos XMLs con los resultados de todas y cada una de la CC AA, Provincias y Municipios tanto para el escrutinio de las Elecciones al Congreso, como para el de las Elecciones al Senado. Por supuesto, también existirán ficheros del escrutinio a nivel nacional.
• Publicaremos 3 XMLs con un resumen de los partidos ganadores para el Congreso: uno los ganadores de cada una de las CC AA, otro para provincias y otro que aunará todas las informaciones y donde el programa que lo use debe distinguir entre unos y otros.

Con todo ello, ponemos a disposición de todos nuestros lectores los datos necesarios para que no solo estén informados, sino para que puedan procesar la información y presentarla como deseen.

Escrutinio al Congreso y Senado

En el escrutinio del Congreso hay cuatro niveles de información:

• Nivel nacional.
• Nivel CC AA.
• Nivel provincia (en aquellas que no son uniprovinciales).
• Nivel municipio.

Todos y cada uno de ellos dispondrán de su XML con los resultados. Por ejemplo, en los datos de 2008:

• Nivel España: html, xml.
• Aragón, nivel CC AA: html, xml.
• Huesca, nivel provincia: html, xml.
• Barbastro, nivel municipio: html, xml.

Para llegar a los resultados de 2011, habrá que cambiar 2008 por 2011 en los paths de los ficheros.

La sencillez de los XMLs (ver cualquiera de los anteriores) hace innecesaria la descripción pormenorizada de ellos y solo es necesaria la explicación de algunos campos puntuales:

• El campo ts significa timestamp y es la hora Unix del momento en que se procesó el escrutinio. Si es 0 significa que el escrutinio ya está cerrado.
• El campo tipo_sitio puede tomar los siguientes valores: 1 - Total España, 2 - CC AA, 3 - Provincia o circunscripción, 4 - Comarca (no aplicable a estas Elecciones) y 5 - Municipios.
• Los decimales se representan con punto (y no con coma).
• En el Senado, solo se hace un acumulado de partidos a Nivel España. En el resto de niveles se da el nombre de los candidatos más votados.
• Siguiendo con el Senado, no existe el nivel CC AA. Las votaciones son por circunscripciones (que equivalen a provincias salvo en las islas que equivalen a cada una de las islas que componen la CC AA).

Hasta el momento en que los datos de 2011 comiencen a estar disponibles, los XMLs tendrán dos estados:

• Hasta las 20.00 del 20-N, contendrán el campo antes_inicio igual a 1.
• A partir de ese momento y hasta que comencemos a disponer de datos, contendrán el campo antes_inicio igual a 2.
• Los XMLs con datos de escrutinio no contienen el campo antes_inicio (ver ejemplos de 2008).

Resumenes de ganadores para el Congreso

Se generarán tres ficheros:

• pgCIR.xml2: contendrá los partidos ganadores por provincias. El fichero de 2008 es: http://rsl00.epimg.net/elecciones/2008/generales/congreso/partidosGanadores/pgCIR.xml2
• pgCA.xml2: contendrá los partidos ganadores por CC AA. El fichero de 2008 es: http://rsl00.epimg.net/elecciones/2008/generales/congreso/partidosGanadores/pgCA.xml2
• pg.xml2: contendrá los partidos ganadores para el nivel España, cada una de las CC AA y cada una de las provincias de estas. El fichero de 2008 es http://rsl00.epimg.net/elecciones/2008/generales/congreso/partidosGanadores/pg.xml2

La diferencia básica entre ellos, como se puede ver, es poder simplificar el procesamiento del XML en función de las necesidades de información. Es verdad que el último lo contiene todo pero si, por ejemplo, queremos pintar los ganadores por provincias, el uso del primero hace que debamos pintar todos los elementos mientras que para el último deberemos distinguir los elementos con los que queremos quedarnos.

Al igual que pasaba anteriormente, un simple visionado de los ejemplos anteriores explica su estructura interna. De todos modos:

• El campo ts de cada uno de los elementos vuelve a tener el comportamiento antes explicado. El campo ts superior indica cuándo fue generado el fichero.
• Los posibles valores del campo tipo son los mismos que antes para tipo_sitio.
• Si el campo tipo es 3 (provincia), aparecerán dos campos más (id_ca y nombre_ca) para indicar a qué comunidad autónoma pertenece.
• El campo código_color indica la tendencia que ha ganado. Los posibles valores son d si gana PP, i si gana el PSOE o o si gana cualquier otro partido.

También como antes, los ficheros de 2011 estarán en la misma ruta pero cambiando el 2008 por 2011.