Créer un graphique
Générer un diagramme avec HTTP GET
Requête
Méthode HTTP
GET
URL
https://api.thingspeak.com/channels/
<channel_id>
/charts/<field_id>
Paramètres d'URL
Nom | Description |
---|---|
| (Obligatoire) ID du canal pour le canal d’intérêt. |
| (Obligatoire) ID de champ pour le domaine d'intérêt. |
Exemple : https://api.thingspeak.com/channels/99990/charts/2
Tracer les paramètres de la chaîne de requête
Utilisez ces paramètres pour ajuster les propriétés du diagramme . Utilisez ?
pour ajouter le premier paramètre et &
pour les paramètres suivants.
Nom | Description | Type de valeur |
---|---|---|
title | (Facultatif) Titre du graphique. La valeur par défaut est le nom du canal . | chaîne de caractère |
xaxis | (Facultatif) Libellé de l'axe des abscisses du graphique. La valeur par défaut est "Date". | chaîne de caractère |
yaxis | (Facultatif) Libellé de l'axe Y du graphique. La valeur par défaut est le nom du champ. | chaîne de caractère |
color | (Facultatif) Valeur hexadécimale pour la couleur de ligne. La valeur par défaut est FF000 (rouge). | chaîne de caractère |
bgcolor | (Facultatif) Couleur d'arrière-plan. La valeur par défaut est le blanc. | chaîne de caractère |
type | (Facultatif) Type de diagramme. La valeur par défaut est la ligne. |
|
width | (Facultatif) Largeur du graphique en pixels, la largeur de l'iframe est supérieure de 20 px, largeur du diagramme par défaut : 400. Réglez sur auto pour ajuster automatiquement la taille du diagramme en fonction de son conteneur parent. | entier |
height | (Facultatif) Hauteur du graphique en pixels, la hauteur de l'iframe est supérieure de 20 px, hauteur du diagramme par défaut : 200. Réglez sur auto pour ajuster automatiquement la taille du diagramme en fonction de son conteneur parent. | entier |
dynamic | (Facultatif) Effectuez automatiquement la mise à jour du diagramme en fonction de l'intervalle de temps mentionné dans la mise à jour. Le défaut est faux. |
|
step | (Facultatif) Dessinez un diagramme en tant que diagramme en étapes . Le défaut est faux. |
|
yaxismin | (Facultatif) Valeur minimale de l'axe Y du diagramme . Si vide, la valeur est calculée automatiquement. | décimal |
yaxismax | (Facultatif) Valeur maximale de l'axe Y du diagramme . Si vide, la valeur est calculée automatiquement. | décimal |
update | (Facultatif) Intervalle de temps en secondes pour mettre à jour automatiquement le diagramme . La valeur par défaut est 15. | entier |
Envoyer en flux les paramètres de la chaîne de requête
Utilisez ces paramètres pour ajuster les propriétés des données de canal utilisées pour générer le diagramme. S'il n'y a pas de paramètres précédents, utilisez ?
pour ajouter le premier paramètre, et &
pour les paramètres suivants. Sinon, ajoutez tous les paramètres avec &
.
Nom | Description | Type de valeur |
---|---|---|
api_key | (Obligatoire pour les canaux privés) Spécifiez la clé d'API en lecture pour ce canal spécifique. La clé d'API en lecture est disponible dans l'onglet Clés d'API de la vue des canaux. | chaîne de caractère |
results | (Facultatif) Nombre d'entrées à récupérer. Le nombre maximum est de 8000. La valeur par défaut est 100. | entier |
days | (Facultatif) Nombre de périodes de 24 heures avant maintenant à inclure dans le flux. | entier |
start | (Facultatif) Date de début au format AAAA-MM-JJ%20HH:NN:SS. | date-heure |
end | (Facultatif) Date de fin au format AAAA-MM-JJ%20HH:NN:SS. | date-heure |
offset | (Facultatif) Décalage du fuseau horaire utilisé pour afficher les résultats. Utilisez le paramètre de fuseau horaire pour une plus grande précision. | entier |
min | (Facultatif) Valeur minimale à inclure dans la réponse. | décimal |
max | (Facultatif) Valeur maximale à inclure dans la réponse. | décimal |
round | (Facultatif) Arrondissez à ce nombre de décimales. | entier |
timescale | (Facultatif). Obtenez la première valeur dans ce nombre de minutes. Les valeurs valides sont : 10, 15, 20, 30, 60, 240, 720, 1440, "quotidien". | integer or string |
sum | (Facultatif). Obtenez la somme de ce nombre de minutes. Les valeurs valides sont : 10, 15, 20, 30, 60, 240, 720, 1440, "quotidien". | integer or string |
average | (Facultatif) Obtenez la moyenne de ce nombre de minutes. Les valeurs valides sont 10, 15, 20, 30, 60, 240, 720, 1440, "daily". Note: Les valeurs NaN sont interprétées comme 0 lors du calcul de la moyenne. | entier ou chaîne de caractère |
median | (Facultatif) Obtenez la médiane de ce nombre de minutes. Les valeurs valides sont : 10, 15, 20, 30, 60, 240, 720, 1440, "quotidien" | integer or string |
Réponse
Succès
200 OK
La réponse est un diagramme ThingSpeak .
Erreur
Pour la liste complète, voir Codes d'erreur.
Exemples
Vous pouvez utiliser votre navigateur Web pour effectuer des requêtes HTTP GET auprès de l'API RESTful ThingSpeak™. Pour voir le format d'une réponse HTTP, cliquez sur le lien ou copiez-le dans votre navigateur.
Modifier les paramètres d'affichage du graphique
Vous pouvez modifier les propriétés d'affichage du diagramme à l'aide des paramètres définis dans la requête sur l'API . Utilisez title
pour ajouter un titre personnalisé, color
pour modifier la couleur de la ligne et width
pour spécifier une largeur personnalisée pour le tracé dans pixels. Créez un diagramme à l'aide de ce HTTP GET :
La réponse est un chart qui affiche la mesure de l'humidité du sol avec une ligne rose, un titre personnalisé et une vue large. Les données proviennent d'une publication soil moisture monitor sur ThingSpeak Channel 276330.
Modifier les données du graphique
Vous pouvez modifier les données utilisées pour générer un diagramme personnalisé . Utilisez le paramètre average
pour faire la moyenne sur un nombre défini de minutes, days
pour sélectionner un nombre de jours de données, jusqu'à 8 000 points, et min
pour afficher des données supérieures à une valeur minimale donnée. Créez un diagramme à l'aide de ce HTTP GET :
https://api.thingspeak.com/channels/276330/charts/1?average=240&days=7&min=200
La réponse est un chart qui affiche les valeurs moyennes d'humidité du sol sur une fenêtre de 240 minutes pendant quatre jours, à l'exclusion de tout point ayant une valeur inférieure à 200. Les données proviennent d'une publication soil moisture monitor sur ThingSpeak Channel 276330. L'exemple ici sera différent de ce que vous voyez puisque les données sont dynamiques.
Créer un graphique avec les paramètres de graphique et de flux
Vous pouvez utiliser à la fois les paramètres de diagramme et de flux pour créer un diagramme avec les propriétés souhaitées. Utilisez title
, xaxis
, color
, type
, width
, height
, average
, yaxismax
et $ pour créer un diagramme personnalisé. Créez un diagramme à l'aide de ce HTTP GET :
La réponse est un chart qui affiche les valeurs moyennes de la température extérieure sur une fenêtre de 10 minutes en utilisant les données de température du champ 2 de ThingSpeak Channel 9.