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

Nombre	Descripció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.

Nombre	Descripción	Tipo 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 &.

Nombre	Descripción	Tipo 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.