
{"swagger":"2.0","info":{"title":"SATVeg","description":"A API SATVeg é derivada do Sistema de Análise Temporal da Vegetação (SATVeg), uma ferramenta web desenvolvida pela Embrapa Informática Agropecuária, destinada à geração e visualização de perfis temporais dos índices vegetativos NDVI e EVI para o Brasil e toda a América do Sul, com o objetivo de apoiar atividades de gestão territorial e monitoramento agrícola e ambiental. Os índices vegetativos são gerados a partir de imagens multiespectrais fornecidas pelo sensor MODIS, a bordo dos satélites Terra e Aqua, da Nasa, contemplando dados produzidos a partir de 2000 até a última data então disponibilizada por seu repositório oficial, com resolução temporal de 16 dias e resolução espacial de 250 metros.","version":"v1"},"host":"api.cnptia.embrapa.br","schemes":["https","http"],"basePath":"/satveg/v1","produces":["application/json"],"paths":{"/health":{"get":{"summary":"Verifica o status de funcionamento da API.","description":"Verifica o status de funcionamento da API.","tags":["Geral"],"responses":{"204":{"description":"No Content."}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/series":{"get":{"summary":"Retorna uma série temporal EVI ou NDVI.","description":"Retorna uma lista de valores que representa a série temporal EVI ou NDVI de um ponto com as respectivas datas.","tags":["Serie"],"parameters":[{"name":"tipoPerfil","in":"query","description":"Tipo de índice a ser utilizado (ndvi ou evi). Domínio: ndvi ou evi.","type":"string","required":true},{"name":"longitude","in":"query","description":"Longitude decimal do ponto no sistema de referência EPSG 4326.","type":"number","format":"double","required":true},{"name":"latitude","in":"query","description":"Latitude decimal do ponto no sistema de referência EPSG 4326.","type":"number","format":"double","required":true},{"name":"satelite","in":"query","description":"Tipo de satélite a ser utilizado (terra, aqua ou comb). Domínimo: terra, aqua ou comb.","type":"string","required":true},{"name":"preFiltro","in":"query","description":"Tipo de pré-filtro a ser utilizado. Domínio: 0 = sem pre-filtragem, 1 = correção nodata, 2 = correção nuvem, 3 = correção nuvem/nodata.","type":"integer","format":"int32","required":false},{"name":"filtro","in":"query","description":"Tipo de filtro a ser utilizado. Domínio: flt = Filtro FlatBottom, wav = Filtro Wavelet, sav = Filtro Savitsky Golay.","type":"string","required":false},{"name":"parametroFiltro","in":"query","description":"Parâmetro do filtro a ser utilizado. Este parâmetro é obrigatório para todos os filtros, exceto do tipo wav. Domínio: 0, 10, 20 ou 30 para o filtro FlatBottom;  2, 3, 4, 5 ou 6 para o filtro Savitsky Golay.","type":"string","required":false}],"responses":{"200":{"description":"Retorna a série contendo a  lista de valores EVI ou NDVI e a lista de datas de acordo com os parâmetros.","schema":{"$ref":"#/definitions/Serie"},"examples":{"Exemplo 1":{"listaSerie":[0.4622,0.4549,0.4414,0.422,0.392,0.3622],"listaDatas":["2000-02-18T00:00:00.000Z","2000-03-05T00:00:00.000Z","2000-03-21T00:00:00.000Z","2000-04-06T00:00:00.000Z","2000-04-22T00:00:00.000Z","2000-05-08T00:00:00.000Z"]}}},"400":{"description":"Requisição não pode ser processada por motivo de validação de atributos.","schema":{"$ref":"#/definitions/Error"},"examples":{"Exemplo 2":{"error":{"status":400,"summary":"Requisição não pode ser processada.","description":"Requisição não pode ser processada por motivo de validação de atributos.","fieldErros":[{"field":"tipoPerfil","summary":"Tipo de perfil inválido.","description":"Tipo de perfil inválido. Utilize apenas evi ou ndvi."},{"field":"longitude","summary":"Coordenada inválida.","description":"Coordenada inválida. Utilize coordenadas no formato graus decimais, nos limites da América do sul."},{"field":"latitude","summary":"Coordenada inválida.","description":"Coordenada inválida. Utilize coordenadas no formato graus decimais, nos limites da América do sul."},{"field":"satelite","summary":"Satélite inválido.","description":"Satélite inválido. Utilize apenas terra, aqua ou comb."},{"field":"preFiltro","summary":"Pré-Filtro inválido.","description":"Pré-Filtro inválido. Utilize apenas 0, 1, 2, 3 onde 0=sem filtro, 1=nodata, 2=nuvem, 3=nodata+nuvem."},{"field":"filtro","summary":"Filtro inválido.","description":"Filtro inválido. Utilize apenas flt, wav ou sav"},{"field":"parametroFiltro.","summary":"Parâmetro inválido para o filtro..","description":"Parâmetro inválido para o filtro. Utilize apenas 0, 10, 20 ou 30 para o filtro flt; 2, 3, 4, 5 ou 6 para o filtro sav; e nenhum valor para o filtro wav."}]}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/seriespoligono":{"get":{"summary":"Retorna uma série temporal média EVI ou NDVI de um polígono.","description":"Retorna uma lista de valores que representa a série temporal média EVI ou NDVI de um polígono com as respectivas datas.","tags":["SeriePoligono"],"parameters":[{"name":"tipoPerfil","in":"query","description":"Tipo de índice a ser utilizado (ndvi ou evi). Domínio: ndvi ou evi.","type":"string","required":true},{"name":"poligono","in":"query","description":"Pontos que compõem o polígono separados por vírgula (\",\") e coordenadas latitude e longitude de cada ponto separadas por espaço (\" \"), sendo que o último ponto deve ser igual ao primeiro, no sistema de referência EPSG 4326.","type":"string","format":"double","required":true},{"name":"satelite","in":"query","description":"Tipo de satélite a ser utilizado (terra, aqua ou comb). Domínimo: terra, aqua ou comb.","type":"string","required":true},{"name":"preFiltro","in":"query","description":"Tipo de pré-filtro a ser utilizado. Domínio: 0 = sem pre-filtragem, 1 = correção nodata, 2 = correção nuvem, 3 = correção nuvem/nodata.","type":"integer","format":"int32","required":false},{"name":"filtro","in":"query","description":"Tipo de filtro a ser utilizado. Domínio: flt = Filtro FlatBottom, wav = Filtro Wavelet, sav = Filtro Savitsky Golay.","type":"string","required":false},{"name":"parametroFiltro","in":"query","description":"Parâmetro do filtro a ser utilizado. Este parâmetro é obrigatório para todos os filtros, exceto do tipo wav. Domínio: 0, 10, 20 ou 30 para o filtro FlatBottom;  2, 3, 4, 5 ou 6 para o filtro Savitsky Golay.","type":"string","required":false}],"responses":{"200":{"description":"Retorna a série contendo a lista de valores EVI ou NDVI médios e a lista de datas de acordo com os parâmetros.","schema":{"$ref":"#/definitions/Serie"},"examples":{"Exemplo 1":{"listaSerie":[0.4622,0.4549,0.4414,0.422,0.392,0.3622],"listaDatas":["2000-02-18T00:00:00.000Z","2000-03-05T00:00:00.000Z","2000-03-21T00:00:00.000Z","2000-04-06T00:00:00.000Z","2000-04-22T00:00:00.000Z","2000-05-08T00:00:00.000Z"]}}},"400":{"description":"Requisição não pode ser processada por motivo de validação de atributos.","schema":{"$ref":"#/definitions/Error"},"examples":{"Exemplo 2":{"error":{"status":400,"summary":"Requisição não pode ser processada.","description":"Requisição não pode ser processada por motivo de validação de atributos.","fieldErros":[{"field":"tipoPerfil","summary":"Tipo de perfil inválido.","description":"Tipo de perfil inválido. Utilize apenas evi ou ndvi."},{"field":"poligono","summary":"Polígono inválido.","description":"Utilize polígono composto por pontos com coordenadas em graus decimais, nos limites da América do sul."},{"field":"satelite","summary":"Satélite inválido.","description":"Satélite inválido. Utilize apenas terra, aqua ou comb."},{"field":"preFiltro","summary":"Pré-Filtro inválido.","description":"Pré-Filtro inválido. Utilize apenas 0, 1, 2, 3 onde 0=sem filtro, 1=nodata, 2=nuvem, 3=nodata+nuvem."},{"field":"filtro","summary":"Filtro inválido.","description":"Filtro inválido. Utilize apenas flt, wav ou sav"},{"field":"parametroFiltro.","summary":"Parâmetro inválido para o filtro..","description":"Parâmetro inválido para o filtro. Utilize apenas 0, 10, 20 ou 30 para o filtro flt; 2, 3, 4, 5 ou 6 para o filtro sav; e nenhum valor para o filtro wav."}]}}}}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}}},"definitions":{"Error":{"type":"object","properties":{"status":{"type":"integer","description":"O código do status de erro"},"summary":{"type":"string","description":"Descrição curta do erro"},"description":{"type":"string","description":"Descrição longa do erro"},"fieldErrors":{"type":"array","items":{"$ref":"#/definitions/FieldErrors"}}}},"FieldErrors":{"type":"object","properties":{"field":{"type":"string","description":"Nome do atributo que ocorreu o erro de validação"},"summary":{"type":"string","description":"Descrição curta do erro"},"description":{"type":"string","description":"Descrição longa do erro"}}},"Serie":{"type":"object","properties":{"listaSerie":{"type":"array","description":"Serie temporal do MODIS considerando os filtros selecionados.","items":{"type":"number","format":"double","description":"Séries temporais do MODIS."}},"listaDatas":{"type":"array","description":"Sequência de datas correspondentes à série temporal solicitada.","items":{"type":"string","description":"Datas correspondentes à série temporal solicitada no formato yyyy-MM-dd."}}}}},"securityDefinitions":{"default":{"type":"oauth2","authorizationUrl":"https://api.cnptia.embrapa.br/authorize","flow":"implicit","scopes":{}}}}