react-chile-map

React choropleth maps for Chilean regions, provincias, and comunas, backed by processed cartography from the Biblioteca del Congreso Nacional de Chile (BCN).

import { ChileMap } from "react-chile-map";
import regiones from "react-chile-map/data/regiones.json";
import type { Topology } from "topojson-specification";

<ChileMap topology={regiones as unknown as Topology} data={{ "13": 8_242_459 }} />;

Regional subdivision components lazy-load their bundled geometry:

import { RegionComunasMap, RegionProvinciasMap } from "react-chile-map";

<RegionComunasMap region="13" data={{ "13101": 100 }} />;
<RegionProvinciasMap region="13" data={{ "131": 100 }} />;

Opt into exact data keys for any of the 16 regions with the generated code types:

import type { ComunaData, ProvinciaData } from "react-chile-map";

const comunas = {
  "13101": 50,
  "13113": 82,
} satisfies ComunaData<"13">;

const provincias = {
  "131": 100,
  "132": 78,
} satisfies ProvinciaData<"13">;

<RegionComunasMap region="13" data={comunas} />;
<RegionProvinciasMap region="13" data={provincias} />;

ComunaCode<R> and ProvinciaCode<R> expose the exact bundled code unions. These types are optional, so dynamic records and custom topology codes remain supported by the component props.

Both accept an optional topology override for SSR, tests, preloading, and custom cartography. Units without data use a configurable gray fill, and invalid/unknown values are ignored with aggregated development-only warnings.

Shared features include linear/quantile scales, controlled selection, custom colors and tooltips, lazy loading fallbacks, typed callbacks, localized featureLabel formatting, and stroke/fill/both highlighting.

<ChileMap
  topology={regiones}
  featureLabel={(feature) => englishLabels[feature.code] ?? feature.name}
/>

The formatter changes default tooltip and SVG accessibility labels while callbacks retain the canonical BCN feature.name.

Official territorial codes are zero-padded strings:

• regions: two digits ("13");
• provincias: three-digit CUT ("131"); and
• comunas: five-digit CUT ("13101").

The generated topology covers the national territory present in the BCN sources, including Rapa Nui and Juan Fernández through automatic side insets. The BCN source provides no Antarctic geometry, and very small islets may be removed by the documented generation thresholds.

Cartography

Source: Biblioteca del Congreso Nacional de Chile (BCN), mapas vectoriales. The material is referential and is not suitable for work requiring geodetic precision. Maps depicting Chilean limits and borders do not bind the State of Chile.