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.