# XWUIChartClusteredPointMap

A clustered point map: a fixed-type wrapper around `XWUIChart` that plots points on a
geographic surface and groups nearby markers into clusters as you zoom out, so dense
areas stay readable instead of collapsing into an unreadable blob of overlapping pins.
Pass `series` of `{ x, y }` data plus a `block` preset (1-4) and `size`
(`sm` / `md` / `lg`); the shared block config also exposes legend, grid,
axis, data-label, and tooltip-formatter toggles. Use it to map many point locations
where markers would otherwise overlap at lower zoom levels.

## Basic Usage

Two monthly `{ x, y }` series stand in as point values, fed to the clustered point
map renderer at the md size preset.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Two {x, y} series rendered through the clustering point-map type.
```

## Store Footfall

Per-outlet visitor counts plotted as points and clustered by city area.

```example
file: examples/StoreFootfall.ts
html: examples/StoreFootfall.html
title: Store Footfall
description: Daily footfall at retail outlets as interactive points clustered into downtown and suburban groups.
```

## Seismic Magnitudes

Earthquake magnitudes per monitoring station, grouped by fault network.

```example
file: examples/SeismicMagnitudes.ts
html: examples/SeismicMagnitudes.html
title: Seismic Magnitudes
description: Recorded magnitudes at seismometer stations plotted as points and clustered by fault network.
```

```api
```
