# Geography, settlement references and density sources

## Roads, rivers and marine areas

Natural Earth 1:10 million public-domain cartography, captured 10 November 2026 from the [official source repository](https://github.com/nvkelso/natural-earth-vector). [Terms](https://www.naturalearthdata.com/about/terms-of-use/) place the map data in the public domain. The derived package contains 30,617 major-road reference records, 1,454 river/lake-centreline records and 306 named marine-area records. These are source records, not counts of unique physical roads, rivers or oceans. Source original bytes and SHA-256 receipts are in `geography-source-manifest.json`.

The geometry is simplified by radial distance for display, preserving original coordinates and endpoints rather than creating fictitious roads. Close geometry is not a navigation chart, road operating-status report or flood-risk map. Marine label centres are derived from unwrapped polygon rings so date-line polygons do not acquire a false label at Greenwich. Source marine names and boundaries are cartographic references, not sovereignty claims. Retrieval date does not establish the date when an individual road or river was surveyed.

Close views can request OpenStreetMap street and waterway geometry from the public Overpass API. These bounded, settled-area requests keep original geometry, tags and source timestamps. [© OpenStreetMap contributors, ODbL](https://www.openstreetmap.org/copyright). The source may be incomplete or unavailable. Queries are throttled to one per 30 seconds, have 13-second total deadlines and bounded source/point counts. Requests stop when hidden or superseded. No routing or road-safety suitability is inferred.

## Named cities, towns and villages

[GeoNames cities500](https://download.geonames.org/export/dump/), captured 10 November 2026; [CC BY 4.0](https://www.geonames.org/export/). The package includes 236,978 populated-place references. An initial 6,000-place overview and 46 populated geographic shards provide progressively more names. Original GeoNames ID, country code, feature code, time zone and source modification date remain. Source population values are used only to rank labels; they do not become current city statistics. GeoNames and OpenStreetMap identities are never relabelled as UN statistical urban centres, municipalities or interchangeable city boundaries. Name collisions retain geographic/source identity. Administrative labels retain the existing independent Natural Earth source.

## Population density

[European Commission JRC, GHS-POP R2023A](https://human-settlement.emergency.copernicus.eu/ghs_pop2023.php), [official open-data registry](https://registry.opendata.aws/ghs-pop/), CC BY 4.0. Source: `ghs-pop/r2023a/4326/30asec/2025/GHS_POP_E2025_GLOBE_R2023A_4326_30ss_V1_0.tif` in the official `jrc-ghsl` AWS bucket. Source object size 425,798,484 bytes; source ETag and output SHA-256 are recorded in `density-source-manifest.json`.

The selected field is a **2025 modelled spatial population projection**, not a 2025 census observation or live occupancy map. Original cells contain people per 30-arcsecond cell, approximately 1 km at the equator. Display density divides numeric population per original cell by its spherical surface area in km², retaining latitude-dependent cell area. Regional and native-point queries use the fixed original numeric COG, never rendered map colours. Invalid/outside-coverage values remain unavailable; a valid original zero remains zero.

The bundled 1,351 × 669 numeric global field uses the publisher's mean overviews, approximately 30 km. Its units use population per original cell and original-cell area; it does not divide a mean original-cell population by the much larger display-pixel area. A nonzero Brisbane 2 × 2 native mean (4,742.474854 people/cell) is checked against the publisher's corresponding first overview (4,742.475098). The source grid slightly overscans ±180°. Presentation alone removes the two outer overview columns and moves the presentation bounds by exactly their original cell widths; the original numeric grid, point georeferencing and native queries are unchanged. This avoids stretching the field or silently rejecting its larger-than-360° source extent. The global image is explicitly approximate; it does not show every original 1 km cell. A 384² regional sample and exact original point query are bounded and cancellable. Fractional modelled people and density estimates are retained rather than rounded into invented headcounts. Original-range requests pin the source ETag, so a changed upstream file cannot silently mix with the bundled overview.

## CO₂e density: included stationary facilities

[Climate TRACE data](https://climatetrace.org/data), [public API v7](https://api.climatetrace.org/v7/docs/index.html), [terms](https://climatetrace.org/terms), CC BY 4.0 for the included emissions and associated metadata. Source metadata reports release v5.12.0 (release date 28 October 2026; public release page 29 October). Captured 10 November 2026. Source requests explicitly select year 2025, gas `co2e_100yr`, and six stationary subsectors: electricity generation, cement, iron and steel, aluminium, oil/gas refining, and solid-waste disposal. Source response caps of 5,000 highest-ranked records per subsector remain explicit.

The snapshot contains 14,319 accepted source records in 185 countries/areas. Each retained record has an original Climate TRACE ID, valid EPSG:4326 centroid, a positive numeric annual emissions quantity in tonnes, exact year 2025, compatible gas `co2e_100yr` and source type `point-source`. Administrative aggregates, unlocated records, incompatible years/gases, nonpositive or missing quantities and wide oil-production basin sources are excluded. Restricted activity and emissions-factor data are not republished.

All included quantities share **IPCC AR6 100-year global warming potentials (GWP100)**. CO₂ alone is never relabelled as CO₂e. Values from different years or GWP bases are not combined. Each ID contributes once. Equal-area cells use 144 longitude × 72 sine-latitude bins, approximately 49,196 km² each. The display reports the sum of included annual source emissions attributed to each cell divided by that cell's spherical area: **t CO₂e/km²/year**. Selecting a facility gives the separate original **t CO₂e/year** value.

This is a **partial stationary-facility inventory**, not an all-source national/global emissions total, atmospheric CO₂ concentration, pollution exposure, or greenhouse-gas flux measurement. Blank cells mean no included source, not zero emissions. Source centroids may be representative positions; the source footprint need not fit within one density cell. Two source records may describe related facilities or subsectors; counts are not asserted as unique industrial campuses. Climate TRACE annual estimates have modelling uncertainty. Source IDs link to the original source-specific API detail, with annual scope and gas explicit.

## Forest closeups

The existing annual 2017–2025 Impact Observatory / Microsoft / Esri source retains the selected year and raw U8 class codes. Close views now request 768² categorical samples instead of 384², with a matching bounded response budget; display projection budgets remain capped. The WorldCover 2021 reference worker also returns a denser 768² patch. These are four times as many regional samples, not a claim that original 10 m nominal classifications become more accurate or gain finer physical information. Class interpolation remains nearest-neighbour; cloud/no-data and point-history handling are unchanged. See [resource methods](RESOURCES_DATA_LICENSE.md).

## Reproduction

`Website_Editor/tools/refresh_atlas_geography.py` takes reviewed captured Natural Earth and GeoNames inputs and writes the geometry/place shards. `Website_Editor/tools/refresh_atlas_density.cjs` reads original numeric GHSL ranges and captures the explicit Climate TRACE source queries, then produces numeric density assets and receipts. Both generators write UTF-8 LF JSON. Full source URLs, byte counts, hashes, units, source IDs and declared limits are preserved in the two release manifests.
