Consulta ao histórico e gráficos de tendência

Escolha o método conforme a finalidade: poucos dados brutos detalhados para diagnóstico, tendências agrupadas por intervalos para observar mudanças e exportação assíncrona para grandes volumes.

Métodos de consulta

Necessidade	Método	Descrição
Consultar amostras originais	Histórico detalhado	Consulta paginada por ponto e período
Comparar tendências	Consulta para gráficos	Seleciona automaticamente intervalos de agrupamento e limita o número de pontos retornados
Personalizar estatísticas	Consulta agregada	Define separadamente o método estatístico e a granularidade temporal de vários pontos
Salvar grande volume de dados detalhados	Exportação do histórico	Gera CSV ou ZIP em segundo plano

Os históricos de aquisição, agregação e compartilhamento podem ser usados na análise de tendências. Para pontos compartilhados, informe o código do dispositivo e o dataKey para não misturar pontos de mesmo nome de dispositivos diferentes.

Como os gráficos de tendência processam os dados

• A granularidade pode ser selecionada automaticamente ou definida manualmente por unidade e intervalo de tempo.
• Há estatísticas de média, máximo, mínimo, contagem, primeiro valor e último valor, selecionadas conforme o tipo de dado.
• Os intervalos são alinhados pelo fuso horário especificado, facilitando comparações diárias ou horárias.
• Intervalos sem amostras permanecem nulos; o gráfico deve mostrar lacunas, sem representá-los como zero.
• Dados não numéricos não são adequados ao cálculo de média; use contagem, primeiro ou último valor. A interface retorna avisos sobre os dados, que devem ser exibidos junto ao gráfico.

Para energia acumulada, analise a diferença entre o primeiro e o último valor e possíveis resets do medidor; não some diretamente leituras acumuladas.

Exemplo de interface

POST /ems-data/chart/query, incluindo o token de login no cabeçalho da solicitação:

{
  "series": [{"dataKey": "demo_temperature", "statistics": ["AVG", "MAX"]}],
  "startTime": "2026-10-01T00:00:00+08:00",
  "endTime": "2026-10-02T00:00:00+08:00",
  "bucketMode": "AUTO",
  "targetPoints": 200,
  "timezone": "Asia/Shanghai"
}

O campo series[].statistics do resultado contém cada curva estatística, junto com o intervalo de agrupamento efetivamente usado e warnings. Substitua os pontos de exemplo por pontos reais do dispositivo.

O histórico detalhado usa POST /ems-data/history; a agregação personalizada usa POST /ems-data/aggregate/query. Esta retorna resultados de sucesso ou falha separadamente por data.items[] e não deve ser tratada como se tivesse a mesma estrutura de retorno da interface de gráficos.

Também é possível consultar e analisar pela Skill de gráficos históricos. Para preservar dados por longo prazo, configure o Arquivamento periódico.