Clima
Domínio responsável pela ingestão de dados meteorológicos de estações de campo: precipitação, temperatura, umidade, radiação e vento.
Endpoint
POST /v1/integrations/{partnerId}/clima
Autenticação: Authorization: Bearer {token} com role climate.write
Campos
Obrigatórios
| Campo | Tipo | Descrição |
|---|---|---|
idUsina |
number |
Identificador da Usina |
cdSafra |
string |
Safra agrícola (ex: "2023/2024") |
cdSetor |
string |
Código do Setor |
cdBloco |
string |
Código do Bloco |
cdFazenda |
string |
Código da Fazenda |
dtDataClima |
string |
Data/horário da estação — formato YYYY/MM/DD |
nrLatitudeEstacao |
number |
Latitude da estação (graus decimais) |
nrLongitudeEstacao |
number |
Longitude da estação (graus decimais) |
nrPrecipitacao |
number |
Precipitação média diária (mm) |
nrTemperaturaMinima |
number |
Temperatura mínima diária (°C) |
nrTemperaturaMaxima |
number |
Temperatura máxima diária (°C) |
nrTemperaturaMedia |
number |
Temperatura média diária (°C) |
nrUmidadeMinima |
number |
Umidade relativa mínima (%) |
nrUmidadeMaxima |
number |
Umidade relativa máxima (%) |
nrRadiacao |
number |
Radiação solar média (MJ/m²) |
nrVelocidadeVento |
number |
Velocidade do vento (m/s) |
Formato de data diferente
dtDataClima usa o formato YYYY/MM/DD com barras — diferente dos demais domínios
que usam YYYY-MM-DD com hífens.
Exemplo de payload
[
{
"idUsina": 1,
"cdSafra": "2023/2024",
"cdSetor": "SETOR01",
"cdBloco": "BLOCO01",
"cdFazenda": "FAZ001",
"dtDataClima": "2024/01/15",
"nrLatitudeEstacao": -22.9035,
"nrLongitudeEstacao": -47.0628,
"nrPrecipitacao": 45.2,
"nrTemperaturaMinima": 18.5,
"nrTemperaturaMaxima": 32.1,
"nrTemperaturaMedia": 25.3,
"nrUmidadeMinima": 55,
"nrUmidadeMaxima": 90,
"nrRadiacao": 18.4,
"nrVelocidadeVento": 12.5
}
]