-d Ativa modo debug: nesse caso a URL acessada será replicada na tela quando houver requisição de um webservice.
-host Host do servidor web. Default: 127.0.0.1
-p Porta do serviço. Default: 5000
-c Tipo de cache: 0 - sem cache, 1 - cache descompactado, 2 - cache compactado, Default: 1
Existem indicadores no SISMOI em que o valor mais alto é bom e outros em que o valor mais alto é ruim. Exemplo:
O indicador Monitoramento e Prioridade Federal pertence ao primeiro grupo. Isso significa que um valor como 0,87 para esse indicador é bom ou seja, quando for ser exibido na forma de uma cor, esta será verde.
Já o indicador Exposição Biofísica tem um comportamento oposto, ou seja, quanto maior o valor, pior o indicador. Nesse caso o mesmo valor deve ser exibido na cor vermelha.
Os serviços providos pelo sismoyWS.py levam isso em consideração, ou seja: quando é indicada uma cor pra um determinado valor, as cores sindicadas pela propriedade valuecolor respeitam essa regra.
Da mesma forma, quando necessário, caso do getTotal, os valores são ordenados em ordem decrescente de acordo com esse parâmetro, ou seja: os melhores valores estarão sempre em primeiro lugar.
Retorna a lista de todos os indicadores do SISMOI, juntamente com as suas descrições, bem como a hierarquia existente entre eles.
Nenhum
curl -i http://127.0.0.1:5000/sismoi/getHierarchy
json contendo um registro para cada indicador. Os indicadores estão ordenados por nível (level) e por código (id) dentro do nível. Os níveis de valores menores são os mais acima na hierarquia.
- complete_description: descrição completa do indicador.
- equation: equação de ponderação do valor do indicador (null, por enquanto).
- id: id do indicador.
- indicator_id_master: id do indicador pai (indicador do qual este estará pendente na hierarquia).
- level: nível do indicador.
- name: nome do indicador.
- shorname: sigla do indicador, a ser usado na equação de ponderação (null por enquanto).
- simple_description: descrição simples do indicador.
- title: título do indicador.
- years: lista de anos em que o indicador ocorre, separados por vírgula.
- pessimist: se igual a 0, o indicador é "bom" quando o valor é alto, se igual a 1, quanto maior o valor do indicador pior é.
[
{
"id": 1,
"name": "Água",
"title": "Impactos em Água",
"shortname": null,
"simple_description": "Consequências esperadas e resultantes das mudanças climáticas em sistemas naturais e humanos relacionados à segurança hídrica",
"complete_description": "Este índice diz respeito aos efeitos sobre vidas, meios de subsistência, saúde, ecossistemas, economias, sociedades, culturas, serviços e infraestrutura devido a alterações climáticas ou eventos climáticos que se dão dentro de períodos específicos de tempo, vulnerabilidade e de exposição da sociedade ou sistema (IPCC, 2015), relacionados à segurança hídrica.<br><br>Referência:<br> INTERGOVERNMENTAL PANEL ON CLIMATE CHANGE - IPCC. Climate Change 2014: Synthesis Report. Working Groups I, II and III to the Fifth Assessment Report of the Intergovernmental Panel on Climate Change [Core Writing Team, R.K. Pachauri and L.A. Meyer (eds.)]. IPCC, Geneva, Switzerland, 151 pp.",
"equation": null,
"years": "2015",
"level": 1,
"pessimist": null,
"indicator_id_master": null
},
{
"id": 2,
"name": "Seca",
"title": "Índice de Impacto para a Seca",
"shortname": null,
"simple_description": "Impacto das mudanças climáticas em sistemas naturais e humanos, considerando a perturbação climática de seca",
"complete_description": "Impacto das mudanças climáticas em sistemas naturais e humanos, resultante da interação entre os eventos climáticos relacionados à seca, vulnerabilidade e de exposição da sociedade ou sistema.<br><br>Fonte:<br> Sistema Brasileiro de Monitoramento e Observação de Impactos da Mudança Climática - SISMOI",
"equation": null,
"years": "2015, 2030, 2050",
"level": 2,
"pessimist": 1,
"indicator_id_master": 1
},
{
"id": 3,
"name": "Chuva",
"title": "Índice de Impacto para a Chuva",
"shortname": null,
"simple_description": "Impacto das mudanças climáticas em sistemas naturais e humanos, considerando a perturbação climática de excesso de chuva",
"complete_description": "Impacto das mudanças climáticas em sistemas naturais e humanos, resultante da interação entre os eventos climáticos relacionados ao excesso de chuva, vulnerabilidade e de exposição da sociedade ou sistema.<br><br>Fonte:<br> Sistema Brasileiro de Monitoramento e Observação de Impactos da Mudança Climática - SISMOI",
"equation": null,
"years": "2015, 2030, 2050",
"level": 2,
"pessimist": 1,
"indicator_id_master": 1
}
]Retorna a geometria de um determinado mapa.
- clipping: recorte do mapa. Alternativas: "semiarido", "SE", "PE", "MG", "CE", "BA", "PI", "AL", "PB", "RN", "MA"
- resolution: resolução do mapa. Alternativas: "microrregiao", "mesorregiao", "municipio", "estado"
curl -i http://127.0.0.1:5000/sismoi/getGeometry/clipping=SE,resolution=microrregiao
json contendo os dados. Há informações de projeção e uma propriedade chamada features, que contém propriedades para cada registro do mapa.
- id: da feature.
- name: nome da feature.
Exemplo de retorno (2 registros, resolucao "municipio". Foram retiradas coordenadas geográficas por razões de espaço):
{
"type": "FeatureCollection",
"crs": {
"type": "name",
"properties": {
"name": "urn:ogc:def:crs:OGC:1.3:CRS84"
}
},
"features": [
{
"type": "Feature",
"properties": {
"id": 21,
"uf": "CE",
"name": "Acaraú"
},
"geometry": {
"type": "MultiPolygon",
"coordinates": [
[
[
[-40.331121,-2.805455],
[-40.216206,-2.8167],
[-40.188748,-2.812914],
[-40.147872,-2.839507],
[-40.124927,-2.823793],
[-40.086645,-2.831316],
[-40.076759,-2.840906],
[-40.331121,-2.805455]
]
]
]
}
},
{
"type": "Feature",
"properties": {
"id": 3991,
"uf": "CE",
"name": "Potiretama"
},
"geometry": {
"type": "MultiPolygon",
"coordinates": [
[
[
[
[-40.331121, -2.805455],
[-40.233762, -2.871358],
[-40.273223, -2.869949],
[-40.273521, -2.879356],
[-40.282177, -2.878471],
[-40.324513, -2.860845],
[-40.36254, -2.865738],
[-40.372259, -2.810277],
[-40.331121, -2.805455]
]
]
]
]
}
}
]
}
Retorna os dados associados aos polígonos.
- clipping: recorte do mapa. Alternativas: "semiárido", "SE", "PE", "MG", "CE", "BA", "PI", "AL", "PB", "RN", "MA"
- resolution: resolução do mapa. Alternativas: "microrregiao", "mesorregiao", "municipio", "estado"
- indicator_id: id do indicador a ser exibido
- scenario_id: cenário a ser selecionado, 1 (Otimista), 2 (Pessimista) ou null quando o indicador não tiver.
- year: ano a ser filtrado
curl -i http://127.0.0.1:5000/sismoi/getMapData/clipping=PE,resolution=municipio,indicator_id=2,scenario_id=null,year=2015
json contendo registros pesquisados.
- id: do valor.
- indicator_id: id do indicador.
- scenario_id: id do cenário ou null.
- year: ano a ser filtrado.
- value: valor do indicador.
- valuecolor: cor a ser usada quando o indicador tiver que ser exibido como cor.
[
{
"id": 265041,
"indicator_id": 2,
"scenario_id": null,
"year": 2015,
"value": 0.367,
"valuecolor": "#fdae61"
}, {
"id": 265155,
"indicator_id": 2,
"scenario_id": null,
"year": 2015,
"value": 0.532,
"valuecolor": "#ffffbf"
}, {
"id": 265269,
"indicator_id": 2,
"scenario_id": null,
"year": 2015,
"value": 0.372,
"valuecolor": "#fdae61"
}
]Retorna a geometria e os dados correspondentes num json cujo formato pode ser passado direto para o renderizador (OpenStreeMap).
- clipping: recorte do mapa. Alternativas: "semiárido", "SE", "PE", "MG", "CE", "BA", "PI", "AL", "PB", "RN", "MA"
- resolution: resolução do mapa. Alternativas: "microrregiao", "mesorregiao", "municipio", "estado"
- indicator_id: id do indicador a ser exibido
- scenario_id: cenário a ser selecionado, 1 (Otimista), 2 (Pessimista) ou null quando o indicador não tiver.
- year: ano a ser filtrado
curl -i http://127.0.0.1:5000/sismoi/getGeometryAndData/clipping=PE,resolution=municipio,indicator_id=2,scenario_id=null,year=2015
json contendo registros pesquisados.
- id: do valor.
- name: nome do registro na resolução indicadas.
- value: valor do indicador associado ao registro.
- style: contém o "estilo" de renderização a ser entendido pelo OpenStreetMap, onde color é a cor da borda, fillcolor é a cor do interior do polígono (e varia de acordo com o valor de value) e weight é a espessura da linha (ver exemplo abaixo).
"features": [{
"type": "Feature",
"properties": {
"id": 21,
"name": "Acara\u00fa",
"value": 0.468,
"style": {
"color": "#d7d7d7",
"fillcolor": "#ffffbf",
"weight": 1
}
},
"geometry": {
"type": "MultiPolygon",
"coordinates": [[
[
[-40.331121, -2.805455],
[-40.233762, -2.871358],
[-40.273223, -2.869949],
[-40.273521, -2.879356],
[-40.282177, -2.878471],
[-40.324513, -2.860845],
[-40.36254, -2.865738],
[-40.372259, -2.810277],
[-40.331121, -2.805455]]]
]
}
},Retorna informações hierárquicas sobre os indicadores que podem ser usadas em diferentes locais do SISMOI.
- clipping: recorte do mapa. Alternativas: "semiárido", "SE", "PE", "MG", "CE", "BA", "PI", "AL", "PB", "RN", "MA"
- resolution: resolução do mapa. Alternativas: "microrregiao", "mesorregiao", "municipio", "estado"
- indicator_id: id do indicador a ser exibido
- scenario_id: 1 (Otimista), 2 (Pessimista) ou null quando o indicador não tiver essa cenários.
- year: ano a ser filtrado (opcional: se não for fornecido serão retornados todos os dados de todos os anos).
curl -i http://127.0.0.1:5000/sismoi/getTotal/clipping=RN,indicator_id=19,resolution=municipio,scenario_id=1
json contendo registros pesquisados.
O json é hierárquico, ou seja, existe uma estrutura de árvore entre os registros:
- o primeiro nível é o ano (ex: 2015, 2030, 2050).
- nome da classe de valor (verylow,low,mid,high,veryhigh).
- count: número de registros nessa classe.
- valuecolor: cor da classe de valor.
- data: conjunto de dados daquele ano e naquela classe de valor: id resolução (município, microrregião, mesorregião ou estado), name (nome do objeto na resolução), value (valor do indicador na resolução).
- nome da classe de valor (verylow,low,mid,high,veryhigh).
Sobre a ordenação dos dados, ver tópico Sobre a ordenação dos valores acima.
{
"2010": {
"verylow": {
"data": [],
"count": 0,
"valuecolor": "#1a9641"
},
"count": 0,
"low": {
"data": [],
"count": 0,
"valuecolor": "#a6d96a"
},
"mid": {
"data": [],
"count": 0,
"valuecolor": "#ffffbf"
},
"high": {
"data": [{
"id:": 60,
"name": "\u00c3\u0081Gua Nova",
"value:": 0.751
}, {
"id:": 109,
"name": "Alexandria",
"value:": 0.751
}, {
"id:": 124,
"name": "Almino Afonso",
"value:": 0.751
}, ...Os valores dos indicadores com nível menor que 6 são compostos por indicadores de níveis abaixo. Esse serviço retorna a composição dos valores dos indicadores com base nos níveis seguintes
- clipping: recorte do mapa. Alternativas: "semiárido", "SE", "PE", "MG", "CE", "BA", "PI", "AL", "PB", "RN", "MA"
- resolution: resolução do mapa. Alternativas: "microrregiao", "mesorregiao", "municipio", "estado"
- indicator_id: id do indicador a ser exibido
- scenario_id: 1 (Otimista), 2 (Pessimista) ou null quando o indicador não tiver essa cenários.
- resolution_id: id do objeto a ser exibido, conforme a resolução (county_id para a resolução município, microregion_id para a resolução microrregiao, macroregion_id para a resolução macrorregiao e state para a resolução estado).
curl -i http://127.0.0.1:5000/sismoi/getInfo/clipping=CE,resolution=mesorregiao,indicator_id=1,scenario_id=null,resolution_id=10
json contendo registros pesquisados.
O json é hierárquico, ou seja, existe uma estrutura de árvore entre os registros:
- nextlevel ou lastlevel indica se a estrutura contém somente o próximo nível de indicador ou se contém todos eles.
- id é o id do indicador.
- pessimist: se igual a 0, o indicador é "bom" quando o valor é alto, se igual a 1, quanto maior o valor do indicador pior é.
- title título do indicador.
- value fração do indicador que compõe o indicador pesquisado. A soma em nextlevel é igual a 1.
Sobre a ordenação dos dados, ver tópico Sobre a ordenação dos valores acima.
{
"nextlevel": [{
"id": 49,
"pessimist": 0,
"title": "Planos de Conting\u00eancia - Desastres ambientais",
"year": 2008,
"value": 1.0
}, {
"id": 50,
"pessimist": 0,
"title": "Cidades Resilientes",
"year": 2010,
"value": 1.0
}],
"lastlevel": [{
"id": 51,
"pessimist": 0,
"title": "Monitoramento e Prioridade Federal",
"year": 2015,
"value": 42.0
}, {
"id": 50,
"pessimist": 0,
"title": "Cidades Resilientes",
"year": 2015,
"value": 33.0
}, {
"id": 49,
"pessimist": 0,
"title": "Planos de Conting\u00eancia - Desastres ambientais",
"year": 2015,
"value": 25.0
}, {
"id": 52,
"pessimist": 0,
"title": "Planos de Gerenciamento de Recursos H\u00eddricos",
"year": 2015,
"value": 0.0
}]
}}Retorna os dados referentes a um determinado indicador.
- indicator_id: id do indicador a ser exibido
curl -i http://127.0.0.1:5000/sismoi/getIndicatorData/indicator_id=1
json contendo registros pesquisados.
O json é hierárquico, ou seja, existe uma estrutura de árvore entre os registros:
- complete_description: descrição completa do indicador.
- equation: equação de ponderação do valor do indicador (null, por enquanto).
- id: id do indicador.
- level: nível do indicador.
- name: nome do indicador.
- shorname: sigla do indicador, a ser usado na equação de ponderação (null por enquanto).
- simple_description: descrição simples do indicador.
- title: título do indicador.
- years: lista de anos em que o indicador ocorre, separados por vírgula.
- pessimist: se igual a 0, o indicador é "bom" quando o valor é alto, se igual a 1, quanto maior o valor do indicador pior é.
[{
"id": 2,
"name": "Seca",
"title": "\u00cdndice de Impacto para a Seca",
"shortname": null,
"simple_description": "Impacto das mudan\u00e7as clim\u00e1ticas em sistemas naturais e humanos, considerando a perturba\u00e7\u00e3o clim\u00e1tica de seca",
"complete_description": "Impacto das mudan\u00e7as clim\u00e1ticas em sistemas naturais e humanos, resultante da intera\u00e7\u00e3o entre os eventos clim\u00e1ticos relacionados \u00e0 seca, vulnerabilidade e de exposi\u00e7\u00e3o da sociedade ou sistema.<br><br>Fonte:<br> Sistema Brasileiro de Monitoramento e Observa\u00e7\u00e3o de Impactos da Mudan\u00e7a Clim\u00e1tica - SISMOI",
"equation": null,
"level": 2,
"pessimist": 1,
"years": "2015,2030,2050"
}]