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

Solicitud

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. Usar ? para añadir 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 la línea. El valor predeterminado es FF000 (rojo).	cadena
`bgcolor`	(Opcional) Color de fondo. El valor predeterminado es 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 del gráfico predeterminado: 400. Ajustado a auto para ajustar automáticamente el tamaño del gráfico en función de su contenedor principal.	entero
`height`	(Opcional) Altura del gráfico en píxeles, la altura del iframe es 20 px más grande, altura del gráfico predeterminada: 200. Ajustado a auto para ajustar automáticamente el tamaño del gráfico en función de 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 fuente

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, utilice ? para añadir 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 la clave API de lectura para este canal específico. La clave de API de lectura está disponible en la pestaña Claves de API de la vista del canal.	cadena
`results`	(Opcional) Número de entradas a recuperar. El número máximo es 8000. El valor predeterminado es 100.	entero
`days`	(Opcional) Número de períodos de 24 horas antes de ahora para incluir 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) Compensación de zona horaria utilizada para mostrar resultados. Utilice el parámetro de zona horaria para una 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) Redondee 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: `NaN` Los valores 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 usar su navegador web para completar solicitudes GET HTTP al ThingSpeak™ API REST. 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 la API. Usar title para agregar un título personalizado, color para cambiar el color de la línea, y width para especificar un ancho personalizado para la gráfica en píxeles. Cree un gráfico usando este HTTP GET:

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

La respuesta es un cuadro 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 son de un monitor de humedad del suelo publicar en ThingSpeak Canal 276330.

Modificar datos del gráfico

Puede modificar los datos utilizados para generar un gráfico personalizado. Utilizar el average parámetro para promediar durante un número determinado de minutos, days para seleccionar un número de días de datos, hasta 8000 puntos, y min para mostrar datos mayores que un valor mínimo dado. Cree un gráfico usando este HTTP GET:

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

La respuesta es un cuadro que muestra los valores promedio de humedad del suelo en una ventana de 240 minutos durante cuatro días, excluyendo cualquier punto con un valor inferior a 200. Los datos son de un monitor de humedad del suelo publicar en ThingSpeak Canal 276330. El ejemplo aquí diferirá 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 de fuente para crear un gráfico con las propiedades deseadas. Usar title , xaxis , color , type , width , height , average , yaxismax , y dynamic para crear un gráfico personalizado. Cree un gráfico usando 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 un cuadro que muestra los valores de temperatura exterior promedio durante una ventana de 10 minutos utilizando los datos de temperatura del campo 2 de ThingSpeak Canal 9.