fcc

Query the FCC database for fm, am, and tv information.

Install

gem install fcc

Requirements

  • Ruby 2.0.0 or higher

Examples

Get station information by call sign

station = FCC::Station.find(:fm, "KOOP")

#Basic attributes, available quickly because the FCC actually caches these in a CDN: 
station.id #=> 65320
station.status #=> LICENSED
station.rf_channel #=> 219
station.license_expiration_date #=> "08/01/2021"
station.facility_type #=> ED
station.frequency #=> 91.7 
station.contact #=> <struct FCC::Station::Contact>
station.owner #=> <struct FCC::Station::Contact>
station.community #=> <struct FCC::Station::Community city="HORNSBY", state="TX">

#Extended attributes, takes several seconds to load because the FCC is running this endpoint on a 1960s era mainframe operated by trained hamsters
station.station_class #=> A
station.signal_strength #=> 3.0 kW
station.antenna_type #=> ND
station.effective_radiated_power #=> 3.0 kW
station.haat_horizontal #=> 26.0
station.haat_vertical #=> 26.0
station.latitude #=> "30.266861111111112"
station.longitude #=> "-97.67444444444445"
station.file_number #=> BLED-19950103KA

Get all station call signs on a particular service (:fm, :am, :tv)

results = FCC::Station.index(:fm).results
#=> [{"id"=>"198674", "callSign"=>"KANC", "frequency"=>"99.7", "activeInd"=>"Y"}, {"id"=>"174558", "callSign"=>"WUMZ", "frequency"=>"91.5", "activeInd"=>"Y"}, {"id"=>"184688", "callSign"=>"WHVC", "frequency"=>"102.5", "activeInd"=>"Y"} ....

Contributing to fcc

  • Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
  • Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
  • Fork the project
  • Start a feature/bugfix branch
  • Commit and push until you are happy with your contribution
  • Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
  • Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.