# A11Y (Maps example)

> WestCoast Charts 1.1.5, release, public Core release, on npm. HTML: https://westcoast-charts.com/gallery/maps/a11y/ · Index for agents: https://westcoast-charts.com/llms.txt

Tab into the map; arrow keys move between regions with data, Enter selects, +/- zoom.

Why it matters: keyboard walk over regions with announcements, generated summary and a data table fallback

- Chart type: `map` (Map)
- Collection: Maps · Maps
- Raw configuration: https://westcoast-charts.com/gallery-src/maps/a11y.js
- Standalone example: https://westcoast-charts.com/embed/samples/wcc/gallery/premium/maps/a11y.html

## Setup

```js
import WestCoastCharts from 'west-coast-charts'
import types from 'west-coast-charts/types'
import premium from 'west-coast-charts/premium'
import 'west-coast-charts/maps/world-small-states' // registers the map shapes

WestCoastCharts.use(types).use(premium)
const WestCoastChartsPremium = premium
WestCoastCharts.setLicenseKey(LICENCE_KEY) // paid production licence; localhost evaluation needs no key
```

## Options

```js
const options = {
  "chart": {
    "height": 480,
    "toolbar": {
      "show": false
    },
    "type": "map"
  },
  "series": [
    {
      "name": "Adoption %",
      "data": [
        {
          "id": "DEU",
          "region": "Europe",
          "value": 36.3
        },
        {
          "id": "FRA",
          "region": "Europe",
          "value": 66.7
        },
        {
          "id": "GBR",
          "region": "Europe",
          "value": 49
        },
        {
          "id": "ITA",
          "region": "Europe",
          "value": 82.3
        },
        {
          "id": "ESP",
          "region": "Europe",
          "value": 42.5
        },
        {
          "id": "NLD",
          "region": "Europe",
          "value": 65.6
        },
        {
          "id": "BEL",
          "region": "Europe",
          "value": 69.3
        },
        {
          "id": "CHE",
          "region": "Europe",
          "value": 80.5
        },
        {
          "id": "AUT",
          "region": "Europe",
          "value": 51.1
        },
        {
          "id": "POL",
          "region": "Europe",
          "value": 82.3
        },
        {
          "id": "SWE",
          "region": "Europe",
          "value": 73.1
        },
        {
          "id": "NOR",
          "region": "Europe",
          "value": 83.4
        },
        {
          "id": "DNK",
          "region": "Europe",
          "value": 34.4
        },
        {
          "id": "FIN",
          "region": "Europe",
          "value": 43.5
        },
        {
          "id": "IRL",
          "region": "Europe",
          "value": 73.1
        },
        {
          "id": "PRT",
          "region": "Europe",
          "value": 33.5
        },
        {
          "id": "CZE",
          "region": "Europe",
          "value": 38.2
        },
        {
          "id": "HUN",
          "region": "Europe",
          "value": 85.7
        },
        {
          "id": "ROU",
          "region": "Europe",
          "value": 35.9
        },
        {
          "id": "GRC",
          "region": "Europe",
          "value": 56
        },
        {
          "id": "SVK",
          "region": "Europe",
          "value": 41.3
        },
        {
          "id": "BGR",
          "region": "Europe",
          "value": 85.7
        },
        {
          "id": "HRV",
          "region": "Europe",
          "value": 34.5
        },
        {
          "id": "SRB",
          "region": "Europe",
          "value": 66.9
        },
        {
          "id": "SVN",
          "region": "Europe",
          "value": 63.7
        },
        {
          "id": "LTU",
          "region": "Europe",
          "value": 81
        },
        {
          "id": "LVA",
          "region": "Europe",
          "value": 42
        },
        {
          "id": "EST",
          "region": "Europe",
          "value": 48.8
        },
        {
          "id": "UKR",
          "region": "Europe",
          "value": 61.4
        },
        {
          "id": "BLR",
          "region": "Europe",
          "value": 51.3
        },
        {
          "id": "ISL",
          "region": "Europe",
          "value": 49.8
        },
        {
          "id": "USA",
          "region": "North America",
          "value": 97.1
        },
        {
          "id": "CAN",
          "region": "North America",
          "value": 54.2
        },
        {
          "id": "MEX",
          "region": "North America",
          "value": 51
        },
        {
          "id": "GTM",
          "region": "North America",
          "value": 45.8
        },
        {
          "id": "CRI",
          "region": "North America",
          "value": 42
        },
        {
          "id": "PAN",
          "region": "North America",
          "value": 80.4
        },
        {
          "id": "CUB",
          "region": "North America",
          "value": 57.1
        },
        {
          "id": "DOM",
          "region": "North America",
          "value": 98.4
        },
        {
          "id": "BRA",
          "region": "South America",
          "value": 23.1
        },
        {
          "id": "ARG",
          "region": "South America",
          "value": 35.2
        },
        {
          "id": "CHL",
          "region": "South America",
          "value": 33.3
        },
        {
          "id": "COL",
          "region": "South America",
          "value": 32.7
        },
        {
          "id": "PER",
          "region": "South America",
          "value": 37.1
        },
        {
          "id": "URY",
          "region": "South America",
          "value": 29.9
        },
        {
          "id": "ECU",
          "region": "South America",
          "value": 33.9
        },
        {
          "id": "VEN",
          "region": "South America",
          "value": 17.9
        },
        {
          "id": "BOL",
          "region": "South America",
          "value": 23.6
        },
        {
          "id": "PRY",
          "region": "South America",
          "value": 23.3
        },
        {
          "id": "JPN",
          "region": "Asia",
          "value": 41.6
        },
        {
          "id": "KOR",
          "region": "Asia",
          "value": 42.3
        },
        {
          "id": "CHN",
          "region": "Asia",
          "value": 29.4
        },
        {
          "id": "IND",
          "region": "Asia",
          "value": 28.2
        },
        {
          "id": "IDN",
          "region": "Asia",
          "value": 25.7
        },
        {
          "id": "SGP",
          "region": "Asia",
          "value": 35
        },
        {
          "id": "MYS",
          "region": "Asia",
          "value": 24.9
        },
        {
          "id": "THA",
          "region": "Asia",
          "value": 35.1
        },
        {
          "id": "VNM",
          "region": "Asia",
          "value": 40.5
        },
        {
          "id": "PHL",
          "region": "Asia",
          "value": 27.7
        },
        {
          "id": "ISR",
          "region": "Asia",
          "value": 41
        },
        {
          "id": "ARE",
          "region": "Asia",
          "value": 23.5
        },
        {
          "id": "SAU",
          "region": "Asia",
          "value": 46.8
        },
        {
          "id": "TUR",
          "region": "Asia",
          "value": 20.1
        },
        {
          "id": "KAZ",
          "region": "Asia",
          "value": 22.4
        },
        {
          "id": "PAK",
          "region": "Asia",
          "value": 47.2
        },
        {
          "id": "BGD",
          "region": "Asia",
          "value": 29.6
        },
        {
          "id": "LKA",
          "region": "Asia",
          "value": 29.5
        },
        {
          "id": "AUS",
          "region": "Oceania",
          "value": 40.8
        },
        {
          "id": "NZL",
          "region": "Oceania",
          "value": 54.5
        },
        {
          "id": "ZAF",
          "region": "Africa",
          "value": 12.5
        },
        {
          "id": "NGA",
          "region": "Africa",
          "value": 14.8
        },
        {
          "id": "EGY",
          "region": "Africa",
          "value": 7.1
        },
        {
          "id": "KEN",
          "region": "Africa",
          "value": 15.9
        },
        {
          "id": "MAR",
          "region": "Africa",
          "value": 6.7
        },
        {
          "id": "GHA",
          "region": "Africa",
          "value": 15.1
        },
        {
          "id": "ETH",
          "region": "Africa",
          "value": 16.8
        },
        {
          "id": "TZA",
          "region": "Africa",
          "value": 12.7
        },
        {
          "id": "DZA",
          "region": "Africa",
          "value": 12.8
        },
        {
          "id": "TUN",
          "region": "Africa",
          "value": 6.7
        },
        {
          "id": "SEN",
          "region": "Africa",
          "value": 13.6
        },
        {
          "id": "CIV",
          "region": "Africa",
          "value": 14
        },
        {
          "id": "AGO",
          "region": "Africa",
          "value": 11.2
        }
      ]
    }
  ],
  "plotOptions": {
    "map": {
      "map": "world-small-states"
    }
  },
  "theme": {
    "mode": "light",
    "preset": "coastal"
  }
}

const chart = new WestCoastCharts(document.querySelector('#chart'), options)
await chart.render()
```

## Verify

- Text check (Library 1.1.5): load `west-coast-charts/agent/describe` and call `chart.describe({ format: "json" })` for the actual drawn state. The live reader is on this example’s HTML page.
- Command line (Public agent tools 0.2.3, tested with Library 1.1.5; available from the versioned GitHub release and npm, https://westcoast-charts.com/docs/cli/index.md): `wcc chart export maps-a11y.json --out maps-a11y.svg --with-table` (save the options above as JSON first)
