blob: 119214f912608985fa8555ae9baeef98a008047f (
plain) (
tree)
|
|
Search postcodes for Norway
===========================
This gem is a simple interface to the Norwegian postcode database published by Bring. It allows you to search for and retreive entries in the postcode database.
A rake task is included to fetch the actual postcode data as published by Bring.
Installation
------------
In your Gemfile, add the following:
gem 'postcodes-norway'
Then run `bundle install` as usual.
Fetch the data:
rake postcodes:fetch[output_dir]
A file named "Postnummerregister_ansi.txt" will be placed in the specified `output_dir`.
Usage
-----
Initialize the library:
require 'postcodes-norway'
PostCodes.load('output_dir/Postnummerregister_ansi.txt')
Query for some postcodes:
p1 = PostCodes.search(1326)
puts p1.city # => "LYSAKER"
puts p1.municipality_name # => "BÆRUM"
puts p1.county # => [2, "AKERSHUS"]
p2 = PostCodes.search('0666')
puts p2.city # => "OSLO"
puts p2.municipality_name # => "OSLO"
puts p2.county # => [3, "OSLO"]
Contributing
------------
Feel free to send suggestions or pull requests.
License
-------
Copyright (C) 2015 Harald Eilertsen
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
|