Docs · Visuals

Map JSON format.

Countries or US states coloured by a value, from the lowest to the highest, with the name and the number on hover.

Try it

Edit the example and the visual redraws. Mistakes show the same messages the API returns.

Fields

Good to know

• A code that appears twice is an error naming the repeat. A real code with no shape on the map (Puerto Rico and the territories on the US map; Guadeloupe, Gibraltar and other territories drawn as part of their country on the world map) is refused with the region's name: drop the row, or count it under the country it belongs to.
• The colour runs from the dashboard scheme's surface to its first series colour, lowest value to highest. A region with no row is drawn in a neutral tone and its tooltip says No data.
• A map is full width by default and 700 pixels tall, and the whole region always fits inside the tile; a third of the width is the narrowest it goes. Append merges rows by region, so a few changed regions can be sent without the rest.

Codes

What goes under idKey for each region, with the alternative that is also accepted and the name the tooltip shows.

Example

{
  "region": "world",
  "idKey": "country",
  "valueKey": "signups",
  "format": "number",
  "data": [
    { "country": "US", "signups": 412 },
    { "country": "GB", "signups": 138 },
    { "country": "DE", "signups": 96 },
    { "country": "IN", "signups": 87 },
    { "country": "CA", "signups": 64 },
    { "country": "BR", "signups": 41 },
    { "country": "AU", "signups": 33 },
    { "country": "JP", "signups": 19 }
  ]
}

Send it from your code

Paste the document in the editor, or replace it with a PUT to the visual's push URL. The push API page has the details and examples.

Next: Bar chart JSON format