Main Content

Esta página se ha traducido mediante traducción automática. Haga clic aquí para ver la versión original en inglés.

Crear gráfico

Generar gráfico con HTTP GET

Pedido

Método HTTP

GET

URL

https://api.thingspeak.com/channels/<channel_id>/charts/<field_id>

Parámetros de URL

NombreDescripción

<channel_id>

(Obligatorio) ID de canal para el canal de interés.

<field_id>

(Obligatorio) ID de campo para el campo de interés.

Ejemplo: https://api.thingspeak.com/channels/99990/charts/2

Parámetros de cadena de consulta de gráfico

Utilice estos parámetros para ajustar las propiedades del gráfico. Utilice ? para agregar el primer parámetro y & para los parámetros posteriores.

NombreDescripciónTipo de valor
title

(Opcional) Título del gráfico. El valor predeterminado es el nombre del canal.

cadena

xaxis

(Opcional) Etiqueta del eje x del gráfico. El valor predeterminado es "Fecha".

cadena

yaxis

(Opcional) Etiqueta del eje y del gráfico. El valor predeterminado es el nombre del campo.

cadena

color

(Opcional) Valor hexadecimal para el color de línea. El valor predeterminado es FF000 (rojo).

cadena

bgcolor

(Opcional) Color de fondo. El valor predeterminado es el blanco.

cadena

type

(Opcional) Tipo de gráfico. El valor predeterminado es línea.

line, bar, column, spline

width

(Opcional) Ancho del gráfico en píxeles, el ancho del iframe es 20 px más grande, ancho predeterminado del gráfico: 400. Establezca en auto para ajustar automáticamente el tamaño del gráfico según su contenedor principal.

entero

height

(Opcional) Altura del gráfico en píxeles, la altura del iframe es 20 px más grande, altura predeterminada del gráfico: 200. Establezca en auto para ajustar automáticamente el tamaño del gráfico según su contenedor principal.

entero

dynamic

(Opcional) Realice la actualización del gráfico automáticamente según el intervalo de tiempo mencionado en la actualización. El valor predeterminado es falso.

true o false

step(Opcional) Dibuje un gráfico como un gráfico de pasos. El valor predeterminado es falso.

true o false

yaxismin(Opcional) Valor mínimo del eje Y del gráfico. Si está en blanco, el valor se calcula automáticamente.decimal
yaxismax(Opcional) Valor máximo del eje Y del gráfico. Si está en blanco, el valor se calcula automáticamente.decimal
update(Opcional) Intervalo de tiempo en segundos para actualizar el gráfico automáticamente. El valor predeterminado es 15.entero

Parámetros de cadena de consulta de alimentación

Utilice estos parámetros para ajustar las propiedades de los datos del canal utilizados para generar el gráfico. Si no hay parámetros anteriores, use ? para agregar el primer parámetro y & para los parámetros posteriores. De lo contrario, agregue todos los parámetros con &.

NombreDescripciónTipo de valor
api_key

(Obligatorio para canales privados) Especifique Leer clave API para este canal específico. La lectura de clave API está disponible en la pestaña Claves API de la vista del canal.

cadena

results

(Opcional) Número de entradas para recuperar. El número máximo es 8000. El valor predeterminado es 100.

entero

days

(Opcional) Número de períodos de 24 horas anteriores a ahora para incluirlos en el feed.

entero

start

(Opcional) Fecha de inicio en formato AAAA-MM-DD%20HH:NN:SS.

fecha y hora

end

(Opcional) Fecha de finalización en formato AAAA-MM-DD%20HH:NN:SS.

fecha y hora

offset

(Opcional) Desplazamiento de zona horaria utilizado para mostrar resultados. Utilice el parámetro de zona horaria para mayor precisión.

entero

min

(Opcional) Valor mínimo para incluir en la respuesta.

decimal

max

(Opcional) Valor máximo para incluir en la respuesta.

decimal

round

(Opcional) Redondea a esta cantidad de decimales.

entero

timescale(Opcional). Obtenga el primer valor en tantos minutos. Los valores válidos son: 10, 15, 20, 30, 60, 240, 720, 1440, "diario".integer or string
sum(Opcional). Obtenga la suma de tantos minutos. Los valores válidos son: 10, 15, 20, 30, 60, 240, 720, 1440, "diario".integer or string
average(Opcional) Obtenga el promedio de esta cantidad de minutos. Los valores válidos son 10, 15, 20, 30, 60, 240, 720, 1440, "diario". Nota: Los valores NaN se interpretan como 0 al calcular el promedio.entero o cadena
median(Opcional) Obtenga la mediana de esta cantidad de minutos. Los valores válidos son: 10, 15, 20, 30, 60, 240, 720, 1440, "diario"integer or string

Respuesta

Éxito

Código de estado HTTP

200 OK

Cuerpo

La respuesta es un gráfico de ThingSpeak.

Error

Para obtener la lista completa, consulte Códigos de error.

Ejemplos

Puede utilizar su navegador web para completar solicitudes GET HTTP a la API RESTful ThingSpeak™ . Para ver el formato de una respuesta HTTP, haga clic en el enlace o cópielo en su navegador.

Modificar los parámetros de visualización del gráfico

Puede modificar las propiedades de visualización del gráfico utilizando los parámetros establecidos en la solicitud de API. Utilice title para agregar un título personalizado, color para cambiar el color de la línea y width para especificar un ancho personalizado para el gráfico en píxeles. Cree un gráfico utilizando este HTTP GET:

https://api.thingspeak.com/channels/276330/charts/7?title=Soil%20Moisture&color=FF69B4&width=850&xaxis=Time

La respuesta es chart que muestra la medición de la humedad del suelo con una línea rosa y un título personalizado y una vista amplia. Los datos provienen de una publicación de soil moisture monitor en ThingSpeak Channel 276330.

Modificar datos del gráfico

Puede modificar los datos utilizados para generar un gráfico personalizado. Utilice el parámetro average para promediar una cantidad determinada de minutos, days para seleccionar una cantidad de días de datos, hasta 8000 puntos, y min para mostrar datos mayores que un valor mínimo determinado. Cree un gráfico utilizando este HTTP GET:

https://api.thingspeak.com/channels/276330/charts/1?average=240&days=7&min=200

La respuesta es chart que muestra los valores promedio de humedad del suelo durante una ventana de 240 minutos durante cuatro días, excluyendo cualquier punto con un valor inferior a 200. Los datos provienen de una publicación de soil moisture monitor en ThingSpeak Channel 276330. El ejemplo aquí será diferente de lo que ve ya que los datos son dinámicos.

Crear gráfico con parámetros de gráfico y feed

Puede utilizar parámetros de gráfico y feed para crear un gráfico con las propiedades deseadas. Utilice title, xaxis, color, type, width, height, average, yaxismax y dynamic para crear un gráfico personalizado. Cree un gráfico utilizando este HTTP GET:

https://api.thingspeak.com/channels/38629/charts/2?title=Route%209%20Traffic&xaxis=Time&yaxis=Density%20of%20Eastbound%20Cars&color=0000FF&type=column&average=10&width=500&height=500&yaxismax=10&dynamic=true

La respuesta es chart que muestra los valores promedio de temperatura exterior durante una ventana de 10 minutos utilizando los datos de temperatura del campo 2 de ThingSpeak Channel 9.