CHANGELOG.md
# Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## 2.1.1
### Fixed
- Made `belongs_to` associations on models optional so that you don't need to import the full data set in order to have valid records.
## 2.1.0
### Changed
- Lazy load ActiveRecord classes so they don't add overhead during application initialization.
- Update distribution data files with latest Census data as of March 2024.
- Geographic data is based on 2023 Gazetteer files.
- Population and housing data are based on 2022 ACS estimates.
- Some of the Core Based Statistical Area, Combined Statisical Area, and Metropolitan Division names have changed.
- All Urban Areas now include "Urban Area" in their name. The Census Bureau no longer distinguishes between Urbanized Areas and Urban Clusters and the data now reflects the official names.
### Deprecated
- The USGeo::UrbanizedArea and USGeo::UrbanCluster classes are deprecated. These classes are now just aliases for USGeo::UrbanArea. You can still use the `urbanized?` and `cluster?` methods to determine the size of an UrbanArea based on the pre-2020 definition of greater or less then 50,000 residents.
## 2.0.4
### Fixed
- Remove "Urbanized Area" from short name for urban areas.
- Fix short name for Louisville, KY in the in the CBSA's, CSA's, and Urban Areas to omit "Jefferson County" so it matches convention for other short names of only showing the major city.
## 2.0.3
### Added
- Added methods to calculate housing density.
## 2.0.2
### Fixed
- Migrations that update existing data are now compatible with Rails versions prior to 7.0.
## 2.0.1
### Added
- Indexes on `us_geo_zctas` on `primary_place_geoid` and on `primary_county_subdivision_geoid`.
## 2.0.0
### Changed
- Data is now based on the 2020 U.S. Census
* ZCTAs have been both added and removed
* Places have been both added and removed
* Some counties and subdivisions have been renamed
* A number of smaller urban areas have been removed
* Former U.S. territories (Micronesia, Palau, and Marshall Islands) have been removed
- Population and housing unit numbers are now based on the 2021 [American Community Survey Five Year Estimates](https://www.census.gov/programs-surveys/acs).
- Entities that are legally independent of other county subdivisions are included as both county subdivisions and places.
- Areas in the CSV data files are now in square miles instead of square meters to match the data after it is imported into a database.
### Added
- ZCTA's are now associated with a primary place defined as the place with the most overlapping land area with the ZCTA.
- ZCTAS's are now associated with county subdivisions and have a primary county subdivision which is the one with the moste land area overlapping the ZCTA.
- 2010 ZCTAs can still be used to lookup the active ZCTA through the ZCTAMapping model.
- Core Based Statistical Areas and Combined Statistical Areas now have a short name which is the name of just the largest city in the area. This makes them a little easier to refer to by name.
- All Geographic entity models now have land area, water area, population, and housing units columns.
- Urban Areas are now associated with county subdivisions.
- Counties can now have multiple time zones. You can still call `time_zone` to get a single time zone for a county, but it is more accurate to call `time_zones` instead. There are only a handful of counties that span time zones and none are heavily populated (the largest is Coconino County, AZ with 145K people).
### Removed
- The Designated Market Area model has been removed. This data was a crude mapping from counties to DMA's and was not accurate since it didn't respect the actual borders. The table and foreign keys to it will not be removed if they are already in your database. See the [updating guide](UPDATING_TO_VERSION_2.md) form more details.
- Population and housing unit data has been removed from the overlap models used to join entities (i.e. `ZctaCounty`, `ZctaPlace`, `PlaceCounty`). This information is no longer available directly from the Census relationship files. Only the overlapping land and water area is now available.
- The `USGeo::Demographics` module has been removed. The functionality is split into `USGeo::Area` and `USGeo::Population`.
- Dropped support for ActiveRecord 5.0 and 5.1
- Dropped support for Ruby 2.5.
### Fixed
- Fixed arithmetic for converting area from square miles to kilometers.
## 1.0.3
### Added
- Make dependencies compatible with Rails 6
## 1.0.2
### Added
- Add missing metropolitan division codes to counties
### Changed
- Fix short name logic to be more conservative in how it shortens names
## 1.0.1
### Changed
- Fix logic to enforce place short name limit on databases that don't have character limits.
## 1.0.0
### Added
- Initial release