API para las Elecciones Auton¨®micas 2012

Cada vez es m¨¢s insostenible que Espa?a carezca de una verdadera Ley de Transparencia Informativa. En EL PA?S hemos escrito varias veces sobre ello y cada vez hay m¨¢s iniciativas particulares que lo piden.

Posiblemente, uno de los momentos m¨¢s importantes de cualquier democracia es el escrutino de unas elecciones y el flujo de esos resultados en tiempo real, hacia aquellos que votamos, el mejor ejemplo de apertura y transparancia de datos. En EL PA?S creemos en esa apertura y lo estamos intentando. Al igual que elecciones anteriores, en las pr¨®ximas Elecciones Andaluzas y Asturianas 2012 existir¨¢ un API para el acceso a los datos del escrutinio. Aqu¨ª te lo contamos.

Particularidad de estas Elecciones

El 25-M hay realmente dos convocatorias de Elecciones:

• Andaluzas: Elecciones al Parlamento Andaluz, donde la anterior convocatoria fue en 2008.
• Asturianas: Elecciones anticipadas a la Junta General del Principado de Asturias, donde la anterior convocatoria fue en 2011 pero donde la anterior ordinaria fue en 2007.

Por tanto, para Andaluc¨ªa los datos anteriores ser¨¢n para 2008 pero para Asturias estar¨¢n disponibles tanto las de 2011 como las de 2007.

Datos accesibles

Como es habitual, todas las p¨¢ginas de resultados tendr¨¢n un enlace para descargar los datos en XML: Ser¨¢n descargables todos los datos de las dos CC AA, circunscripciones, provincias y/o municipios que nosotros mismos estaremos usando. Exactamente los mismos datos que nosotros estaremos usando en nuestras p¨¢ginas.

Por tanto, publicaremos XMLs con los resultados de las dos CC AA, sus circunscripciones/provincias y cada uno de sus municipios. Con esta informaci¨®n no solo 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 lo deseen.

Ficheros disponibles

Tendremos tres niveles de informaci¨®n:

• Nivel CC AA.
• Nivel circunscripci¨®n.
• Nivel municipio.

Todos y cada uno de ellos dispondr¨¢n de su XML con los resultados. Por ejemplo, en los datos de sus respectivas elecciones anteriores:

• Nivel CC AA: Andaluc¨ªa, html y xml; Asturias, html y xml.
• Nivel circunscripci¨®n: Almer¨ªa en Andaluc¨ªa, html y xml; Oriente de Asturias, html y xml.
• Nivel municipio: Moguer en Huelva, html y xml.

Por supuesto, habr¨¢ que cambiar las URLs a 2012 para llegar a los resultados de la presente convocatoria.

Descripci¨®n

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 (no aplicable a estas Elecciones), 2 - CC AA, 3 - Circunscripci¨®n, 4 - Comarca (no aplicable a estas Elecciones) y 5 - Municipio.
• Los decimales se representan con punto (y no con coma).

Hasta el momento en que los datos de 2012 comiencen a estar disponibles, los XMLs tendr¨¢n dos estados:

Hasta las 20.00 del 25-M, 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).

Resumen de ganadores

Se generar¨¢n tres ficheros:

• pgCIR.xml2: contendr¨¢ los partidos ganadores por circunscripciones. El fichero de 2008 de Andaluc¨ªa es http://rsl00.epimg.net/elecciones/2008/autonomicas/partidosGanadores/pgCIR.xml2 y donde se contendr¨¢ Asturias de 2011 http://rsl00.epimg.net/elecciones/2011/autonomicas/partidosGanadores/pgCIR.xml2 (recordemos que estas fueron Auton¨®micas en toda Espa?a y, por tanto, se contienen todas las Circunscripciones a nivel nacional).
• pgCA.xml2: contendr¨¢ los partidos ganadores por CC AA. El fichero de 2008 para Andaluc¨ªa es http://rsl00.epimg.net/elecciones/2008/autonomicas/partidosGanadores/pgCA.xml2 y el que contiene Asturias en 2011 http://rsl00.epimg.net/elecciones/2011/autonomicas/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/autonomicas/partidosGanadores/pg.xml2 y el de 2011 http://rsl00.epimg.net/elecciones/2011/autonomicas/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 circunscripciones, 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 u 'o' si gana cualquier otro partido. Todos ellos sin comillas.

Al igual que con los XMLs del escrutinio, para obtener los datos 2012 habr¨¢ que poner este a?o en la URL en vez de los a?os anteriores.