# Canadian Census Maps (censusmaps.ca)

> Interactive bilingual (English / French) choropleth maps of 2016 and 2021 Canadian Census of Population data, served at three nested geographic levels (Census Subdivision, Census Tract, Dissemination Area). Built on Astro + Vue + MapLibre GL, deployed on Cloudflare Workers with data hosted on Cloudflare R2. Source data is from Statistics Canada under the Statistics Canada Open Licence.

## Site structure

URLs follow the pattern `/{locale}/{year}/{group}/{topic}/{category?}/{view?}/{geo-selection?}`.

- `locale`: `en` or `fr`
- `year`: `2016` or `2021` (2026 ships mid-2027)
- `group`: one of `population`, `identity`, `housing`, `education`, `work`
- `topic`: a specific indicator within the group (e.g. `total-population`, `median-age`)
- `category`: for distribution topics, a sub-bucket (e.g. age groups `0-14`, `15-64`)
- `view`: `extremes-{csd|ct|da}` for top/bottom 10 rankings at a given geo level
- `geo-selection`: `{csd|ct|da}-{code}` for a pinned area

## Key entry points

- [English homepage](https://censusmaps.ca/en/2021): 2021 Census, English
- [French homepage](https://censusmaps.ca/fr/2021): Recensement 2021, Français
- [2016 English](https://censusmaps.ca/en/2016): 2016 Census, English
- [Population indicators](https://censusmaps.ca/en/2021/population): Population, age, density, change
- [Identity indicators](https://censusmaps.ca/en/2021/identity): Languages, immigration, visible minority, religion
- [Housing indicators](https://censusmaps.ca/en/2021/housing): Dwelling type, ownership, affordability
- [Education indicators](https://censusmaps.ca/en/2021/education): Attainment, field of study
- [Work indicators](https://censusmaps.ca/en/2021/work): Employment, occupation, income, commuting
- [Sitemap index](https://censusmaps.ca/sitemap-index.xml): All 110k+ canonical URLs across both years and locales

## Example topic pages

- [Total population in Canada](https://censusmaps.ca/en/2021/population/total-population)
- [Population density](https://censusmaps.ca/en/2021/population/population-density)
- [Median household income](https://censusmaps.ca/en/2021/work/median-household-income)
- [Top 10 most/least populous CSDs](https://censusmaps.ca/en/2021/population/total-population/extremes-csd)
- [Toronto population profile](https://censusmaps.ca/en/2021/population/total-population/csd-3520005)

## Data

- Source: Statistics Canada, 2021 and 2016 Census of Population
- Licence: [Statistics Canada Open Licence](https://www.statcan.gc.ca/en/reference/licence)
- Boundary files: Statistics Canada cartographic boundary files (reprojected to WGS84)
- Building footprints: Microsoft ML Building Footprints for Canada and Statistics Canada Open Database of Buildings v3

## Author

Built by [Calvin Liang](https://calvin.sh). Inspired by the [ONS Census maps](https://www.ons.gov.uk/census/maps).