{
  "title": "Texas communities — GNIS Populated Places supplemented by Census 2025 places",
  "preparedDate": "2026-11-01",
  "recordCount": 9436,
  "counts": {
    "gnisTexasPopulatedPlaces": 9306,
    "gnisExplicitHistoricalExcluded": 92,
    "gnisRetained": 9214,
    "census2025TexasPlaces": 1863,
    "censusMatchedToGNIS": 1641,
    "censusSupplemental": 222
  },
  "sources": [
    {
      "organization": "U.S. Geological Survey / U.S. Board on Geographic Names",
      "title": "GNIS Populated Places national text snapshot",
      "url": "https://prd-tnm.s3.amazonaws.com/StagedProducts/GeographicNames/Topical/PopulatedPlaces_National_Text.zip",
      "documentation": "https://www.usgs.gov/us-board-on-geographic-names/download-gnis-data",
      "downloadedOn": "2026-11-01",
      "httpLastModified": "2026-09-02T15:12:14Z",
      "file": "PopulatedPlaces_National_Text.zip",
      "sha256": "919fac887628b8547ec1b24fae319522a9481a56909c3914d1e0a2b56783147c"
    },
    {
      "organization": "U.S. Census Bureau",
      "title": "2025 Gazetteer — Texas places",
      "url": "https://www2.census.gov/geo/docs/maps-data/data/gazetteer/2025_Gazetteer/2025_gaz_place_48.txt",
      "documentation": "https://www.census.gov/geographies/reference-files/time-series/geo/gazetteer-files.2025.html",
      "downloadedOn": "2026-11-01",
      "httpLastModified": "2025-09-10T17:30:11Z",
      "file": "2025_gaz_place_48.txt",
      "sha256": "614e06f49119eb31a6601dd58731a9514f4c1ca2c33064a182bff0e890196e4a"
    },
    {
      "title": "Supplied county boundary layer used only for county lookup on supplemental Census reference points",
      "file": "Updates/1.24/ZIP.1027.26/web/counties.json",
      "featureCount": 254,
      "sha256": "71873a1defabb3cbc5a2a99d4f473e04573a3dc0b589fa9ac292d0e46d463a47",
      "note": "The supplied simplified layer has 254 Texas counties and 2010 Census-style attributes. This lookup labels the county containing the representative point, not all counties intersected by a Census place. Three points unresolved by the simplified layer were resolved through the official Census Geocoder."
    }
  ],
  "method": [
    "Retain all GNIS records with state_numeric 48 and feature_class Populated Place, excluding names containing historical (case-insensitive).",
    "Retain every Census 2025 Texas place, without a population cutoff. Remove the trailing city, town, village, or CDP suffix for base-name comparisons; lowercase and remove characters outside a-z and 0-9.",
    "Represent a Census place on the nearest same-normalized-name GNIS record when its Census representative point is within 5 statute miles using the haversine formula and Earth radius 3958.7613 miles. Preserve the Census official name, code, source and own coordinate in that record.",
    "Add every unmatched Census place as a separate reference point. No GNIS records are removed on matching. Every one of 1863 Census GEOIDs is represented in the final dataset.",
    "Sort records by name, county and identifier. Store coordinates as supplied by GNIS or Census, without claiming parcel or city boundaries."
  ],
  "limitations": [
    "This is a reconstructed public-source inventory, not a recovered copy of the missing original release asset. Its documented source and match method reproduce the specified 9436-reference count.",
    "Five-mile same-name matching is a reproducible heuristic, not an official crosswalk. It can conflate distinct nearby places or leave duplicate representations where official reference points are farther apart. Both source coordinates are retained for audit.",
    "The inventory includes cities, neighborhoods, unincorporated communities and other GNIS populated-place names. It does not promise every informal local name, current habitation, housing availability or market demand.",
    "GNIS county is its primary county. Supplemental county labels are inferred from the supplied county layer at a representative point and may not list every county for cross-county places.",
    "Census Gazetteer files contain geography and reference coordinates, not population counts. No current population is inferred."
  ],
  "countyGeocoder": {
    "documentation": "https://geocoding.geo.census.gov/geocoder/Geocoding_Services_API.html",
    "queriedOn": "2026-11-01",
    "benchmark": "Public_AR_Current",
    "vintage": "Current_Current",
    "file": "county-geocoder-audit.json",
    "resolvedRecords": 3,
    "sha256": "3a0514688073ced24f627e981b6c931ac47b0061ae95a619a2f77e48c9255284"
  },
  "unresolvedSupplementalCounties": 0,
  "verification": {
    "uniqueIds": true,
    "validTexasCoordinateEnvelope": true,
    "allCensusGEOIDsRepresented": true,
    "historicalNamesExcluded": true
  }
}
