Dados abertos

O que são dados abertos?

Segundo a definição da Open Knowledge Foundation, em suma,

dados são abertos quando qualquer pessoa pode livremente usá-los, reutilizá-los e redistribuí-los, estando sujeito a, no máximo, a exigência de creditar a sua autoria e compartilhar pela mesma licença.

Open Knowledge Foundation

Você pode saber mais sobre o assunto acessando o Portal de dados abertos do Brasil.

O que são Indicadores?

Um indicador social é uma medida em geral quantitativa dotada de significado social substantivo, usada para substituir, quantificar ou operacionalizar um conceito social abstrato, de interesse teórico (para pesquisa acadêmica) ou programático (para formulação de políticas)

Paulo de Martino Jannuzzi, 2011

Dentro da plataforma Iota, um indicador é composto por uma ou mais variáveis agrupadas por operadores matemáticos.

Cada variável tem um período de atualização, por exemplo, diariamente, semanalmente, mensalmente ou anualmente.

Quandos os dados são inseridos no Iota, a entrada contém qual variável, qual a data e qual a fonte daquela entrada.

Com isso, os indicadores que utilizam daquela variável são atualizados automaticamente e geram um novo número, chamado de valor do indicador.

Você pode fazer o download de maneira simples e aberta dos dados de valores dos indicadores ou valores das variáveis.

API para desenvolvedores

Você também pode consultar os dados que estão armazenados no Iota via API.

Para saber mais, navegue até a seção API.

RDF para desenvolvedores

Você pode consultar as variaveis e indicadores utilizando RDF.

Para saber mais, navegue até a seção RDF.

Baixar arquivos

Links

Arquivo de indicadores

Arquivo de variáveis

Informações contidas nos arquivos

Arquivo de indicadores

  • Nome da cidade
  • Nome do indicador
  • Data
  • Valor
  • ID da cidade
  • Eixo
  • ID Indicador
  • Formula do indicador
  • Meta do indicador
  • Descrição da meta do indicador
  • Fonte da meta do indicador
  • Operação da meta do indicador
  • Descrição do indicador
  • Tags do indicador
  • Observações do indicador
  • Período do indicador
  • Faixa
  • Meta do valor
  • Justificativa do valor não preenchido
  • Região, se existir
  • Fontes

Arquivo de variáveis

  • Nome da cidade
  • Nome
  • Data
  • Valor
  • ID da cidade
  • ID
  • Tipo
  • Apelido
  • Período de atualização
  • Fonte
  • É Básica?
  • Unidade de medida
  • Observações
  • Fonte do valor

API para desenvolvedores

O Iota fornece uma REST API para a consulta dos dados.

Os endpoints podem entregar o contéudo serializado em JSON, XML e YAML.

O content-type é definido automaticamente pelo header Accept. Por padrão, a resposta é no formato JSON.

Para pedir manualmente, utilize ?content-type=application/json para JSON, ?content-type=text/xml para XML, e ?content-type=text/x-yaml para YAML.

Todos os endpoints utilizam o domínio para descobrir qual a rede ativa para a consulta, isso influência no resultados obtidos.

Rede ativa no momento

Você esta no domínio indicadores.cidadessustentaveis.org.br, rede ID 1

Endpoints

Endpoint Descrição Parâmetros aceitos
/indicators
Lista de todos os indicadores Filtros:
  • user_id=123
Se user_id for enviado, os indicadores desabilitado por usuário não retornam.
/users
Lista de todos os usuários e sua cidade -
/cities
Lista de todas as cidades -
/networks
Nome da rede e instituição do domínio acessado. -
/download-indicators
Valores calculados por indicador Filtros:
  • user_id=100,222,...
  • city_id=1,5,...
  • region_id=321,...
  • indicator_id=123,..
  • valid_from=2000-01-01,...
  • valid_from_begin=2000-01-01
  • valid_from_end=2010-01-01
Caso o campo region_id não for especificado, a consulta retorna os valores da cidade.
/download-variables
Valores das variáveis Todos os filtros do endpoint /download-indicators, exceto indicator_id, mais:
  • variable_id=123,..

/indicators voltar para endpoints

Exemplo de retorno:

$.get('/indicators', function(ret){console.log(ret)}); // after execute this

ret = {
    "indicators": [
        {
            "source": null,
            "sort_direction": null,
            "variety_name": null,
            "name_url": "crimes-violentos-nao-fatais",
            "visibility_user_id": 3,
            "axis": {
                "created_at": "2012-10-23 01:43:35.541972",
                "name": "Equidade, Justiça Social e Cultura de Paz",
                "id": 3
            },
            "indicator_admins": null,
            "chart_name": null,
            "created_at": "2013-08-20 16:39:54.30607",
            "all_variations_variables_are_required": 1,
            "formula": "$502 / $19 *100000",
            "indicator_type": "normal",
            "id": "251",
            "formula_human": "Número de crimes violentos não fatais / População total *100000",
            "featured_in_home": 0,
            "variable_type": "int",
            "period": "yearly",
            "observations": null,
            "name": "Crimes violentos não fatais",
            "visibility_country_id": null,
            "axis_id": 3,
            "tags": null,
            "goal_explanation": null,
            "goal_operator": null,
            "goal": null,
            "visibility_level": "private",
            "explanation": "Número de crimes violentos não fatais por cem mil habitantes",
            "goal_source": null,
            "user_id": 1,
            "dynamic_variations": null,
            "summarization_method": "sum"
        }
    ]
}

/users voltar para endpoints

Exemplo de retorno:

$.get('/users', function(ret){console.log(ret)}); // after execute this

ret = {
    "users": [
        {
            "city_summary": "Somos um movimento da sociedade civil que reúne setores empresariais, acadêmicos, movimentos sociais e cidadãos, mobilizados com o intuito de selecionar, propor e monitorar indicadores da cidade do Recife na busca da melhoria dos níveis de vida de todos os que habitam a capital pernambucana. Aberto a contribuições múltiplas, o ODR não tem destaque para lideranças individuais nem direcionamento político-partidário ou privilégio de grupos específicos. Nossa missão consiste em mobilizar a sociedade para  selecionar, propor e monitorar um conjunto de indicadores e metas que se constituam numa agenda de desenvolvimento sustentável para o Recife e que levem a transformá-la numa cidade melhor para se viver.",
            "city": {
                "uf": "PE",
                "pais": "br",
                "name_uri": "recife",
                "name": "Recife",
                "id": 110
            },
            "city_id": 110,
            "language": "pt-br",
            "regions_enabled": 1,
            "name": "Observatório do Recife",
            "id": "136"
        }
    ]
}

/cities voltar para endpoints

Exemplo de retorno:

$.get('/cities', function(ret){console.log(ret)}); // after execute this

ret = {
    "cities": [
        {
            "name_uri": "rio-branco",
            "summary": null,
            "id": 546,
            "longitude": "-67.824918",
            "pais": "brasil",
            "name": "Rio Branco",
            "latitude": "-9.9753837",
            "uf": "AC"
        }
    ]
}

/networks voltar para endpoints

Exemplo de retorno:

$.get('/networks', function(ret){console.log(ret)}); // after execute this

ret = {
    "network": {
        "institute": {
            "name": "Movimentos",
            "id": 2,
            "description": "administrado pelos movimentos"
        },
        "name": "Rede Social Brasileira por Cidades Justas e Sustentáveis",
        "id": 2
    }
}

/download-indicators voltar para endpoints

Exemplo de retorno:

$.get('/download-indicators', function(ret){console.log(ret)}); // after execute this

ret = {
    "data": [
        {
            "user_goal": null,
            "justification_of_missing_field": null,
            "valid_from": "01/01/2012",
            "indicator_id": 191,
            "region_id": null,
            "indicator_name": "Orçamento do município destinado a transporte público",
            "formula": "$322/$323*100",
            "city_name": "São Paulo",
            "axis_name": "Melhor Mobilidade, Menos Tráfego",
            "formula_human": "Valor total do orçamento, em reais, destinado a transporte público / Valor total do orçamento da área de transporte do município *100",
            "institute_id": 2,
            "city_id": 1,
            "period": "anual",
            "region_name": null,
            "value": "68.8442061662337",
            "observations": null,
            "variation_order": null,
            "goal_explanation": "Destinar 100% dos recursos públicos da área para a melhoria substantiva do transporte público.",
            "goal_operator": null,
            "tags": null,
            "goal": null,
            "sources": [
                "SEMPLA (Secretaria Municipal de Planejamento)"
            ],
            "explanation": "Percentual do orçamento do município destinado ao transporte público.",
            "updated_at": "2013-11-06 08:52:08.597114",
            "goal_source": "Programa Cidades Sustentáveis",
            "user_id": 11,
            "variation_name": "",
            "technical_information": null
        },
        {
            "user_goal": null,
            "justification_of_missing_field": null,
            "valid_from": "01/01/2012",
            "indicator_id": 191,
            "region_id": null,
            "indicator_name": "Orçamento do município destinado a transporte público",
            "formula": "$322/$323*100",
            "city_name": "Goiânia",
            "axis_name": "Melhor Mobilidade, Menos Tráfego",
            "formula_human": "Valor total do orçamento, em reais, destinado a transporte público / Valor total do orçamento da área de transporte do município *100",
            "institute_id": 2,
            "city_id": 180,
            "period": "anual",
            "region_name": null,
            "value": "32.1055485270197",
            "observations": null,
            "variation_order": null,
            "goal_explanation": "Destinar 100% dos recursos públicos da área para a melhoria substantiva do transporte público.",
            "goal_operator": null,
            "tags": null,
            "goal": null,
            "sources": [
                "Secretaria Municipal de Desenvolvimento Urbano Sustentável - Goiânia",
                "Secretaria Municipal de Trânsito, Transportes e Mobilidade - Goiânia"
            ],
            "explanation": "Percentual do orçamento do município destinado ao transporte público.",
            "updated_at": "2013-11-06 08:52:08.597114",
            "goal_source": "Programa Cidades Sustentáveis",
            "user_id": 763,
            "variation_name": "",
            "technical_information": null
        }
    ]
}

/download-variables voltar para endpoints

Exemplo de retorno:

$.get('/download-variables', function(ret){console.log(ret)}); // after execute this

ret = {
    "data": [
        {
            "source": null,
            "measurement_unit_name": null,
            "valid_from": "01/01/2000",
            "cognomen": "idh_municipal",
            "city_name": "São Paulo",
            "variable_id": 30,
            "city_id": 1,
            "is_basic": 1,
            "institute_id": 2,
            "period": "anual",
            "exp_source": null,
            "value": "0.841",
            "name": "Índice de Desenvolvimento Humano (IDH) Municipal",
            "observations": null,
            "updated_at": "2012-11-28 12:10:16.055272",
            "type": "num",
            "user_id": 11
        },
        {
            "source": null,
            "measurement_unit_name": null,
            "valid_from": "01/01/2000",
            "cognomen": "expect_vida",
            "city_name": "São Paulo",
            "variable_id": 28,
            "city_id": 1,
            "is_basic": 1,
            "institute_id": 2,
            "period": "anual",
            "exp_source": null,
            "value": "71.7",
            "name": "Expectativa de Vida: Esperança de vida ao nascer",
            "observations": null,
            "updated_at": "2013-08-18 13:24:36.795562",
            "type": "num",
            "user_id": 11
        }
    ]
}

Realização

Instituto Ethos de Empresas e Responsabilidade Social
/parceiros/instituto-ethos-de-empresas-e-responsabilidade-social
http://www.ethos.org.br
Rede Nossa São Paulo
/parceiros/rede-nossa-s%C3%A3o-paulo
http://www.nossasaopaulo.org.br/portal/
Rede Social Brasileira por Cidades Justas e Sustentaveis
/parceiros/rede-social-brasileira-por-cidades-justas-e-sustentaveis
http://rededecidades.ning.com/

Apoio

Fundação Avina
/parceiros/fundacao-avina
http://www.avina.net/esp/
Instituto Arapyaú
/parceiros/instituto-arapyau
http://www.arapyau.org.br/

Apoio de Mídia

A Tarde
/parceiros/tarde
Abril
/parceiros/abril
http://www.abril.com.br/
CBN
/parceiros/cbn
http://cbn.globoradio.globo.com/home/HOME.htm
Editora Globo
/parceiros/editora-globo
http://corp.editoraglobo.globo.com/
Meio Norte
/parceiros/meio-norte
Rádio Globo
/parceiros/radio-globo
http://radioglobo.globoradio.globo.com/home/HOME.htm
Rede Globo
/parceiros/rede-globo
http://redeglobo.globo.com/
Revista Piauí
/parceiros/revista-piaui

Parceiros Nacionais

ABEMA
/parceiros/abema-0
http://www.abema.org.br/site/pt-br/home/home.php
Afobras
/parceiros/afobras
http://www.afrobras.org.br/
Akatu
/parceiros/akatu
http://www.akatu.org.br/
Associação Brasileira dos Municípios (ABM)
/parceiros/associacao-brasileira-dos-municipios-abm
http://www.abm.org.br/
Atletas pela Cidadania
/parceiros/atletas-pela-cidadania
http://www.atletas.org.br/
CBCS
/parceiros/cbcs
http://www.cbcs.org.br/website/
Cenpec
/parceiros/cenpec
http://www.cenpec.org.br/
Dieese
/parceiros/dieese
http://www.dieese.org.br/
DPZ
/parceiros/dpz-0
http://dpz.com.br/
Escola de Governo
/parceiros/escola-de-governo
http://www.escoladegoverno.org.br/
Famurs
/parceiros/famurs
http://www.famurs.com.br/
Fórum Amazônia Sustentável
/parceiros/forum-amazonia-sustentavel
http://www.forumamazoniasustentavel.org.br/
Frente Nacional de Prefeitos
/parceiros/frente-nacional-de-prefeitos
http://www.fnp.org.br/home.jsf
Gife
/parceiros/gife
http://www.gife.org.br/
Greenpeace
/parceiros/greenpeace
http://www.greenpeace.org/brasil/pt/
Instituto 5 Elementos
/parceiros/instituto-5-elementos
http://www.5elementos.org.br/site/index.php
Instituto Democracia e Sustentabilidade
/parceiros/instituto-democracia-e-sustentabilidade
http://www.idsbrasil.net/
Instituto Saúde e Sustentabilidade
/parceiros/sa%C3%BAde-e-sustentabilidade
http://www.saudeesustentabilidade.org.br/
Instituto Socioambiental
/parceiros/instituto-socioambiental
http://www.socioambiental.org/
Instituto Cidade Democrática
/parceiros/icd
http://www.cidadedemocratica.org.br/
Mobilize
/parceiros/mobilize
http://www.mobilize.org.br/
Movimento de Combate a Corrupção Eleitoral (MCCE)
/parceiros/movimento-de-combate-corrupcao-eleitoral-mcce
http://www.mcce.org.br/site/
NEF - Núcleo de Estudos do Futuro
/parceiros/nef-n%C3%BAcleo-de-estudos-do-futuro
http://www.nef.org.br/
OAB Conselho Federal
/parceiros/oab-conselho-federal
http://www.oab.org.br/
ONU Habitat
/parceiros/onu-habitat
http://www.unhabitat.org/categories.asp?catid=9
Pnuma
/parceiros/pnuma
http://www.pnuma.org.br/
Rede de Ação Política pela Sustentabilidade (RAPS)
/parceiros/rede-de-acao-politica-pela-sustentabilidade-raps-0
http://www.raps.org.br/
Roland-Berger
/parceiros/roland-berger
http://www.rolandberger.com.br/
Sesc
/parceiros/sesc
http://www.sescsp.org.br/sesc/
SOS Mata Atlântica
/parceiros/sos-mata-atl%C3%A2ntica
http://www.sosma.org.br/
Todos pela Educação
/parceiros/todos-pela-educa%C3%A7%C3%A3o
http://www.todospelaeducacao.org.br/
Transition Brasil
/parceiros/transition-brasil
http://transitionbrasil.ning.com/
Trata Brasil
/parceiros/trata-brasil
http://www.tratabrasil.org.br/
União dos Vereadores do Brasil
/parceiros/uniao-dos-vereadores-do-brasil
http://www.uvbbrasil.com.br/novo/
Unicef
/parceiros/unicef
http://www.unicef.org/brazil/pt/
Vitae Civilis
/parceiros/vitae-civilis
http://www.vitaecivilis.org.br/
WWF
/parceiros/wwf
http://www.wwf.org.br/

Parceiros Internacionais

Aalborg
/parceiros/aalborg
http://www.sustainablecities.eu/
Conama
/parceiros/conama
DAC - Danish Architecture Centre
/parceiros/dac-danish-architecture-centre
http://www.dac.dk/
Eco City Builders
/parceiros/eco-city-builders
http://www.ecocitybuilders.org/
Ecodes
/parceiros/ecodes
http://www.ecodes.org/
Ford Foundation
/parceiros/ford-foundation
http://www.fordfoundation.org/
La Ciudad Verde
/parceiros/la-ciudad-verde
http://www.laciudadverde.co/2/
New Cities Foundation
/parceiros/new-cities-foundation
http://www.newcitiesfoundation.org/
Red Argentina de municipios frente al cambio climático
/parceiros/red-argentina-de-municipios-frente-al-cambio-climatico
http://www.gobiernolocal.gob.ar/index.php?option=com_flexicontent&view=items&Itemid=15&cid=5&id=158637
Red Paraguaya por Ciudades Sustentables
/parceiros/red-paraguaya-por-ciudades-sustentables
http://ciudadessustentables.org/
Red Uruguaya de Ciudades Justas Democraticas y Sustentables
/parceiros/red-uruguaya-de-ciudades-justas-democraticas-y-sustentables
http://www.redciudades.org.uy/
Sustainable Cities
/parceiros/sustainable-cities
http://sustainablecities.net/
Sustainable Cities Europe
/parceiros/sustainable-cities-europe
http://www.sustainablecities.eu/
This Big City
/parceiros/big-city
http://thisbigcity.net/

Patrocinadores

ALCOA
/parceiros/alcoa
http://www.alcoa.com/brasil/pt/info_page/home.asp
Anamma
/parceiros/anamma
http://www.anamma.com.br/
Bradesco
/parceiros/bradesco
http://www.bradesco.com.br/html/classic/index.shtm
BRF
/parceiros/brf
http://www.brf-br.com/
Caixa Econômica Federal
/parceiros/caixa-econ%C3%B4mica-federal
http://www.caixa.gov.br/
CPFL Energia
/parceiros/cpfl-energia
http://www.cpfl.com.br/
Dualtec
/parceiros/dualtec
http://www.dualtec.com.br/
Embraer
/parceiros/embraer
http://www.embraer.com/pt-BR/Paginas/Home.aspx
IBM
/parceiros/ibm
http://www.ibm.com/br/pt/
Instituto Cyrela
/parceiros/instituto-cyrela
http://www.institutocyrela.com.br/site/home
Instituto Semeia
/parceiros/instituto-semeia
http://www.semeia.org.br/
Itaipu Binacional
/parceiros/itaipu-binacional
http://www.itaipu.gov.br/
Itaú
/parceiros/ita%C3%BA
http://www.itau.com.br
Natura
/parceiros/natura
http://www.natura.net/br/index.html
Nestlé
/parceiros/nestl%C3%A9
http://www.nestle.com.br/site/home.aspx
Porto Seguro
/parceiros/porto-seguro
http://www.portoseguro.com.br/
Promon
/parceiros/promon
http://www.promon.com.br/
Safra
/parceiros/safra
http://www.safra.com.br/portugues/index2.asp
Santander
/parceiros/santander
https://www.santander.com.br/
Vale
/parceiros/vale
http://www.vale.com/PT/Paginas/Landing.aspx
Votorantin
/parceiros/votorantin
http://www.institutovotorantim.org.br/pt-br/Paginas/home.aspx
VR
/parceiros/vr
http://www.vr.com.br/portal/
Walmart
/parceiros/walmart
http://www.walmart.com.br/