This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

Show Channel Map

Show channel location on a map

Use Show Channel Map to embed a map on a web page.


HTTP Method



URL Parameters



(Required) Channel ID for the channel of interest.

Example URL:

Query String Parameters

NameDescriptionValue Type

(Required for private channels). Specify read API key for this specific channel. Find the read API key on the API Keys tab of the channel view.



(Optional) Map width in pixels. Default map width is 450.



(Optional) Chart height in pixels. Default map height is 260.




HTTP Status Code

200 OK

Body Example


The response is a map showing a marker for the latitude and longitude set on the Channel Settings page.


For the full list, see Error Codes.

If you do not have access to the channel, the response is 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.


Embed Map in a Web Page iframe

  1. Create the Show Channel Map REST call using the example format. Add the read_api_key parameter if the channel is private. Use a web browser to test the call.

  2. Create a html file with the following elements. Replace <channel_id> with your channel ID and XXXXXXXXXXXXXXXX with the read API key for the channel of interest.

    <html><head><title>ThingSpeak Embedded Map</title></head>
    <iframe width="650" height="800" style="border: 1px solid #cccccc;" src="<channel_id>/maps/channel_show?read_api_key=XXXXXXXXXXXXXXXX&height=800">
  3. Save the file with the .HTML extension.

  4. Open the file with a web browser to view the embedded map.