bdurand/us_geo

View on GitHub
lib/us_geo/metropolitan_division.rb

Summary

Maintainability
A
1 hr
Test Coverage
# frozen_string_literal: true

module USGeo
  # Division of very large metropolitian areas into groups of approximately 2.5 million people.
  class MetropolitanDivision < BaseRecord
    include Population
    include Area

    self.primary_key = "geoid"

    has_many :counties, -> { not_removed }, foreign_key: :metropolitan_division_geoid, inverse_of: :metropolitan_division
    belongs_to :core_based_statistical_area, foreign_key: :cbsa_geoid, optional: true, inverse_of: :metropolitan_divisions

    validates :geoid, length: {is: 5}
    validates :name, presence: true, length: {maximum: 60}, uniqueness: true
    validates :land_area, numericality: true, presence: true
    validates :water_area, numericality: true, presence: true
    validates :population, numericality: {only_integer: true}, presence: true
    validates :housing_units, numericality: {only_integer: true}, presence: true

    # @!attribute geoid
    #   @return [String] 5-digit code for the metropolitan division.

    # @!attribute name
    #   @return [String] Name of the metropolitan division.

    # @!method combined_statistical_area
    #   @return [CombinedStatisticalArea, nil] Combined statistical area that the metropolitan division is a part of.
    delegate :combined_statistical_area, to: :core_based_statistical_area, allow_nil: true

    class << self
      def load!(uri = nil)
        location = data_uri(uri || "metropolitan_divisions.csv")

        import! do
          load_data_file(location) do |row|
            load_record!(geoid: row["GEOID"]) do |record|
              record.name = row["Name"]
              record.cbsa_geoid = row["CBSA"]
              record.population = row["Population"]
              record.housing_units = row["Housing Units"]
              record.land_area = row["Land Area"]
              record.water_area = row["Water Area"]
            end
          end
        end
      end
    end
  end
end