@johnmorrisdotca/kuni 1.6.3 → 1.7.0

package/CHANGELOG.md

@@ -6,6 +6,19 @@ All notable changes to this project are written here. The format follows
 
 ## [Unreleased]
 
+## [1.7.0] - 2026-11-11
+
+### Changed
+
+- **Cities rank by urban areas, one source for each country.** `metro` is now the urban area a city heads, by name as its source writes it: Statistics Canada's census metropolitan areas and agglomerations in Canada (the estimate of 1 July 2025, Table 17-10-0148-01), the Census Bureau's metropolitan and micropolitan statistical areas in the United States (1 July 2024), the OECD's functional urban areas in its other members, and for the first cities of China and India their censuses' urban figures (China's twenty-one megacities, by urban resident population in 2020: Chongqing 16.3 million, not its municipality's 32; India's twenty largest urban agglomerations of 2011, on which Mumbai ranks ahead of Delhi, the larger today). Where a city heads none, Wikidata's metropolitan area where it is bigger than the city, marked `metro.estimated` and `rankEstimated`, unless a bigger official area within 60 km holds it (Kyoto and Kobe, in Osaka's); else its own figure. South Africa's metropolitan municipalities are set on their seats (Durban is eThekwini's: Johannesburg, Cape Town, Durban, Pretoria, Gqeberha). Hong Kong and Macau are listed under their own codes, not China's. The area's figure ranks a city even below its own (Ulsan). Canada's first five are Toronto, Montreal, Vancouver, Calgary and Ottawa; the United States' New York City, Los Angeles, Chicago, Dallas and Houston; China's Shanghai, Beijing, Shenzhen, Chongqing and Guangzhou; India's Mumbai, Delhi, Kolkata, Chennai and Bengaluru. The sources and their terms are in NOTICE.md.
+
+### Added
+
+- **`inMetroOf`**, **`urbanAreaUnknown`** and **`rankEstimated`** on every city. `inMetroOf` is the id of the city whose urban area it lies inside, where it heads none of its own: Mississauga and Brampton in Toronto's (Statistics Canada's list of each area's municipalities), Fort Worth, Long Beach and Anaheim in Dallas's and Los Angeles's (named in the Census Bureau's titles), Ecatepec in Mexico City's, Niterói in Rio de Janeiro's, Thane in Mumbai's, Giza in Cairo's, Bangkok's districts and New York City's boroughs (set by id with their reasons), or a city near another whose area, or own figure of a million or more, holds three times its people; a city of a million or more is never put inside another's for being near it (Yokohama, Kobe, Kyoto, Incheon). Such a city comes after every city that heads an area, so a country's first ten or twenty are its major cities. `urbanAreaUnknown` marks a city of China or India below the census list, ranked after it. `rankEstimated` marks a city ranked by an estimate.
+- **Districts and other units out of the cities.** An item Wikidata counts as a settlement but whose name is a county, district, subdistrict, raion, governorate, territory or region (Yishui County, Xətai raion, Bisha governorate), a part of a city ("Zone 7 of Milan", Marseille's sectors) or a municipality beside a town of its name is no longer a city; its id answers with the town or the city it belongs to (`cityById("Q2076557")` is Baku), or with none. Where Natural Earth names the unit and no city stands apart, it becomes that town, with the town's point and people (Yishui, 94,115, not the county's 967,570). Four Vietnamese and Chadian provinces and the Free Territory of Trieste are left out by name.
+- **Nine more wrong Japanese names dropped**: a city carried the label of its state, province or country (Hidalgo del Parral as チワワ州, Bor as ニジニ・ノヴゴロド州, Revere as リビア, Murray as マリ); a test now finds any city named in Japanese as a subdivision it is not the capital of, or as another country.
+- **Duplicate items left out**: München (a second item for Munich), Madrid city, Seville city, Málaga City, Valladolid city and Chongqing Shi, each a second item for its city; Minneapolis–Saint Paul and El Paso–Juárez, areas; South Mumbai and the London Borough of Ealing, parts of a city; Natural Earth's second Natal and its Vila Velha (the Vitória area); Kota Semarang, a second item for Semarang; Jember and Cilacap (regencies), Đồng Nai and Bắc Ninh (provinces), Sinnuris and Dairut (districts of Egypt), Rony (an upazila), the Kutupalong refugee camp, Kowloon Walled City (demolished in 1993) and Cheok Ka Village; San Pedro Zacachimalpa, given the Puebla area's 4.7 million people. Puebla, León and Toluca are named so in English, not by their formal names; Malatya's figure of 750 and Sirajganj's round 450,000 are left out. Each id answers with its city. A name ending in Municipality or Borough is a unit now, like District and County.
+
 ## [1.6.3] - 2026-11-11
 
 ### Added

package/NOTICE.md

@@ -117,6 +117,49 @@ Statistics Canada Open Licence (https://www.statcan.gc.ca/en/reference/licence,
 > census metropolitan areas and census agglomerations, 2021 Census, reference date 2021-05-11. This does not constitute
 > an endorsement by Statistics Canada of this product.
 
+A city is ranked by the urban area it heads, with one source for each country, kept in
+`data-sources/urban-areas-<day>.json` by `scripts/fetch-urban.ts` (read on 2026-11-11), each section with its own terms:
+
+- Canada: the population of each census metropolitan area and census agglomeration on 1 July 2025 (Table 17-10-0148-01)
+  and the municipalities each holds (Table 98-10-0003-01, 2021 Census), under the Statistics Canada Open Licence:
+
+  > Adapted from Statistics Canada, Table 17-10-0148-01, Population estimates, July 1, by census metropolitan area and
+  > census agglomeration, 2021 boundary, and Table 98-10-0003-01, Population and dwelling counts: Census metropolitan
+  > areas, census agglomerations and census subdivisions (municipalities), 2021 Census. This does not constitute an
+  > endorsement by Statistics Canada of this product.
+
+- The United States: the population of each metropolitan and micropolitan statistical area on 1 July 2024, a work of
+  the United States government and in the public domain (17 U.S.C. 105). Source: U.S. Census Bureau, Population
+  Division, Annual Resident Population Estimates for Metropolitan and Micropolitan Statistical Areas, Vintage 2024.
+- The other members of the OECD: the population of each functional urban area, the latest year the OECD gives (2019 to
+  2025 by country). These are not under a Creative Commons licence: the OECD Terms and Conditions, section 3, Data
+  (https://www.oecd.org/en/about/terms-conditions.html, last updated 1 July 2024, read on 2026-11-11), let anyone
+  "extract from, download, copy, adapt, print, distribute, share and embed Data for any purpose, even for commercial
+  use", with the credit in the form "OECD (year), (dataset name),(data source) DOI or URL (accessed on (date))", and
+  ask that any sub-licence carry the same requirement. The credit:
+
+  > OECD (2026), Functional urban areas: population by age and sex, OECD Data Explorer,
+  > https://sdmx.oecd.org/public/rest/data/OECD.CFE.EDS,DSD_FUA_DEMO@DF_AGE_SEX (accessed on 2026-11-11).
+
+  Changes made: only the total population is kept, the latest year of each area; the area is joined to a city by its
+  name, or by id where the name is no city's (`OECD_AREAS` in `scripts/metro-links.ts`). Anyone who takes the figures
+  from this package must give the same credit.
+- China: the urban resident population (城区常住人口) of its twenty-one megacities at the Seventh National Population
+  Census, 1 November 2020, by the National Bureau of Statistics of China (its release of 22 September 2021, and
+  中国人口普查分县资料：2020, China Statistics Press, 2022). Only facts are taken, each city's figure and its day, typed
+  in `scripts/urban-facts.ts` with the source; no table is copied.
+- India: the population of its twenty largest urban agglomerations at the Census of India 2011, table A-04, by the
+  Office of the Registrar General & Census Commissioner, India. Only facts are taken, each figure and its day, typed in
+  `scripts/urban-facts.ts` with the source; no table is copied. These are 2011's figures: on them Mumbai ranks ahead of
+  Delhi, which is the larger today.
+- In a country with official areas, where a city heads none: the metropolitan areas of the Wikidata snapshot above
+  (CC0), where bigger than the city, marked as estimates. In every other country a city is ranked by its own figure
+  from that snapshot, marked as an estimate.
+
+An area whose name is no city's ("West Midlands urban area") is set to its city by id in `scripts/metro-links.ts`, with
+the reason. Natural Earth (below) still gives the population of a city Wikidata has none for (Pietermaritzburg, Welkom),
+and that figure ranks the city.
+
 The time zones (`/zones`, and `capitalZone` in `/facts`) are from IANA's tzdb zone.tab (public domain, below) and a
 fourth Wikidata snapshot (`data-sources/wikidata-zones-<day>.json`, CC0 on the same terms, read on 2026-11-11), asked for
 by `scripts/fetch-zones.ts`: the IANA ids (P6687) of the zones each first-level subdivision is in (P421).