us_geo 1.0.2 → 2.0.0

data/explorer_app/app/controllers/states_controller.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+class StatesController < ApplicationController
+  before_action :set_breadcrumbs
+
+  def index
+    @states = if @division
+      @division.states.order(:name)
+    else
+      USGeo::State.not_removed.order(:name)
+    end
+  end
+
+  def show
+    @state = USGeo::State.find(params[:id])
+    add_breadcrumb(state_id: @state)
+  end
+
+  private
+
+  def set_breadcrumbs
+    add_region_breadcrumb
+    add_division_breadcrumb
+  end
+end

data/explorer_app/app/controllers/urban_areas_controller.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+class UrbanAreasController < ApplicationController
+  def index
+    urban_areas = USGeo::UrbanArea.not_removed
+
+    @tab = params[:tab]
+    if @tab.present?
+      type = if @tab == "urbanized"
+        "UrbanizedArea"
+      elsif @tab == "cluster"
+        "UrbanCluster"
+      end
+      urban_areas = urban_areas.where(type: type)
+    end
+
+    @urban_areas = urban_areas.order(:name)
+  end
+
+  def show
+    @urban_area = USGeo::UrbanArea.find(params[:id])
+    add_breadcrumb(urban_area_id: @urban_area)
+  end
+end

data/explorer_app/app/controllers/zctas_controller.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+class ZctasController < ApplicationController
+  before_action :set_breadcrumbs
+
+  def show
+    @zcta = USGeo::Zcta.find(params[:id])
+    add_breadcrumb(zcta_id: @zcta)
+  end
+
+  private
+
+  def set_breadcrumbs
+    add_region_breadcrumb
+    add_division_breadcrumb
+    add_state_breadcrumb
+    add_county_breadcrumb
+    add_combined_statistical_area_breadcrumb
+    add_core_based_statistical_area_breadcrumb
+    add_metropolitan_division_breadcrumb
+    add_urban_area_breadcrumb
+  end
+end

data/explorer_app/app/helpers/application_helper.rb

@@ -0,0 +1,137 @@
+module ApplicationHelper
+  def formatted_number(number, round: nil)
+    if number
+      number = (round ? number.round(round) : auto_round(number))
+      number_with_delimiter(number)
+    else
+      "-"
+    end
+  end
+
+  def google_maps_link(location)
+    if location.lat && location.lng
+      url = "https://www.google.com/maps/place/#{location.lat},#{location.lng}"
+      link_to("#{location.lat}, #{location.lng}", url, target: "_blank")
+    else
+      "n/a"
+    end
+  end
+
+  def demographics_headers
+    render "shared/demographics_headers"
+  end
+
+  def demographics_cells(entity, round_area: nil)
+    render "shared/demographics_cells", entity: entity, round_area: round_area
+  end
+
+  def population_density(entity)
+    density = entity.population_density
+    return nil unless density
+
+    round = if density < 1
+      3
+    elsif density < 10
+      2
+    elsif density < 100
+      1
+    else
+      0
+    end
+
+    "#{formatted_number(density, round: round)} / mi²"
+  end
+
+  def overlap_percentage(entity, other_entity, association)
+    return nil unless entity && other_entity && entity.total_area > 0
+
+    belongs_to = other_entity.class.base_class.to_s.demodulize.underscore
+    overlap = entity.send(association).detect { |r| r.send(belongs_to) == other_entity }
+    return nil unless overlap
+
+    percent = overlap.total_area / entity.total_area
+    number_to_percentage(percent * 100, precision: 1)
+  end
+
+  def auto_round(number)
+    return number unless number.is_a?(Float)
+
+    decimals = if number < 1
+      3
+    elsif number < 10
+      2
+    elsif number < 100
+      1
+    else
+      0
+    end
+
+    number.round(decimals)
+  end
+
+  def breadcrumb_params(additional_params = {})
+    if @breadcrumbs
+      @breadcrumbs.merge(additional_params)
+    else
+      additional_params
+    end
+  end
+
+  def breadcrumbs(active_label, active: nil)
+    render "shared/breadcrumbs", links: breadcrumb_links(active), active_label: active_label
+  end
+
+  def breadcrumb_links(active = nil)
+    return {} if @breadcrumbs.blank?
+
+    objects = @breadcrumbs.values
+    region = objects.detect { |b| b.is_a?(USGeo::Region) }
+    division = objects.detect { |b| b.is_a?(USGeo::Division) }
+    state = objects.detect { |b| b.is_a?(USGeo::State) }
+    combined_statistical_area = objects.detect { |b| b.is_a?(USGeo::CombinedStatisticalArea) }
+    core_based_statistical_area = objects.detect { |b| b.is_a?(USGeo::CoreBasedStatisticalArea) }
+    urban_area = objects.detect { |b| b.is_a?(USGeo::UrbanArea) }
+    metropolitan_division = objects.detect { |b| b.is_a?(USGeo::MetropolitanDivision) }
+    county = objects.detect { |b| b.is_a?(USGeo::County) }
+    county_subdivision = objects.detect { |b| b.is_a?(USGeo::CountySubdivision) }
+    place = objects.detect { |b| b.is_a?(USGeo::Place) }
+    zcta = objects.detect { |b| b.is_a?(USGeo::Zcta) }
+
+    links = {}
+
+    if region
+      links["Regions"] = regions_path
+    elsif division&.persisted?
+      links["Divisions"] = divisions_path
+    elsif state
+      links["States"] = states_path
+    elsif combined_statistical_area
+      links["Combined Statistical Areas"] = combined_statistical_areas_path
+    elsif core_based_statistical_area
+      links["Core Based Statistical Areas"] = core_based_statistical_areas_path
+    elsif urban_area
+      links["Urban Areas"] = urban_areas_path
+    end
+
+    links[region.name] = region_path(region) if breadcrumb_link?(region, active)
+    links[division.name] = division_path(division) if breadcrumb_link?(division, active)
+    links[state.name] = state_path(state) if breadcrumb_link?(state, active)
+    links[combined_statistical_area.name] = combined_statistical_area_path(combined_statistical_area) if breadcrumb_link?(combined_statistical_area, active)
+    links[core_based_statistical_area.name] = core_based_statistical_area_path(core_based_statistical_area) if breadcrumb_link?(core_based_statistical_area, active)
+    links[metropolitan_division.name] = metropolitan_division_path(metropolitan_division) if breadcrumb_link?(metropolitan_division, active)
+    links[urban_area.name] = urban_area_path(urban_area) if breadcrumb_link?(urban_area, active)
+
+    links[county.name] = county_path(county) if breadcrumb_link?(county, active)
+    links[county_subdivision.name] = county_subdivision_path(county_subdivision) if breadcrumb_link?(county_subdivision, active)
+    links[place.name] = place_path(place) if breadcrumb_link?(place, active)
+    links[zcta.name] = zcta_path(zcta) if breadcrumb_link?(zcta, active)
+
+    links
+  end
+
+  private
+
+  def breadcrumb_link?(object, active)
+    object&.persisted? && object != active
+  end
+end

data/explorer_app/app/models/application_record.rb

@@ -0,0 +1,3 @@
+class ApplicationRecord < ActiveRecord::Base
+  primary_abstract_class
+end

data/explorer_app/app/views/combined_statistical_areas/_table.html.erb

@@ -0,0 +1,18 @@
+<table class="table table-striped sortable">
+  <thead>
+    <tr>
+      <th>GEOID</th>
+      <th>Name</th>
+      <%= demographics_headers %>
+    </th>
+  </thead>
+  <tbody>
+    <% combined_statistical_areas.each do |combined_statistical_area| %>
+      <tr>
+        <td><%= combined_statistical_area.geoid %></td>
+        <td><%= link_to combined_statistical_area.name, combined_statistical_area_path(combined_statistical_area) %></td>
+        <%= demographics_cells(combined_statistical_area, round_area: 0) %>
+      </tr>
+    <% end %>
+  </tbody>
+</table>

data/explorer_app/app/views/combined_statistical_areas/index.html.erb

@@ -0,0 +1,7 @@
+<%= breadcrumbs("Combined Statistical Areas") %>
+
+<h1>
+  <%= pluralize @combined_statistical_areas.size, "Combined Statistical Area" %>
+</h1>
+
+<%= render "table", combined_statistical_areas: @combined_statistical_areas %>

data/explorer_app/app/views/combined_statistical_areas/show.html.erb

@@ -0,0 +1,52 @@
+<%= breadcrumbs @combined_statistical_area.name, active: @combined_statistical_area %>
+
+<h1><%= @combined_statistical_area.name %></h1>
+
+<table class="table table-striped">
+  <tbody>
+    <tr>
+      <th>GEOID</th>
+      <td><%= @combined_statistical_area.geoid %></td>
+    </tr>
+    <tr>
+      <th>Short Name</th>
+      <td><%= @combined_statistical_area.short_name %></td>
+    </tr>
+    <tr>
+      <th>Population</th>
+      <td><%= formatted_number(@combined_statistical_area.population) %></td>
+    </tr>
+    <tr>
+      <th>Housing Units</th>
+      <td><%= formatted_number(@combined_statistical_area.housing_units) %></td>
+    </tr>
+    <tr>
+      <th>Land Area (mi<sup>2</sup>)</th>
+      <td><%= formatted_number(@combined_statistical_area.land_area, round: 0) %></td>
+    </tr>
+    <tr>
+      <th>Water Area (mi<sup>2</sup>)</th>
+      <td><%= formatted_number(@combined_statistical_area.water_area, round: 0) %></td>
+    </tr>
+  </tbody>
+</table>
+
+<br>
+
+<h2><%= pluralize(@combined_statistical_area.core_based_statistical_areas.count, "Core Based Statistical Areas") %></h2>
+
+<%= render "core_based_statistical_areas/table", core_based_statistical_areas: @combined_statistical_area.core_based_statistical_areas, combined_statistical_area: @combined_statistical_area %>
+
+<% if @combined_statistical_area.metropolitan_divisions.present? %>
+  <br>
+
+  <h2><%= pluralize(@combined_statistical_area.metropolitan_divisions.count, "Metropolitan Divisions") %></h2>
+
+  <%= render "metropolitan_divisions/table", metropolitan_divisions: @combined_statistical_area.metropolitan_divisions, combined_statistical_area: @combined_statistical_area %>
+<% end %>
+
+<br>
+
+<h2><%= pluralize(@combined_statistical_area.counties.count, "County") %></h2>
+
+<%= render "counties/table", counties: @combined_statistical_area.counties, combined_statistical_area: @combined_statistical_area %>

data/explorer_app/app/views/core_based_statistical_areas/_table.html.erb

@@ -0,0 +1,32 @@
+<table class="table table-striped sortable">
+  <thead>
+    <tr>
+      <th>GEOID</th>
+      <th>Name</th>
+      <th>Type</th>
+      <% unless defined?(combined_statistical_area) && combined_statistical_area %>
+        <th>Combined Statistical Area</th>
+      <% end %>
+      <%= demographics_headers %>
+    </th>
+  </thead>
+  <tbody>
+    <% core_based_statistical_areas.each do |core_based_statistical_area| %>
+      <tr>
+        <td><%= core_based_statistical_area.geoid %></td>
+        <td><%= link_to core_based_statistical_area.name, core_based_statistical_area_path(core_based_statistical_area, breadcrumb_params) %></td>
+        <td><%= core_based_statistical_area.metropolitan? ? "Metropolitan" : "Micropolitan" %> Area</td>
+        <% unless defined?(combined_statistical_area) && combined_statistical_area %>
+          <td>
+            <% if core_based_statistical_area.combined_statistical_area %>
+              <%= link_to core_based_statistical_area.combined_statistical_area.name, combined_statistical_area_path(core_based_statistical_area.combined_statistical_area) %>
+            <% else %>
+              -
+            <% end %>
+          </td>
+        <% end %>
+        <%= demographics_cells(core_based_statistical_area, round_area: 0) %>
+      </tr>
+    <% end %>
+  </tbody>
+</table>

data/explorer_app/app/views/core_based_statistical_areas/index.html.erb

@@ -0,0 +1,19 @@
+<%= breadcrumbs "Core Based Statistical Areas" %>
+
+<ul class="nav nav-tabs">
+  <li class="nav-item">
+    <%= link_to "All", core_based_statistical_areas_path(breadcrumb_params.merge(tab: nil)), class: "nav-link #{'active' if @tab.blank?}" %>
+  </li>
+  <li class="nav-item">
+    <%= link_to "Metropolitan Areas", core_based_statistical_areas_path(breadcrumb_params.merge(tab: "metropolitan")), class: "nav-link #{'active' if @tab == 'metropolitan'}" %>
+  </li>
+  <li class="nav-item">
+    <%= link_to "Micropolitan Areas", core_based_statistical_areas_path(breadcrumb_params.merge(tab: "micropolitan")), class: "nav-link #{'active' if @tab == 'micropolitan'}" %>
+  </li>
+</ul>
+
+<h1>
+  <%= pluralize @core_based_statistical_areas.size, "Core Based Statistical Area" %>
+</h1>
+
+<%= render "table", core_based_statistical_areas: @core_based_statistical_areas, combined_statistical_area: @combined_statistical_area %>

data/explorer_app/app/views/core_based_statistical_areas/show.html.erb

@@ -0,0 +1,60 @@
+<%= breadcrumbs @core_based_statistical_area.name, active: @core_based_statistical_area %>
+
+<h1><%= @core_based_statistical_area.name %></h1>
+
+<table class="table table-striped">
+  <tbody>
+    <tr>
+      <th>GEOID</th>
+      <td><%= @core_based_statistical_area.geoid %></td>
+    </tr>
+    <tr>
+      <th>Short Name</th>
+      <td><%= @core_based_statistical_area.short_name %></td>
+    </tr>
+    <tr>
+      <th>Type</th>
+      <td><%= @core_based_statistical_area.metropolitan? ? "Metropolitan" : "Micropolitan" %> Area</td>
+    </tr>
+    <% if @core_based_statistical_area.combined_statistical_area %>
+      <tr>
+        <th>Combined Statistical Area</th>
+        <td><%= link_to @core_based_statistical_area.combined_statistical_area.name, combined_statistical_area_path(@core_based_statistical_area.combined_statistical_area) %></td>
+      </tr>
+    <% end %>
+    <tr>
+      <th>Population</th>
+      <td><%= formatted_number(@core_based_statistical_area.population) %></td>
+    </tr>
+    <tr>
+      <th>Housing Units</th>
+      <td><%= formatted_number(@core_based_statistical_area.housing_units) %></td>
+    </tr>
+    <tr>
+      <th>Land Area (mi<sup>2</sup>)</th>
+      <td><%= formatted_number(@core_based_statistical_area.land_area, round: 0) %></td>
+    </tr>
+    <tr>
+      <th>Water Area (mi<sup>2</sup>)</th>
+      <td><%= formatted_number(@core_based_statistical_area.water_area, round: 0) %></td>
+    </tr>
+    <tr>
+      <th>Coordinates</th>
+      <td><%= google_maps_link(@core_based_statistical_area) %></td>
+    </tr>
+  </tbody>
+</table>
+
+<% if @core_based_statistical_area.metropolitan_divisions.present? %>
+  <br>
+
+  <h2><%= pluralize(@core_based_statistical_area.metropolitan_divisions.count, "Metropolitan Divisions") %></h2>
+
+  <%= render "metropolitan_divisions/table", metropolitan_divisions: @core_based_statistical_area.metropolitan_divisions, core_based_statistical_area: @core_based_statistical_area %>
+<% end %>
+
+<br>
+
+<h2><%= pluralize(@core_based_statistical_area.counties.count, "County") %></h2>
+
+<%= render "counties/table", counties: @core_based_statistical_area.counties, core_based_statistical_area: @core_based_statistical_area %>

data/explorer_app/app/views/counties/_table.html.erb

@@ -0,0 +1,64 @@
+<%
+  urban_area ||= nil
+  zcta ||= nil
+  overlap = (urban_area || zcta)
+%>
+
+<table class="table table-striped sortable">
+  <thead>
+    <tr>
+      <th>GEOID</th>
+      <th>Name</th>
+      <% unless defined?(state) && state %>
+        <th>State</th>
+      <% end %>
+      <% unless defined?(core_based_statistical_area) && core_based_statistical_area %>
+        <th>Core Based Statistical Area</th>
+      <% else %>
+        <th>CBSA Position</th>
+      <% end %>
+      <th>FIPS Class Code</th>
+
+      <%= demographics_headers %>
+
+      <% if overlap %>
+        <th class="text-end">Overlap</th>
+      <% end %>
+    </th>
+  </thead>
+  <tbody>
+    <% counties.each do |county| %>
+      <tr>
+        <td><%= county.geoid %></td>
+        <td><%= link_to county.name, county_path(county, breadcrumb_params) %></td>
+        <% unless defined?(state) && state %>
+          <td><%= county.state.name %></td>
+        <% end %>
+        <% if defined?(core_based_statistical_area) && core_based_statistical_area %>
+          <td><%= county.central? ? "Central" : "Outlying" %></td>
+        <% else %>
+          <td>
+            <% if county.core_based_statistical_area %>
+              <%= link_to county.core_based_statistical_area.name, core_based_statistical_area_path(county.core_based_statistical_area) %>
+            <% else %>
+              -
+            <% end %>
+          </td>
+        <% end %>
+        <td><%= county.fips_class_code %></td>
+
+        <%= demographics_cells(county, round_area: 0) %>
+
+        <% if overlap %>
+          <td class="text-end">
+            <% if urban_area %>
+              <%= overlap_percentage(urban_area, county, :urban_area_counties) %>
+            <% elsif zcta %>
+              <%= overlap_percentage(zcta, county, :zcta_counties) %>
+            <% end %>
+          </td>
+        <% end %>
+      </tr>
+    <% end %>
+  </tbody>
+</table>

data/explorer_app/app/views/counties/show.html.erb

@@ -0,0 +1,96 @@
+<%= breadcrumbs @county.full_name, active: @county %>
+
+<h1><%= @county.name %></h1>
+
+<table class="table table-striped">
+  <tbody>
+    <tr>
+      <th>GEOID</th>
+      <td><%= @county.geoid %></td>
+    </tr>
+    <tr>
+      <th>Short Name</th>
+      <td><%= @county.short_name %></td>
+    </tr>
+    <tr>
+      <th>State</th>
+      <td><%= link_to @county.state.name, state_path(@county.state, breadcrumb_params) %></td>
+    </tr>
+     <tr>
+      <th>FIP Class Code</th>
+      <td><%= @county.fips_class_code %></td>
+    </tr>
+   <tr>
+      <th>Time Zone</th>
+      <td><%= @county&.time_zones.collect(&:name).join(", ") %></td>
+    </tr>
+    <% if @county.combined_statistical_area %>
+      <tr>
+        <th>Combined Statistical Area</th>
+        <td><%= link_to @county.combined_statistical_area.name, combined_statistical_area_path(@county.combined_statistical_area, breadcrumb_params) %></td>
+      </tr>
+    <% end %>
+    <% if @county.core_based_statistical_area %>
+      <tr>
+        <th>Core Based Statistical Area</th>
+        <td><%= link_to @county.core_based_statistical_area.name, core_based_statistical_area_path(@county.core_based_statistical_area, breadcrumb_params) %></td>
+      </tr>
+    <% end %>
+    <% if @county.metropolitan_division %>
+      <tr>
+        <th>Metropolitan Division</th>
+        <td><%= link_to @county.metropolitan_division.name, metropolitan_division_path(@county.metropolitan_division, breadcrumb_params) %></td>
+      </tr>
+    <% end %>
+    <tr>
+      <th>Population</th>
+      <td><%= formatted_number(@county.population) %></td>
+    </tr>
+    <tr>
+      <th>Population Density</th>
+      <td><%= population_density(@county) %></td>
+    </tr>
+    <tr>
+      <th>Housing Units</th>
+      <td><%= formatted_number(@county.housing_units) %></td>
+    </tr>
+    <tr>
+      <th>Land Area (mi<sup>2</sup>)</th>
+      <td><%= formatted_number(@county.land_area, round: 0) %></td>
+    </tr>
+    <tr>
+      <th>Water Area (mi<sup>2</sup>)</th>
+      <td><%= formatted_number(@county.water_area, round: 0) %></td>
+    </tr>
+    <tr>
+      <th>Coordinates</th>
+      <td><%= google_maps_link(@county) %></td>
+    </tr>
+  </tbody>
+</table>
+
+<% if @county.urban_areas.present? %>
+  <br>
+
+  <h2><%= pluralize(@county.urban_areas.count, "Urban Area") %></h2>
+
+  <%= render "urban_areas/table", urban_areas: @county.urban_areas, county: @county %>
+<% end %>
+
+<br>
+
+<h2><%= pluralize(@county.subdivisions.count, "County Subdivision") %></h2>
+
+<%= render "county_subdivisions/table", county_subdivisions: @county.subdivisions, county: @county %>
+
+<br>
+
+<h2><%= pluralize(@county.places.count, "Place") %></h2>
+
+<%= render "places/table", places: @county.places, county: @county %>
+
+<br>
+
+<h2><%= pluralize(@county.zctas.count, "ZIP Code Tabulation Area") %></h2>
+
+<%= render "zctas/table", zctas: @county.zctas, county: @county %>

data/explorer_app/app/views/county_subdivisions/_table.html.erb

@@ -0,0 +1,48 @@
+<%
+  urban_area ||= nil
+  zcta ||= nil
+  overlap = (urban_area || zcta)
+%>
+
+<table class="table table-striped sortable">
+  <thead>
+    <tr>
+      <th>GEOID</th>
+      <th>Name</th>
+      <% unless defined?(county) && county %>
+        <th>County</th>
+      <% end %>
+      <th>FIPS Class Code</th>
+
+      <%= demographics_headers %>
+
+      <% if overlap %>
+        <th class="text-end">Overlap</th>
+      <% end %>
+    </th>
+  </thead>
+  <tbody>
+    <% county_subdivisions.each do |county_subdivision| %>
+      <tr>
+        <td><%= county_subdivision.geoid %></td>
+        <td><%= link_to county_subdivision.name, county_subdivision_path(county_subdivision, breadcrumb_params) %></td>
+        <% unless defined?(county) && county %>
+          <td><%= link_to county_subdivision.county.full_name, county_path(county_subdivision.county, breadcrumb_params) %></td>
+        <% end %>
+        <td><%= county_subdivision.fips_class_code %></td>
+
+        <%= demographics_cells(county_subdivision, round_area: 1) %>
+
+        <% if overlap %>
+          <td class="text-end">
+            <% if urban_area %>
+              <%= overlap_percentage(urban_area, county_subdivision, :urban_area_county_subdivisions) %>
+            <% elsif zcta %>
+              <%= overlap_percentage(zcta, county_subdivision, :zcta_county_subdivisions) %>
+            <% end %>
+          </td>
+        <% end %>
+      </tr>
+    <% end %>
+  </tbody>
+</table>