# Nigeria map sources

Built by `scripts/nigeria/maps.ts`.

## states.topo.json (37 units: 36 states and the FCT)

- **Source:** OCHA Common Operational Dataset, administrative boundaries of Nigeria (COD-AB),
  admin level 1. Its source is the Office of the Surveyor General of the Federation (OSGOF), with
  eHealth Africa and the UN Cartographic Section.
  Page: <https://data.humdata.org/dataset/cod-ab-nga>.
- **Fetched from:** the unmodified "originals" mirror at
  <https://data.fieldmaps.io/cod/originals/nga.shp.zip>. HDX answers scripts with an AWS WAF
  challenge.
- **Licence:** Creative Commons Attribution for Intergovernmental Organisations (CC BY-IGO 3.0).
  Attribution: "OSGOF / OCHA, COD-AB Nigeria".
- **Fallback, used only if the mirror is down:** geoBoundaries gbOpen NGA ADM1, release `9469f09`
  (GRID3 Nigeria state boundaries), CC BY 4.0. The `source` field inside the file names the source
  that was actually used.
- **Processing:** mapshaper `-clean`, `-simplify interval=500` (metres) `keep-shapes`, quantisation
  1e5. Object `units`. Feature id and `code` are ISO 3166-2:NG codes; `name` and `zone` come from
  `src/lib/nigeria/states.ts`.
- **Date:** fetched 9 November 2026 (mirror file dated 13 November 2024; COD-AB valid from 17
  April 2019).
- Neither INEC nor OSGOF publishes a downloadable boundary file of its own (checked 9 November
  2026).

## lgas.topo.json, senatorial.topo.json, federal.topo.json

Built by `scripts/nigeria/maps-depth.ts` (inputs are passed as paths; the URLs are in its header).
Crosswalk: `src/data/nigeria/snapshot/geo-crosswalk.json`. Lookup helpers:
`src/lib/nigeria/places/` (`names.ts`: ids, name matching, `KNOWN_NAME_FIXES`; `topo.ts`: features
by id or state, bounding boxes). Per-state views load the national file and filter on `state`.

### Official sources first: what INEC publishes

INEC publishes **no boundary file** for LGAs, wards, senatorial districts or constituencies (checked
9 November 2026: the Nuxt site's route and document list in its JS bundles has no GIS, map or
delimitation data, only the "Retreat on Delimitation" communiqué and speeches;
`/delimitation`, `/elections/delimitation`, `/documents/`, `/publications`, `/maps`,
`/sitemap.xml` answer 404). What INEC does publish, and what is used:

- **IReV** (INEC Result Viewing, <https://www.inecelectionresults.ng/>, open JSON API): every LGA
  (IReV numeric `lga_id`) and its 8,809 wards, each ward tagged with its senatorial district,
  federal constituency and state constituency; and the INEC code and name of all 109 districts and
  360 constituencies (from the `domain` of each Senate / House election). This is INEC's own
  delimitation, used to dissolve the LGAs.
- **Report of the 2023 General Election**, annexures 4 and 5: the same 109 SD and 360 FC codes
  (checked both ways). Its constituency-name column is sorted independently of the code column
  (244 of 355 FC rows disagree with IReV by name but agree by code and LGA count), so names come
  from IReV. Disagreements on LGA counts by code, left as found (UNVERIFIED which is right):
  FC/126/GM and FC/127/GM (report 3 / 2; IReV Kaltungo/Shongom = 2, Gombe/Kwami/Funakaye = 3),
  FC/292/OS and FC/293/OS (report 4 / 3; IReV 3 / 4). SD/077/NG is printed as "81" LGAs (IReV: 8).

### lgas.topo.json (774 LGAs; object `lgas`)

- **Geometry:** GRID3 NGA Operational LGA Boundaries (eHealth Africa and Proxy Logics, GRID3
  Nigeria), <https://data.grid3.org/datasets/2bb616a49ee84f409427cc2143787113>, feature service
  `NGA_LGA_Boundaries_2` (item modified 4 September 2025). **Licence: CC BY 4.0.** Fallback source,
  not INEC (labelled).
- **Properties:** `id` = IReV `lga_id` (string), `state` = ISO 3166-2:NG, `name` = INEC's name
  (title case, bracketed headquarters dropped, plain typos fixed), `pcode` = OCHA COD-AB admin-2
  P-code (CC BY-IGO 3.0; 755 by name within the state, 19 by location), `sd` = INEC SD code,
  `fc` = INEC FC code(s) (two for the five split LGAs).
- **Join:** all 774 IReV LGAs ↔ 774 GRID3 polygons, one-to-one within each state: 724 by name key
  (case, punctuation, bracketed headquarters ignored), 50 by `KNOWN_NAME_FIXES` (e.g. IReV "EGBADO
  NORTH" = GRID3 "Yewa North", "S/BIRNI" = "Sabon Birni", "KOGI . K. K." = "Kogi").

### senatorial.topo.json (109 districts; object `senatorial`)

- **Built** by dissolving the GRID3 LGAs by INEC's district (no LGA is split between districts).
  `id` = INEC code ("SD/001/AB"), `state`, `name` ("Abia North", "FCT"), `irev` = IReV
  `senatorial_district_id`. **Licence: CC BY 4.0** (GRID3 LGAs). Not an INEC map: the lines are
  GRID3's LGA lines.

### federal.topo.json (360 constituencies; object `federal`)

- **Built** the same way, by federal constituency. `id` = INEC code ("FC/001/AB"), `state`, `name`
  (IReV's, title-cased, obvious misspellings fixed), `irev` = IReV `federal_constituency_id`.
- **Five LGAs are split between two constituencies** (Lagos Island I/II, Mushin I/II, Oshodi/Isolo
  I/II, Surulere I/II, Port Harcourt I/II). INEC's ward polygons are not published; GRID3
  Operational Wards v4.0 (CIESIN, <https://data.grid3.org/datasets/74cf76766bec4481aa03523e0e1fdddc>,
  **CC BY-SA 4.0**) are used, matched to INEC wards by number (Port Harcourt: GRID3 "PHWard n" =
  INEC ward code n) or name, the rest by nearest matched ward, and the LGA is cut along them. In
  Lagos GRID3's wards are not INEC's (e.g. Surulere: 23 GRID3 wards vs 12 INEC wards), so these ten
  shapes are **approximate** and carry `approx: true`. Because of those ward lines the file is
  **CC BY-SA 4.0** (attribution: GRID3 Nigeria; CIESIN, Columbia University).
- OCHA COD-AB admin 3 (wards) has no wards in these LGAs, so it could not be used instead.

### Processing and sizes

mapshaper: dissolve (`-dissolve2` after `snap`), `-simplify weighted` with `keep-shapes`
(lgas 16 %, senatorial and federal 30 % of vertices), `-clean`, quantisation 1e5. Sizes: lgas
≈ 381 KB, federal ≈ 321 KB, senatorial ≈ 172 KB. Fetched 9 November 2026.

### State constituencies (993): not built

IReV's wards carry `state_constituency_id` (991 distinct ids in the 2023 presidential ward list,
not the 993 seats), but many state constituencies split LGAs along ward lines that only INEC's
ward map would give; not attempted.

### URLs tried that gave nothing usable (9 November 2026, project UA unless noted)

- <https://inecnigeria.org/delimitation>, `/elections/delimitation`, `/documents/`,
  `/publications`, `/maps`, `/sitemap.xml`: 404. `/resources`: 200, no GIS.
- GRID3 hub search (`data.grid3.org/api/search/v1`) for "nigeria senatorial" and "nigeria
  constituency": no results; the GRID3 ArcGIS organisation's 190 services include no SD or FC layer.
- HDX `nga_adm_osgof_20190417.zip` (reported to hold OSGOF senatorial districts): WAF challenge page
  instead of the file (earlier probe; not retried with a browser).
