postcodes_io 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a025c5964930e2fdd31f1d4ac696d14ef8db7244
-  data.tar.gz: 3d5e0090a957e1a6af46f68d1204eb0c2ee9b5a9
+  metadata.gz: 2af10edff2373cf3d3de97762a174f7e1da23241
+  data.tar.gz: 5916275a146d0a847586aff21213c96909f66e5d
 SHA512:
-  metadata.gz: 5ca6179bdb36644e0d64dc65f3ff37efa574cbe9e0440200ef788514de7728c9c6d0fa95c87adaa258022f0d8aca834d4c0177c4ef8de817ab2610bc6e98727d
-  data.tar.gz: 1cc677ceaf30e1c0db12e0c44d604a77b35b44d05533a81440e545553806fca89f1f7222bfaa8b1fa321b9fd8f4b00a9cb78ae35b8b8048896e331349a7e3ea6
+  metadata.gz: b1f5a7279e5f42b2a5409c515b3ca94d7c1efdcb4f79d63dedc47a49064b4374bc5b9a520c7d3633e2883e21bdb3d10894522371209bd514e49aee45a13c3836
+  data.tar.gz: 25036a30da99012db100939d972250b82590bc1c298b907b1cf9d722f39fccbbb61d38671cabda92ac22ba2847fcf643a9e3f06883c6e5f64a56fd0b98f8c1cd

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+ - 2.3

data/README.md

@@ -1,3 +1,4 @@
+[![Build Status](https://travis-ci.org/jamesruston/postcodes_io.svg?branch=master)](https://travis-ci.org/jamesruston/postcodes_io)
 # PostcodesIo
 
 A simple wrapper around [postcodes.io](http://postcodes.io/)
@@ -32,7 +33,7 @@ Create new instance of the Postcodes::IO
 pio = Postcodes::IO.new
 ```
 
-####Lookup a postcode
+### Lookup a postcode
 ```ruby
 postcode = pio.lookup('NN12 8TN')
 ```
@@ -43,7 +44,7 @@ postcode.longitude # -1.02144562675883
 postcode.latitude # 52.0776806788868
 ```
 
-####Make a batch postcode lookup request
+### Make a batch postcode lookup request
 
 > max 100 postcodes per request
 
@@ -54,14 +55,22 @@ postcodes.each do |p|
 end
 ```
 
-####Autocomplete a postcode
+### Autocomplete a postcode
 
 ```ruby
 postcodes = pio.autocomplete('NN12')
 puts postcodes.list # ["NN12 6AA", "NN12 6AB", "NN12 6AD", "NN12 6AE", "NN12 6AF", "NN12 6AG", "NN12 6AH", "NN12 6AJ", "NN12 6AL", "NN12 6AN"]
 ```
 
-##All available fields
+
+### Perform a reverse geocode lookup
+
+```ruby
+postcodes = pio.reverse_geocode(longitude: 0.629834, latitude: 51.79232)
+puts postcodes.first.postcode # CM8 1EF
+```
+
+### All available fields
 
 |name|description|
 |----|-----------|
@@ -82,14 +91,14 @@ puts postcodes.list # ["NN12 6AA", "NN12 6AB", "NN12 6AD", "NN12 6AE", "NN12 6AF
 |region| [former GORs](http://www.ons.gov.uk/ons/guide-method/geography/beginner-s-guide/administrative/england/government-office-regions/index.html)|
 |parish| The smallest type of administrative area|
 |lsoa| [The 2011 Census lower layer SOA code](http://www.ons.gov.uk/ons/guide-method/geography/beginner-s-guide/census/super-output-areas--soas-/index.html)|
-|msoa| [The 2011 Census middle layer SOA (MSOA) code](The 2011 Census lower layer SOA code for England and Wales](http://www.ons.gov.uk/ons/guide-method/geography/beginner-s-guide/census/super-output-areas--soas-/index.html)|
+|msoa| [The 2011 Census middle layer SOA (MSOA) code](http://www.ons.gov.uk/ons/guide-method/geography/beginner-s-guide/census/super-output-areas--soas-/index.html)|
 |ccg| Clinical Commissioning Group |
 |nuts| [see here](http://en.wikipedia.org/wiki/Nomenclature_of_Territorial_Units_for_Statistics)|
 
 For more details see [the documentation on postcodes.io](http://postcodes.io/docs)
 ## Contributing
 
-1. Fork it ( https://github.com/[my-github-username]/postcodes_io/fork )
+1. Fork it ( https://github.com/jamesruston/postcodes_io/fork )
 2. Create your feature branch (`git checkout -b my-new-feature`)
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)

data/Rakefile

@@ -1,5 +1,10 @@
-require "bundler/gem_tasks"
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec) 
+
+task default: :spec
 
 task :console do
   exec "irb -r postcodes_io -I ./lib"
-end
+end

data/lib/postcodes_io.rb

@@ -2,10 +2,12 @@ require "postcodes_io/version"
 require "postcodes_io/lookup"
 require "postcodes_io/autocomplete"
 require "postcodes_io/postcode"
+require "postcodes_io/reverse_geocode"
 
 module Postcodes
   class IO
     include Lookup
     include Autocomplete
+    include ReverseGeocode
   end
 end

data/lib/postcodes_io/reverse_geocode.rb

@@ -0,0 +1,20 @@
+require 'excon'
+require 'json'
+require 'postcodes_io/postcode'
+
+module Postcodes
+  module ReverseGeocode
+    def reverse_geocode(longitude:, latitude:, limit: 10, radius: 100, wide_search: false)
+      response = Excon.get(
+        "https://api.postcodes.io/postcodes?lon=#{longitude}&lat=#{latitude}&limit=#{limit}&radius=#{radius}&wideSearch=#{wide_search}")
+      return unless response.status == 200
+
+      json = JSON.parse(response.body)
+      return unless json['result']
+
+      json['result'].map do |result|
+        Postcode.new(result)
+      end
+    end
+  end
+end

data/lib/postcodes_io/version.rb

@@ -1,3 +1,3 @@
 module Postcodes
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

data/spec/fixtures/no_results_response.json

@@ -0,0 +1 @@
+{"status":200,"result":null}

data/spec/fixtures/reverse_geocode_response.json

@@ -0,0 +1 @@
+{"status":200,"result":[{"postcode":"PR7 4HF","quality":1,"eastings":360059,"northings":412765,"country":"England","nhs_ha":"North West","longitude":-2.60515477763266,"latitude":53.6099106263766,"european_electoral_region":"North West","primary_care_trust":"Central Lancashire","region":"North West","lsoa":"Chorley 014C","msoa":"Chorley 014","incode":"4HF","outcode":"PR7","distance":0,"parliamentary_constituency":"Chorley","admin_district":"Chorley","parish":"Adlington","admin_county":"Lancashire","admin_ward":"Adlington and Anderton","ccg":"NHS Chorley and South Ribble","nuts":"Chorley and West Lancashire","codes":{"admin_district":"E07000118","admin_county":"E10000017","admin_ward":"E05005165","parish":"E04005139","parliamentary_constituency":"E14000637","ccg":"E38000034","nuts":"UKD47"}},{"postcode":"PR7 4HR","quality":1,"eastings":360038,"northings":412741,"country":"England","nhs_ha":"North West","longitude":-2.60546907187036,"latitude":53.6096933152903,"european_electoral_region":"North West","primary_care_trust":"Central Lancashire","region":"North West","lsoa":"Chorley 014C","msoa":"Chorley 014","incode":"4HR","outcode":"PR7","distance":31.90158431,"parliamentary_constituency":"Chorley","admin_district":"Chorley","parish":"Adlington","admin_county":"Lancashire","admin_ward":"Adlington and Anderton","ccg":"NHS Chorley and South Ribble","nuts":"Chorley and West Lancashire","codes":{"admin_district":"E07000118","admin_county":"E10000017","admin_ward":"E05005165","parish":"E04005139","parliamentary_constituency":"E14000637","ccg":"E38000034","nuts":"UKD47"}},{"postcode":"PR7 4HJ","quality":1,"eastings":360076,"northings":412843,"country":"England","nhs_ha":"North West","longitude":-2.60490787349104,"latitude":53.6106129688375,"european_electoral_region":"North West","primary_care_trust":"Central Lancashire","region":"North West","lsoa":"Chorley 014C","msoa":"Chorley 014","incode":"4HJ","outcode":"PR7","distance":79.85903188,"parliamentary_constituency":"Chorley","admin_district":"Chorley","parish":"Adlington","admin_county":"Lancashire","admin_ward":"Adlington and Anderton","ccg":"NHS Chorley and South Ribble","nuts":"Chorley and West Lancashire","codes":{"admin_district":"E07000118","admin_county":"E10000017","admin_ward":"E05005165","parish":"E04005139","parliamentary_constituency":"E14000637","ccg":"E38000034","nuts":"UKD47"}}]}

data/spec/reverse_geocode_spec.rb

@@ -0,0 +1,52 @@
+require 'spec_helper'
+
+RSpec.describe Postcodes::IO, '#reverse_geocode' do
+  let(:latitiude) { '53.6099106263766' }
+  let(:longitude) { '2.60515477763266' }
+  let(:base_url) { 'https://api.postcodes.io' }
+  let(:url) { "#{base_url}/postcodes?lon=#{longitude}&lat=#{latitiude}&limit=10&radius=100&wideSearch=false" }
+  let(:no_results_response) do
+    File.read('spec/fixtures/no_results_response.json')
+  end
+  let(:reverse_geocode_response) do
+    File.read('spec/fixtures/reverse_geocode_response.json')
+  end
+
+  subject(:reverse_geocode) do
+    described_class.new.reverse_geocode(
+      longitude: longitude, latitude: latitiude)
+  end
+
+  context 'when a 400 is returned' do
+    before do
+      stub_request(:get, url).to_return(status: 400)
+    end
+
+    it { is_expected.to be_nil }
+  end
+
+  context 'when there are no results returned' do
+    before do
+      stub_request(:get, url).to_return(status: 200, body: no_results_response)
+    end
+
+    it { is_expected.to be_nil }
+  end
+
+  context 'when results are returned' do
+    before do
+      stub_request(:get, url)
+        .to_return(status: 200, body: reverse_geocode_response)
+    end
+
+    it 'returns the correct number of postcodes' do
+      expect(reverse_geocode.count).to eq(3)
+    end
+
+    it 'instantiates an object for each returned postcode' do
+      reverse_geocode.each do |result|
+        expect(result).to be_a(Postcodes::Postcode)
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: postcodes_io
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - James Ruston
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-02-17 00:00:00.000000000 Z
+date: 2018-01-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -89,6 +89,7 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".rspec"
+- ".travis.yml"
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -99,14 +100,18 @@ files:
 - lib/postcodes_io/base.rb
 - lib/postcodes_io/lookup.rb
 - lib/postcodes_io/postcode.rb
+- lib/postcodes_io/reverse_geocode.rb
 - lib/postcodes_io/version.rb
 - postcodes_io.gemspec
 - spec/autocomplete_spec.rb
 - spec/fixtures/autocomplete_response.json
 - spec/fixtures/lookup_multi_response.json
 - spec/fixtures/lookup_response.json
+- spec/fixtures/no_results_response.json
+- spec/fixtures/reverse_geocode_response.json
 - spec/lookup_spec.rb
 - spec/postcode_io_spec.rb
+- spec/reverse_geocode_spec.rb
 - spec/spec_helper.rb
 homepage: ''
 licenses:
@@ -137,6 +142,9 @@ test_files:
 - spec/fixtures/autocomplete_response.json
 - spec/fixtures/lookup_multi_response.json
 - spec/fixtures/lookup_response.json
+- spec/fixtures/no_results_response.json
+- spec/fixtures/reverse_geocode_response.json
 - spec/lookup_spec.rb
 - spec/postcode_io_spec.rb
+- spec/reverse_geocode_spec.rb
 - spec/spec_helper.rb