Main Content

Cette page a été traduite par traduction automatique. Cliquez ici pour voir la dernière version en anglais.

Show Channel Map

Afficher l'emplacement du canal sur la carte

Utilisez Show Channel Map pour intégrer une carte sur une page Web.

Requête

Méthode HTTP

GET

URL

https://thingspeak.com/channels/<channel_id>/maps/channel_show

Paramètres d'URL

NomDescription

<channel_id>

(Obligatoire) ID du canal pour le canal d’intérêt.

 Exemple d'URL :  https://thingspeak.com/channels/276330/maps/channel_show

Paramètres de chaîne de requête

NomDescriptionType de valeur
read_api_key

(Obligatoire pour les canaux privés). Spécifiez la clé d'API en lecture pour ce canal spécifique . Recherchez la clé d'API en lecture dans l'onglet API Keys de la vue des canaux.

chaîne de caractère

width

(Facultatif) Largeur de la carte en pixels. La largeur de carte par défaut est de 450.

entier

height

(Facultatif) Hauteur du graphique en pixels. La hauteur de carte par défaut est de 260.

entier

Réponse

Succès

Code HTTP status

200 OK

Exemple de corps
GET https://thingspeak.com/channels/12397/maps/channel_show

La réponse est une carte montrant un marqueur pour la latitude et la longitude définies sur la page Channel Settings.

Erreur

Pour la liste complète, voir Codes d'erreur.

Si vous n'avez pas accès au canal, la réponse est The requested map is not accessible. Provide a public channel or the read API key for the private channel as a parameter: read_api_key=XXXXXXXXXXXXXXXX.

Exemples

Intégrer une carte dans une iframe de page Web

  1. Créez l'appel REST Show Channel Map en utilisant l'exemple de format. Ajoutez le paramètre read_api_key si le canal est privé. Utilisez un navigateur Web pour tester l'appel.

  2. Créez un fichier html avec les éléments suivants. Remplacez <channel_id> par l'ID de votre canal et XXXXXXXXXXXXXXXX par la clé d'API en lecture du canall d’intérêt.

    <html><head><title>ThingSpeak Embedded Map</title></head>
    <body>
    <iframe width="650" height="800" style="border: 1px solid #cccccc;" src="https://thingspeak.com/channels/<channel_id>/maps/channel_show?read_api_key=XXXXXXXXXXXXXXXX&height=800">
    </body></html>
  3. Enregistrez le fichier avec l'extension .HTML.

  4. Ouvrez le fichier avec un navigateur Web pour afficher la carte intégrée.