API Metadados IBGE
A API metadados fornece, através do protocolo HTTP, acesso aos metadados públicos presentes no banco de Metadados do IBGE, referentes a pesquisas e ocorrências de pesquisa, além de informações sobre os objetivos de desenvolvimento sustentável.
A API disponibiliza os seguintes serviços:
► Pesquisa
- /api/Pesquisa
-
Apresenta as informações básicas de todas as pesquisas cadastradas no banco de metadados.
Exemplo:[ { "codigo": "AC", "nome": "Pesquisa Anual da Indústria da Construção ", "nome_ingles": "Annual Survey of Construction Industry", "situacao": "Ativa", "categoria": "Estrutural", "periodicidade_coleta": "Anual", "periodicidade_divulgacao": "Anual", "classificacoes_tematicas": [ { "nome": "Construção", "nome_ingles": null, "descricao": "Compreende as informações econômico-financeiras, de produção, bens e serviços consumidos, e emprego, entre outros aspectos, específicas das atividades da Construção, que pertencem à seção F da CNAE 2.0.", "descricao_ingles": null, "dominio": "Estatísticas econômicas", "dominio_ingles": "Economic statistics" }, { "nome": "Estatísticas econômicas setoriais", "nome_ingles": null, "descricao": "Compreende as informações sobre atividades econômicas desenvolvidas pelas unidades de produção, abrangendo ramos específicos, tais como Agricultura, pecuária, produção florestal, pesca e aquicultura, Indústrias extrativas, Indústrias de transformação, Construção, Comércio e Serviços, definidos de acordo com a sua atividade principal, segundo a Classificação Nacional de Atividades Econômicas - CNAE 2.0.", "descricao_ingles": null, "dominio": "Estatísticas econômicas", "dominio_ingles": "Economic statistics" } ] }, { "codigo": "AB", "nome": "Pesquisa Mensal de Abate de Animais", "nome_ingles": "Monthly Survey of Animal Slaughter", "situacao": "Concluída", "categoria": "Conjuntural", "periodicidade_coleta": "Mensal", "periodicidade_divulgacao": "Mensal", "classificacoes_tematicas": [ { "nome": "Outras estatísticas econômicas não especificadas", "nome_ingles": null, "descricao": "Compreende as informações econômicas sobre empresas e outras organizações em diferentes setores e trata de temas como demografia das empresas, empresas por porte específico, e instituições sem fins lucrativos, entre outros aspectos.", "descricao_ingles": null, "dominio": "Estatísticas econômicas", "dominio_ingles": "Economic statistics" } ] } ]
► Ocorrência de Pesquisa
- /api/ocorrenciaPesquisa/{codigoPesquisa}
-
Apresenta todas as ocorrências públicas da pesquisa que possui como código o valor inserido em {codigoPesquisa}.
Exemplo:[ { "ano": 2000, "mes": 0, "ordem_periodo": 0, "nome_ocorrencia": "Censo Demográfico - 2000" }, { "ano": 2010, "mes": 0, "ordem_periodo": 0, "nome_ocorrencia": "Censo Demográfico - 2010" } ]
- /api/ocorrenciaPesquisa/{codigoPesquisa}/{ano}/{mes}/{ordemPeriodo}
-
Apresenta os metadados da ocorrência da pesquisa com código igual a {codigoPesquisa}, referente ao ano, mês e ordem período informados nos demais parâmetros.
Exemplo:{ "situacao": "Ativo", "categoria": "Estrutural", "tipo": "Censo demográfico", "area": "Estatísticos", "sigla": "CD", "data_inicio": "01/01/1872", "data_desativacao": "", "url_sidra": "http://www.sidra.ibge.gov.br/cd/cd2010RgaAdAgsn.asp", "url_concla": null, "classificacoes_tematicas": [ { "nome": "Turismo", "descricao": "Compreende as informações sobre atividade dos visitantes (estrangeiros ou nacionais), abrangendo chegadas e partidas, diárias, gastos e propósito da visita; infraestrutura; e conta-satélite do turismo, entre outros aspectos.", "dominio": "Estatísticas multidomínio e meio ambiente" }, { "nome": "Trabalho", "descricao": "Compreende trabalho remunerado e outras formas de trabalho.", "dominio": "Estatísticas sociais" }, { "nome": "Trabalho remunerado", "descricao": "Compreende as informações sobre força de trabalho e mercado de trabalho, abrangendo informações sobre população na força de trabalho, ocupação, desocupação, posição na ocupação, horas trabalhadas; características do empreendimento ou negócio (atividade econômica, tamanho do empreendimento, existência de estabelecimento para funcionar); saúde e segurança no trabalho (acidentes e enfermidades ocupacionais); trabalho decente; e grupos vulneráveis, entre outros aspectos. \r\nEste tema não compreende: \r\n\r\n- Trabalho para o próprio consumo, o trabalho voluntário, afazeres domésticos e cuidados de pessoas moradoras no próprio domicílio ou familiares residentes em outros domicílios. (Outras formas de trabalho) \r\n- Rendimento do trabalho (Rendimento, despesa e consumo) \r\n- Seguro desemprego e benefícios de proteção social (Proteção social) \r\n- Participação sindical (Participação política e conexões sociais) \r\n- Custos do trabalho\r\n- Setor informal", "dominio": "Estatísticas sociais" }, { "nome": "Estatísticas multidomínio", "descricao": "Compreende as abordagens temáticas específicas que perpassam pelo menos dois domínios – demografia e estatísticas sociais, estatísticas econômicas e estatísticas ambientais.\r\n Compreende os subtemas Condições de vida, pobreza e desigualdade; Sociedade da informação; Empreendedorismo; Gênero; Cultura, recreação e esporte; e Turismo.", "dominio": "Estatísticas multidomínio e meio ambiente" } ], (...) }
► Objetivos de desenvolvimento sustentável
- /api/ODS/Metas/{numeroObjetivo}
-
Apresenta todas as metas relacionadas ao objetivo de número igual a {numeroObjetivo} e seus respectivos indicadores.
Exemplo:[ { "numero": "6.1", "nome": "Até 2030, alcançar o acesso universal e equitativo a água potável e segura para todos", "descricao": null, "indicadores": [ { "numero": "6.1.1", "nome": "Proporção da população com abastecimento de água gerenciado de forma segura", "descricao": null } ] }, { "numero": "6.2", "nome": "Até 2030, alcançar o acesso a saneamento e higiene adequados e equitativos para todos, e acabar com a defecação a céu aberto, com especial atenção para as necessidades das mulheres e meninas e daqueles em situação de vulnerabilidade", "descricao": null, "indicadores": [] }, ]
- /api/ODS/FichaMetodologica/{numeroIndicador}
-
Apresenta a ficha metodológica relacionada ao indicador que possui número igual a {numeroIndicador}. O valor passado em {numeroIndicador} deve utilizar o caracter - como separador dos números do indicador.
Exemplo:[ { "objetivo": "Vida terrestre", "meta": "Até 2020, assegurar a conservação, recuperação e uso sustentável de ecossistemas terrestres e de água doce interiores e seus serviços, em especial florestas, zonas úmidas, montanhas e terras áridas, em conformidade com as obrigações decorrentes dos acordos internacionais", "Indicador": "Áreas Protegidas", "conceito_definicao": "Áreas protegidas", "formula_calculo": "Formula áreas protegidas", "populacao_alvo": "Pessoas", "ano_inicio_serie_historica": 2015, "ano_fim_serie_historica": 2020, "acesso": "http://censo2010.ibge.gov.br/", "contato": "0800-721-8181\r\nwww.ibge.gov.br", "referencias": [ { "nome": null, "link": "http://www.ibge.gov.br" }, { "nome": null, "link": "http://w3.metadados.ibge.gov.br" } ], "instituicao_produtora": "Instituto Brasileiro de Geografia e Estatística", "periodicidade": "Anual", "unidade_medida": "metros", "abrangencia": "Nacional", "nivel_desagregacao": "Nacional", "variaveis": [ { "nome": "Área com plantações do Brasil, área em hectares", "fonte": "CD", "instituicao": "Instituto Brasileiro de Geografia e Estatística" }, { "nome": "V1", "fonte": "CD2010", "instituicao": "Instituto Brasileiro de Geografia e Estatística" } ], "indicadores_relacionados": [ "Proporção da população com abastecimento de água gerenciado de forma segura" ] } ]