Quizás lo más difícil de construir una API es definir qué métodos proveer. Estos dependen de los datos que tenemos.
Para el caso de Censo 2010, la información scrapeada del INDEC solo contiene datos de población en el país. (Por lo menos por ahora)
Elegí proveer métodos básicos para consultas sobre población por departamento o provincia.
Por ejemplo:
GET /poblacion/buenos_aires/san_nicolas
Devuelve todos los datos de población detallados (edad, cantidad de hombres, cantidad de mujeres) del departamento de San Nicolás, Buenos Aires.
Este método no realiza ningún cálculo, solo expone los datos del Censo 2010 en JSON, para ser procesados por otros programas.
Para ver solamente los totales, podemos hacer:
GET /poblacion/buenos_aires/san_nicolas/totales
Esto solo mostrará el total de mujeres y varones en San Nicolás, Buenos Aires.
Sé que el formato no es amigable al ojo no técnico, pero hay formas simples de tomar esa información y mostrarla ‘amigablemente‘. (y estoy trabajando en eso)
Acá (http://censo.heroku.com) pueden ver los métodos que desarrollé y acá el código detrás de la API (https://github.com/etagwerker/censo2010/blob/v2/site.rb#L51)
¿Simple, no?