{
  "version": "cn2023-2026patch-geonames20261029.1",
  "builtAt": "2026-10-29",
  "administrativeBaseline": "modood 2023-06-30 plus individually verified patches through 2026-10-29; not a guarantee of a complete 2026 administrative snapshot",
  "coordinateBaseline": "GeoNames country extracts downloaded 2026-10-29; WGS84; district/city representative points, not exact birth addresses",
  "licenses": {
    "admin": "WTFPL (modood); factual government notices",
    "aliases": "MIT (AreaCity names/pinyin only; no AMap coordinates or boundaries used)",
    "coordinates": "GeoNames CC BY 4.0"
  },
  "sources": {
    "modood": {
      "commit": "c49d495b40ac73eb1a66f6eeae5f8fd10696f035",
      "url": "https://github.com/modood/Administrative-divisions-of-China"
    },
    "areacity": {
      "commit": "c6c6e35bea3066d674efe2cded189dc57a86e7d8",
      "release": "2025.251231.260403",
      "url": "https://github.com/xiangyuecn/AreaCity-JsSpider-StatsGov"
    },
    "geonames": {
      "url": "https://download.geonames.org/export/dump/",
      "attribution": "GeoNames (https://www.geonames.org/), CC BY 4.0"
    }
  },
  "inputSHA256": {
    "CN.zip": "f43ea676e23782433bd08cd03ef215335c6f8620faed3497113f01da6a4bfea2",
    "HK.zip": "c8042e5fa2d49da49ad90992d6548308dc43ab038ab781c26845e46201cefc7c",
    "MO.zip": "6444e96dd67090631de15319c8609044ecf8733b284664c6f2b83e6afe5bf1bd",
    "TW.zip": "c3a6a96d317d5407d0f8fdad5c8f580c7d912d154d760b6baa2c7111aa90cf1d",
    "admin-20260403.7z": "0b181b4105c32b2631b1c8c8654859f10684c3748b188ebe08f342291dec1169",
    "admin-divisions/dist/provinces.json": "a7e6a230102fee054daa7f63d91ca8da4320c11a2ddd4e5f093999b579fd7d4f",
    "admin-divisions/dist/cities.json": "3f569aaa0bfbeba72f1597657511c64f54107baae71710fef7146f390a41af32",
    "admin-divisions/dist/areas.json": "fbe1575eecba4ffd4d50c3d2d6887bd873ceca6a203fb2d66698b5007826b6b6",
    "admin-divisions/dist/HK-MO-TW.json": "546616aa6ec7239d9bcf02cb063539652604162b1ab74ef65293537c54ea3534"
  },
  "coverage": {
    "nodes": 3779,
    "levels": {
      "province": 34,
      "city": 369,
      "district": 3376
    },
    "coordinates": 3407,
    "solarEligible": 3380,
    "matched": {
      "CN-province": 31,
      "CN-city": 332,
      "CN-district": 2623,
      "HK-district": 18,
      "MO-district": 8,
      "TW-city": 22,
      "TW-district": 368
    },
    "missingCoordinateNodes": 372
  },
  "limitations": [
    "Not a historical administrative-boundary database; old birth-place names should retain the input label.",
    "IANA Asia/Shanghai is the default civil clock for mainland China including Xinjiang; Xinjiang local-time records must explicitly choose Asia/Urumqi and standardOffset 360. GeoNames timezone is not silently applied.",
    "HK three geographic groups and Macau peninsula/island grouping are UI geography, not prefecture-level administrations. Macau parishes are geographic reference subdivisions.",
    "Taiwan uses local city/county -> district/township hierarchy with namespaced application IDs, not invented mainland GB district codes.",
    "2026 new counties without directly verified official numeric codes use explicit stable local IDs and no guessed coordinates.",
    "Coordinates are gazetteer reference points; a hospital/address can have a different longitude. A missing coordinate stays null, disabling true-solar correction.",
    "Administrative statistics management areas retained from modood are explicitly tagged; not all are legal county-level governments."
  ]
}