Perguntas
Frequentes
Encontre respostas para suas dúvidas
Callback de Items
SUMÁRIO​
​
1- Visão Geral
O Callback de Items é responsável por entregar os resultados das análises agronômicas e climáticas processadas para cada talhão/gleba. Diferente do callback de validações (que foca em regras de negócio), este callback foca em dados técnicos e científicos (ex: NDVI, ZARC, Climatologia).
​
O callback de Items se aplica ao Relatório de Monitoramento.
​
-
Frequência: Os dados são enviados de forma particionada (por talhão) e assíncrona, conforme o processamento é concluído.
-
Atualização: Caso um item (code) já tenha sido enviado anteriormente para um mesmo relatório (reportId), o novo envio atualizará os valores existentes no banco de dados.
-
API de Exemplo:
2 - Estrutura do Payload
O payload principal contém a identificação da requisição e uma lista de items. Cada item possui um código identificador, arquivos (mapas/gráficos) e dados tabulares.
​
Exemplo de Payload Completo:
​
JSON
​
{
"reportRequestId": 12345,
"reportId": 100,
"createdAt": "2024-06-13 13:00:00",
"items": [
{
"code":"DENSE_VEGETATION",
"files":[
{ "code": "GEOMETRY", "url": "https://storage.../items/zzzz.tiff" }
]
},
{
"code": "GROWTH_STAGE",
"data": [
{
"index": 0,
"properties":[
{ "code": "STAGE", "value": "SPROUTING" },
{ "code": "DATE", "value": "2024-01-01" }
]
}
]
}
]
}
3 - Tratamento de Itens Vazios
O sistema pode retornar itens sem dados caso a análise não tenha gerado resultados (ex: falta de imagens de satélite para o período).
-
Regra: O item sempre será retornado na lista, mesmo que vazio.
-
Formato: Os arrays files e data virão vazios.
Exemplo:
​
JSON
​
{
"code": "GROWTH_STAGE",
"data": [],
"files": []
}
4 - Catálogo de Itens Disponíveis
Abaixo estão listados todos os codes disponíveis e suas respectivas descrições e estruturas de dados.
1 DENSE_VEGETATION
​
-
CODE:
-
DENSE_VEGETATION
-
-
DESCRIPTION:
-
Análise da presença de vegetação densa sob o croqui da área.
-
-
EXAMPLE:
{
"code":"DENSE_VEGETATION",
"files":[ { "code": "DENSE_VEGETATION_GEOMETRY", "url": "https://.tiff" } ],
}
2 ELEVATION
​
-
CODE:
-
ELEVATION
-
-
DESCRIPTION:
-
Análise da topografia da área do imóvel.
-
-
EXAMPLE:
{
"code":"ELEVATION”",
"files":[
{ "code": "ELEVATION_GEOMETRY", "url": "https://.tiff" },
{ "code": "ELEVATION_GEOMETRY_IMAGE", "url": "https://.png" },
{ "code": "ELEVATION_GEOMETRY_SLOPE_IMAGE", "url": "https://.png" },
{ "code": "ELEVATION_GEOMETRY_CONTOUR_CURVES_IMAGE", "url": "https://.png" },
],
}
3 CLIMATOLOGY_DAILY
-
CODE:
-
CLIMATOLOGY_DAILY
-
-
DESCRIPTION:
-
Análise da média histórica (30 anos) das condições climáticas de chuva e temperatura da área do talhão/gleba para o período da cultura à campo.
-
O período de análise inicia-se duas semanas antes da estimativa de data de plantio e estende-se até o término do período de solicitação.As informações disponíveis para análise são:
-
DAY - Dia no período analisado no formato “ano-mês-dia”;
-
TEMPERATURE - Média história de temperatura do dia.
-
RAIN - Quantidade de chuva história do dia.
-
-
-
EXAMPLE:
{
"code":"ELEVATION”",
"files":[
{ "code": "ELEVATION_GEOMETRY", "url": "https://.tiff" },
{ "code": "ELEVATION_GEOMETRY_IMAGE", "url": "https://.png" },
{ "code": "ELEVATION_GEOMETRY_SLOPE_IMAGE", "url": "https://.png" },
{ "code": "ELEVATION_GEOMETRY_CONTOUR_CURVES_IMAGE", "url": "https://.png" },
],
}
4 CLIMATE_DAILY
​
-
CODE:
-
CLIMATE_DAILY
-
-
DESCRIPTION:
-
Chuva e Temperatura diária da safra atual da área do imóvel.
-
-
EXAMPLE:
{
"code":"CLIMATE_DAILY",
"files":[ { "code": "CLIMATE_DAILY_CHART_IMAGE", "url": "https://.png", } ,
{ "code": "CLIMATE_DAILY_CHART_IMAGE", "url": "https://.png", } ],
"data":[
{
"index": 0,
"properties":[
{
"code": "DATE",
"value": “2024-10-21”
},
{
"code": "TEMPERATURE",
"value": “22.6”
},
{
"code": "RAIN",
"value": “1.2”
},
{
"code": "MINIMUM_TEMPERATURE",
"value": “20.6”
},
{
"code": "MAXIMUM_TEMPERATURE",
"value": “22.6”
}
]
}
5 ESTIMATED_PLANTING_DATE
-
CODE:
-
ESTIMATED_PLANTING_DATE
-
-
DESCRIPTION:
-
Data estimada do plantio da área.
-
-
EXAMPLE:
{
"code":"ESTIMATED_PLANTING_DATE",
"files":[ { "code": "ESTIMATED_PLANTING_DATE_CHART_IMAGE", "url": "https://.png" } ],
"data":[
{
"index": 0,
"properties":[
{
"code": “DATE”,
"value": “2024-01-01”,
}
6 GROWTH_STAGE
-
CODE:
-
GROWTH_STAGE
-
-
DESCRIPTION:
-
Estimativa de datas de estádio fenológicos da cultura no campo. As informações disponíveis para análise são:
-
SPROUTING - Data estimada de emergência da cultura.
-
VEGETATIVE_STAGE - Data estimada do início do estádio vegetativo.
-
REPRODUCTIVE_STAGE - Data estimada do início do estádio reprodutivo.
-
MATURITY_STAGE - Data estimada do início do estádio de maturação.
-
-
-
EXAMPLE:
"code": "GROWTH_STAGE",
"data": [
{
"index": 0,
"properties":[
{
"code": "SPROUTING",
"value": "2024-01-01",
},
{
"code": "VEGETATIVE_STAGE",
"value": "2024-01-01",
},
{
"code": "REPRODUCTIVE_STAGE",
"value": "2024-01-01",
},
{
"code": "MATURITY_STAGE",
"value": "2024-01-01",
}
]
}
7 ZARC_SOIL_0_TO_5CM
-
CODE:
-
ZARC_SOIL_0_TO_5CM
-
-
DESCRIPTION:
-
Avaliação geo-espacial do tipo de solo na profundidade 0-5 cm da área.
-
-
EXAMPLE:
{
"code":"ZARC_SOIL_0_TO_5CM",
"files":[ { "code": "ZARC_SOIL_0_TO_5CM_CHART_IMAGE", "url": "https://.png" } ],
}
8 ZARC_SOIL_5_TO_15CM
-
CODE:
-
ZARC_SOIL_5_TO_15CM
-
-
DESCRIPTION:
-
Avaliação geo-espacial do tipo de solo na profundidade 5-15 cm da área.
-
-
EXAMPLE:
{
"code":"ZARC_SOIL_5_TO_15CM",
"files":[ { "code": "ZARC_SOIL_5_TO_15CMY_CHART_IMAGE", "url": "https://.png" } ],
}
9 ZARC_SOIL_15_TO_30CM
-
CODE:
-
ZARC_SOIL_15_TO_30CM
-
-
DESCRIPTION:
-
Avaliação geo-espacial do tipo de solo na profundidade 15-30 cm da área.
-
-
EXAMPLE:
{
"code":"ZARC_SOIL_15_TO_30CM",
"files":[ { "code": "ZARC_SOIL_15_TO_30CM_CHART_IMAGE", "url": "https://.png" } ],
}
10 ZARC_SOIL_30_TO_60CM
-
CODE:
-
ZARC_SOIL_30_TO_60CM
-
-
DESCRIPTION:
-
Avaliação geo-espacial do tipo de solo na profundidade de 30-60 cm da área.
-
-
EXAMPLE:
{
"code":"ZARC_SOIL_30_TO_60CM",
"files":[ { "code": "ZARC_SOIL_30_TO_60CM_CHART_IMAGE", "url": "https://.png" } ],
}
11 CROP_BIOMASS
-
CODE:
-
CROP_BIOMASS
-
-
DESCRIPTION:
-
Evolução da biomassa da safra vigente em comparação com a média histórica e a curva ideal de desenvolvimento da cultura para aquela região.
-
-
EXAMPLE:
{
"code": "CROP_BIOMASS",
"files": [
{
"code": "CROP_BIOMASS_IMAGE",
"url": "Testeitems/ITEMS_CROP_BIOMASS.png"
}
],
"data": [
{
"index": 0,
"properties": [
{
"code": "DAY",
"value": "2025-03-01"
},
{
"code": "NDVI_DAILY",
"value": 0.3
}
]
},
{
"index": 1,
"properties": [
{
"code": "DAY",
"value": "2025-03-02"
},
{
"code": "NDVI_DAILY",
"value": 0.31
}
]
},
{
"index": 2,
"properties": [
{
"code": "DAY",
"value": "2025-03-03"
},
{
"code": "NDVI_DAILY",
"value": 0.32
}
]
}
]
}
12 PREVIOUS_FROST
-
CODE:
-
PREVIOUS_FROST
-
-
DESCRIPTION:
-
Histórico da previsão de geada divido por mês, ano e intensidade de até 5 (cinco) anos para trás. As informações disponíveis são:
-
YEAR - Ano do dado
-
MONTH - Mês do dado
-
INTENSITY - Intensidade.
-
Sem geada (valor: 0) > 5°C
-
Geada Fraca (valor: 1) entre 3°C e 5°C
-
Geada moderada (valor: 3) entre 0°C e 3°C
-
Geada forte (valor: 6) entre -3°C e 0°C
-
Geada muito forte (valor: 10) abaixo de -3°C
-
-
DAYS - Quantidade de dias.
-
-
-
EXAMPLE:
{
"code": "PREVIOUS_FROST",
"data": [
{
"index": 0,
"properties":[
{
"code": "YEAR",
"value": "2018"
},
{
"code": "MONTH",
"value": "5"
},
{
"code": "INTENSITY",
"value": "1"
},
{
"code": "DAYS",
"value": "3"
}
}
]
}
13 PREVIOUS_HAIL
-
CODE:
-
PREVIOUS_HAIL
-
-
DESCRIPTION:
-
Histórico da previsão de granizo divido por mês, ano e intensidade de até 5 (cinco) anos para trás. As informações disponíveis são:
-
YEAR - Ano do dado
-
MONTH - Mês do dado
-
INTENSITY - Intensidade.
-
2 = Moderada
-
3 = Forte
-
-
DAYS - Quantidade de dias.
-
-
-
EXAMPLE:
{
"code": "PREVIOUS_HAIL",
"data": [
{
"index": 0,
"properties":[
{
"code": "YEAR",
"value": "2019"
},
{
"code": "MONTH",
"value": "1"
},
{
"code": "INTENSITY",
"value": "3"
},
{
"code": "DAYS",
"value": "1"
}
}
]
}
14 FROST_FORECAST
-
CODE:
-
FROST_FORECAST
-
-
DESCRIPTION:
-
Histórico da previsão de até 5 (cinco) dias no futuro a partir da data da requisição de geada dividido por data. As informações disponíveis são:
-
YEAR - Ano do dado
-
MONTH - Mês do dado
-
INTENSITY - Intensidade.
-
Sem geada (valor: 0) > 5°C
-
Geada Fraca (valor: 1) entre 3°C e 5°C
-
Geada moderada (valor: 3) entre 0°C e 3°C
-
Geada forte (valor: 6) entre -3°C e 0°C
-
Geada muito forte (valor: 10) abaixo de -3°C
-
-
DAYS - Quantidade de dias.
-
-
-
EXAMPLE:
{
"code": "FROST_FORECAST",
"data": [
{
"index": 0,
"properties":[
{
"code": "YEAR",
"value": "2018"
},
{
"code": "MONTH",
"value": "5"
},
{
"code": "INTENSITY",
"value": "1"
},
{
"code": "DAYS",
"value": "3"
}
}
]
}
15 HAIL_FORECAST
-
CODE:
-
HAIL_FORECAST
-
-
DESCRIPTION:
-
Histórico da previsão de até 5 (cinco) dias no futuro a partir da data da requisição de granizo dividido por data. As informações disponíveis são:
-
YEAR - Ano do dado
-
MONTH - Mês do dado
-
INTENSITY - Intensidade.
-
2 = Moderada
-
3 = Forte
-
-
DAYS - Quantidade de dias.
-
-
-
EXAMPLE:
{
"code": "HAIL_FORECAST",
"data": [
{
"index": 0,
"properties":[
{
"code": "YEAR",
"value": "2019"
},
{
"code": "MONTH",
"value": "1"
},
{
"code": "INTENSITY",
"value": "3"
},
{
"code": "DAYS",
"value": "1"
}
}
]
}
16 RURAL_ENVIRONMENTAL_REGISTRY
-
CODE:
-
RURAL_ENVIRONMENTAL_REGISTRY
-
-
DESCRIPTION:
-
Cadastro Ambiental Rural (CAR)
-
CODE- Código do CAR;
-
FIELD_PERCENTAGE- Porcentagem em que a área se encontra sobre o CAR.
-
-
-
EXAMPLE:
{
"code": "RURAL_ENVIRONMENTAL_REGISTRY",
"data": [
{
"index": 0,
"properties":[
{
"code": "CODE",
"value": "PR-4104303-49616F11377B442A854C39FB4F8D91F4"
},
{
"code": "FIELD_PERCENTAGE",
"value": 99.8
},
]
}
17 CITY_TYPOLOGY
-
CODE:
-
CITY_TYPOLOGY
-
-
DESCRIPTION:
-
Tipologia do município (Fonte: MMA).
-
COUNTRY_CODE - Código do país;
-
STATE_CODE - Código do estado federativo;
-
CITY_CODE- Código da cidade;
-
MICROREGION - Microrregião;
-
SUBREGIONAL_TYPOLOGY: Tipologia sub regional;
-
TYPOLOGY: Tipologia do município.
-
-
-
EXAMPLE:
{
"code": "CITY_TYPOLOGY",
"data": [
{
"index": 0,
"properties":[
{
"code": "COUNTRY_CODE",
"value": "BR"
},
{
"code": "STATE_CODE",
"value": "PR"
},
{
"code": "CITY_CODE",
"value": "4104303"
},
{
"code": "CITY_NAME",
"value": "Campo Mourão"
}
"code": "MICROREGION",
"value": "Campo Mourão"
},
{
"code": "SUBREGIONAL_TYPOLOGY",
"value": "Alta Renda e Médio Dinamismo"
},
{
"code": "TYPOLOGY",
"value": "Alta Renda"
}
]
}
]
}
18 HISTORICAL_NDVI
-
CODE:
-
HISTORICAL_NDVI
-
-
DESCRIPTION:
-
Evolução do Índice de Vegetação (NDVI) dos últimos 5 anos.
-
-
EXAMPLE:
{
"code": "HISTORICAL_NDVI",
"files": [
{
"code": "HISTORICAL_NDVI",
"url": "/validation/report/created_at/3648/1/items/ITEMS_HISTORICAL_NDVI.png"
}
],
"data": [
{
"index": 0,
"properties": [
{
"code": "DAY",
"value": "2019-01-01"
},
{
"code": "HISTORICAL_NDVI_DAILY",
"value": 0.56
}
]
},
{
"index": 1,
"properties": [
{
"code": "DAY",
"value": "2019-01-02"
},
{
"code": "HISTORICAL_NDVI_DAILY",
"value": 0.55
}
]
},
{
"index": 2,
"properties": [
{
"code": "DAY",
"value": "2019-01-03"
},
{
"code": "HISTORICAL_NDVI_DAILY",
"value": 0.54
}
]
}
]
}
19 ZARC_TABLE
-
CODE:
-
ZARC_TABLE
-
-
DESCRIPTION:
-
Retorna a Tabela ZARC com a janela de plantio da cultura em decêndios, pelo tipo de Solo e Grupos, sendo o risco classificado como:
-
-
EXAMPLE:
{
"code": "ZARC_TABLE",
"files": [
{
"code": "ZARC_TABLE_IMAGE",
"url": "/prod/report/2024-11-26_13:36:44/3301/1/items/ZARC_TABLE.png"
}
],
"data": [
{
"index": 0,
"properties": [
{
"code": "10-DAY_PERIODS",
"value": "[{\"period\":\"2024-09-01\",\"value\":\"40\"},{\"period\":\"2024-09-11\",\"value\":\"30\"},{\"period\":\"2024-09-21\",\"value\":\"30\"}]"
},
{
"code": "ZARC_SOIL_TYPE",
"value": "ADI"
},
{
"code": "ZARC_GROUP",
"value": "I"
}
]
}
]
}
20 TRACKING_NDVI
-
CODE:
-
TRACKING_NDVI
-
-
DESCRIPTION:
-
Monitoramento da vegetação da área analisada com base no índice de vegetação NDVI (Normalized Difference Vegetation Index), com destaque para o comportamento ao longo da safra.
-
O item retorna uma imagem do histórico de NDVI da propriedade e, no contexto, exibe a data estimada e a data reportada de plantio, utilizadas como referência visual para interpretar a curva NDVI.
-
EXAMPLE:
{
"code": "TRACKING_NDVI",
"data": [
{
"index": "0",
“files”: [ { “code”: “TRACKING_NDVI_IMAGE”, “url”: “https://dd.mm.yyyy.png” }, { “code”: “TRACKING_RGB_IMAGE”, “url”: “https://dd.mm.yyyy.png” } ],
"properties": [
{
"code": "DATE",
"value": "2024-10-21"
}
]
}
]
}
21 LOCATION_OVERLAP
-
CODE:
-
LOCATION_OVERLAP
-
-
DESCRIPTION:
Listagem de municípios que possuem intersecção com área do talhão ou CAR
-
EXAMPLE:
{
"code": "LOCATION_OVERLAP",
"data": [
{
"index": "0",
"files":
[
{ "code": "STATE_GEOMETRY_IMAGE", "url": "https://.png" },
{ "code": "CITY_GEOMETRY_IMAGE", "url": "https://.png" }
],
"properties": [
{
"code": "COUNTRY_CODE",
"value": "BR"
},
{
"code": "STATE_CODE",
"value": "PR"
},
{
"code": "CITY_CODE",
"value": "4104303"
},
{
"code": "CITY_NAME",
"value": "Campo Mourão"
},
{
“code”: “INTERSECTION_PERCENTAGE”,
“value”: “100”
}
]
}
]
}
