Gem to obtain postal codes for US and CA only.
Add this line to your application's Gemfile:
gem 'postal-codes-search', '~> 1.1'
And then execute:
$ bundle
Or install it yourself as:
$ gem install postal-codes-search
You can search generally by any keyword like country, county, postal code, state and or city like this
PostalCodesSearch.find('Y1A')
# => [{"country"=>"CA", "postal_code"=>"Y1A", "city"=>"Whitehorse", "state"=>"Yukon", "county"=>nil}]
# This will return an array. If you put an incomplete postal code, it will return the most similar resultsYou can use more specific search depending on the attribute you want to use
PostalCodesSearch.find_by(code: 'Y1A')
# => [{"country"=>"CA", "postal_code"=>"Y1A", "city"=>"Whitehorse", "state"=>"Yukon", "county"=>nil}]PostalCodesSearch.find_by(country: 'US').count
# => 41469PostalCodesSearch.find_by(county: 'Yukon-Koyukuk').first
# => {"country"=>"US", "postal_code"=>99558, "city"=>"Anvik", "state"=>"Alaska", "county"=>"Yukon-Koyukuk (CA)"}PostalCodesSearch.find_by(state: 'Alaska').count
# => 273PostalCodesSearch.find_by(city: 'Venetie')
# => [{"country"=>"US", "postal_code"=>99781, "city"=>"Venetie", "state"=>"Alaska", "county"=>"Yukon-Koyukuk (CA)"}]Using rails, you can load all the values in a initializer
# config/initializers/postal_codes.rb
PostalCodesSearch.load unless Rails.env.development?- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create new Pull Request