Class: ElectricityRate

Inherits:

Object

Object
ElectricityRate

show all

Defined in:: app/models/electricity_rate.rb

Overview

Per-state / per-utility electricity-rate lookups powered by the NREL
Utility Rates API. Used by the heat-loss and operating-cost calculators
on the public website to estimate "$/year to run this floor heater"
given a customer's location.

Constant Summary collapse

US_API_URL = See Also: API details

'https://developer.nrel.gov/api/utility_rates/v3.json'.freeze

US_API_KEY = Key used for us api.

'pNYthBjsnd8WKS85K9qkg6mkZ2gISU6iPchwqdKi'.freeze

CAN_RATE_BY_PROVINCE = Updated December 2025 Source: https://offgridsolarsystem.ca/blog/Canada-electricity-rates.html (July 2025) These are MARGINAL rates (Tier 2 / Step 2) for provinces with tiered pricing. Floor heating is additive consumption, so customers pay the higher tier rate, not the blended average. BC: Step 2 rate (14.08¢) used instead of Step 1 (11.72¢) QC: Tier 2 rate (10.7¢) used instead of blended average (7.8¢) per Hydro-Québec Rate D ON: Mid-peak TOU rate (15.7¢) used as representative rate for additional heating load

{
  'AB' => 0.258,  # Alberta - includes delivery & admin charges
  'BC' => 0.141,  # BC Hydro Step 2 rate (14.08¢ rounded)
  'MB' => 0.102,  # Manitoba Hydro
  'NB' => 0.139,  # NB Power
  'NL' => 0.148,  # NL Hydro / Newfoundland Power
  'NS' => 0.183,  # Nova Scotia Power
  'NT' => 0.410,  # NTPC (high due to diesel generation)
  'NU' => 0.354,  # Qulliq Energy Corp
  'ON' => 0.157,  # Ontario - mid-peak TOU rate (Nov 2025)
  'PE' => 0.184,  # Maritime Electric
  'QC' => 0.110,  # Hydro-Québec Tier 2 rate (~10.7¢)
  'SK' => 0.199,  # SaskPower
  'YT' => 0.187   # Yukon Energy / ATCO Electric
}.freeze

US_RATE_BY_STATE = https://www.saveonenergy.com/electricity-rates/electricity-rates-by-state/ as of 12/2024, updated 3/4/2025

{
  'AL' => 0.1491,
  'AK' => 0.2238,
  'AZ' => 0.1520,
  'AR' => 0.1174,
  'CA' => 0.3055,
  'CO' => 0.1516,
  'CT' => 0.2816,
  'DE' => 0.1668,
  'DC' => 0.1626, # This one i don't know it's not from that table, i used the average
  'FL' => 0.1420,
  'GA' => 0.1349,
  'HI' => 0.4234,
  'ID' => 0.1097,
  'IL' => 0.1599,
  'IN' => 0.1442,
  'IA' => 0.1243,
  'KS' => 0.1385,
  'KY' => 0.1328,
  'LA' => 0.1170,
  'ME' => 0.2629,
  'MD' => 0.1815,
  'MA' => 0.3122,
  'MI' => 0.1841,
  'MN' => 0.1405,
  'MS' => 0.1344,
  'MO' => 0.1157,
  'MT' => 0.1187,
  'NE' => 0.1078,
  'NV' => 0.1488,
  'NH' => 0.2362,
  'NJ' => 0.1949,
  'NM' => 0.1426,
  'NY' => 0.2437,
  'NC' => 0.1349,
  'ND' => 0.1021,
  'OH' => 0.1598,
  'OK' => 0.1152,
  'OR' => 0.1412,
  'PA' => 0.1760,
  'RI' => 0.2531,
  'SC' => 0.1387,
  'SD' => 0.1241,
  'TN' => 0.1304,
  'TX' => 0.1542,
  'UT' => 0.1102,
  'VT' => 0.2229,
  'VA' => 0.1446,
  'WA' => 0.1183,
  'WV' => 0.1451,
  'WI' => 0.1631,
  'WY' => 0.1178
}.freeze

ALL_STATES_AND_PROVINCES = All states and provinces.

CAN_RATE_BY_PROVINCE.merge(US_RATE_BY_STATE).freeze

CAN_AVERAGE_RATE = Canadian average rate - used as fallback when province cannot be determined. This is a weighted average biased toward Tier 2/marginal rates to better reflect the cost of additional consumption like floor heating. Updated December 2025 based on provincial rates above.

0.175

US_AVERAGE_RATE = US average rate - updated March 2025 Source: https://www.saveonenergy.com/electricity-rates/electricity-rates-by-state/

0.1626

RATES_BY_COUNTRY = Rates by country.

{
  'USA' => US_AVERAGE_RATE,
  'CAN' => CAN_AVERAGE_RATE
}.freeze

RATES_BY_COUNTRY_ISO = Rates by country iso.

{
  'US' => US_AVERAGE_RATE,
  'CA' => CAN_AVERAGE_RATE
}.freeze

POSTAL_CA_REGEXP = This regexp can handle regional postal code as well as full canadian postal codes

/^([ABCEGHJ-NPRSTVXY]\d[ABCEGHJ-NPRSTV-Z])([ -]?\d[ABCEGHJ-NPRSTV-Z]\d)?$/i

POSTAL_US_REGEXP = This one handles US with +4 optional

/^(\d{5})(-{0,1}\d{4})?$/