here_places 0.0.2 → 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ca349103c0d8faa2555209ea0c87aa79b169338f
+  data.tar.gz: 7b1a4f99310c45b27ba527a1350e91ddecb14edb
+SHA512:
+  metadata.gz: 7bb67e78d3b28612e9405c211dab28896b8d9b290d7d0cac98a41882d3292dc3e33230df0109b2bc9a201935fc7ef6379ea5c340005b79c88d9ad8e9df3de8e4
+  data.tar.gz: e62fcce6f18998fc3ed8a87478c12a0f59417021a479027c3f37efc48ec609640c5f0872f51b5f5c1dbbf99aec3facea31486485a639af8193cda0fa9260d016

data/README.md

@@ -1,3 +1,5 @@
+[![wercker status](https://app.wercker.com/status/81bd9481a9248f8faadc499fe46321b1/s "wercker status")](https://app.wercker.com/project/bykey/81bd9481a9248f8faadc499fe46321b1)
+
 # HerePlaces
 A wafer-thin Ruby wrapper for accessing Nokia's Here Maps Places API.  
 Read more about the official API here: <http://developer.here.net/>
@@ -13,7 +15,7 @@ And then execute:
 
     $ bundle
 
-Or install it yourself as:
+Or install it with:
 
     $ gem install here_places
 
@@ -27,12 +29,19 @@ To start using the APIs, register for a Nokia Developer Account <http://develope
 
 * * *
 
+### Set up the API creds 
+
+```ruby
+HerePlaces.set_keys(:app_id, :app_code)
+```
+
 ### Discover API 
 
 #### Searching <http://developer.here.net/docs/places/topics/resource-search.html>  
 
 The search resource represent sets of places that match a user's search term in a specific location context (such as near a given location, around a user's current position or on the currently visible map).
 
+```ruby
     require 'here_places'
     app_id = "YOUR_APP_ID"
     app_code = "YOUR_APP_CODE"
@@ -40,14 +49,16 @@ The search resource represent sets of places that match a user's search term in
       q: 'Cafe',
       at: '40.74917,-73.98529',
     }
-    api = HerePlaces::Discover.new(app_id, app_code)
+    api = HerePlaces::Discover.new
     a = api.search(data)
+```
 
 #### Exploring <http://developer.here.net/docs/places/topics/resource-explore.html>  
 
 The explore resource represent sets of popular places within a specific location context. The explore resource allows users to explore places without typing search queries. An explore resource's location context might be an explicitly given location or implicitly defined by a user's current position or the currently visible map. Optionally, the places may be restricted to a given set of categories.
 `at` and `in` parameter are mutually exclusive and can't be passed at the same time
 
+```ruby
     require 'here_places'
     app_id = "YOUR_APP_ID"
     app_code = "YOUR_APP_CODE"
@@ -55,13 +66,15 @@ The explore resource represent sets of popular places within a specific location
       cat: 'natural-geographical',
       at: '40.74917,-73.98529',
     }
-    api = HerePlaces::Discover.new(app_id, app_code)
+    api = HerePlaces::Discover.new
     a = api.explore(data)
+```
     
 #### Here <http://developer.here.net/docs/places/topics/resource-discover-here.html>  
 
 The discover here resource represent sets of places within a specific location context. The Discover Here resource allows users to request places near to a given point, based on a location precision parameter which must be provided. If the precision is high, the places around that point are returned in order of proximity. Otherwise, a set of recommended places in the area is returned.
 
+```ruby
     require 'here_places'
     app_id = "YOUR_APP_ID"
     app_code = "YOUR_APP_CODE"
@@ -69,37 +82,19 @@ The discover here resource represent sets of places within a specific location c
       cat: 'natural-geographical',
       at: '40.7063,-73.9971;u=0',
     }
-    api = HerePlaces::Discover.new(app_id, app_code)
+    api = HerePlaces::Discover.new
     a = api.here(data)
+```
 
 * * *
 
-### Places 
-
-#### The Place Resource <http://developer.here.net/docs/places/topics/resource-discover-here.html>  
-
-The place resource represent places on earth.
-Examples for places include:
-Places of (public) interest (POI)
-Addresses of buildings (Locations)
-Named areas and regions
-Each place is referenced by an identifier, called a placeId.
-
-    require 'here_places'
-    app_id = "YOUR_APP_ID"
-    app_code = "YOUR_APP_CODE"
-    id = '840dr5rs-5c0f37fabdc643938dd4f47db00d4ae8'
-    api = HerePlaces::Place.new(app_id, app_code)
-    a = api.places(id)
-
-* * *
-        
 ### Suggestions
 
 #### The Search Suggestion Resource <http://developer.here.net/docs/places/topics/resource-suggest.html>  
 
 The search suggestions resource represents lists of suggested search terms related to a given (partial) search term and location context.
 
+```ruby
     require 'here_places'
     app_id = "YOUR_APP_ID"
     app_code = "YOUR_APP_CODE"
@@ -107,8 +102,9 @@ The search suggestions resource represents lists of suggested search terms relat
       q: 'restaur',
       at: '40.7063,-73.9971',
     }
-    api = HerePlaces::Suggest.new(app_id, app_code)
+    api = HerePlaces::Suggest.new
     a = api.suggest(data)
+```
 
 * * *
 
@@ -118,14 +114,16 @@ The search suggestions resource represents lists of suggested search terms relat
 
 The category graph resource represents sets of locally relevant categories that are organized in a graph-like hierarchy. The category graph may change at any point in the future and may be different depending on the location of the request. A set of permanent, top-level, categories can be found [here](http://developer.here.net/docs/places/topics/categories.html).
 
+```ruby
     require 'here_places'
     app_id = "YOUR_APP_ID"
     app_code = "YOUR_APP_CODE"
     data = {
       at: '40.7063,-73.9971',
     }
-    api = HerePlaces::Category.new(app_id, app_code)
+    api = HerePlaces::Category.new
     a = api.places(data)
+```
 
 * * *
 
@@ -160,4 +158,4 @@ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
 LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
 OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/here_places.gemspec

@@ -5,7 +5,7 @@ require 'here_places/version'
 
 Gem::Specification.new do |gem|
   gem.name          = "here_places"
-  gem.version       = HerePlaces::VERSION 
+  gem.version       = HerePlaces::VERSION
   gem.authors       = ["Prem Pillai"]
   gem.email         = ["prem.pillai@gmail.com"]
   gem.description   = %q{A wafer-thin Ruby Wrapper for Nokia's Here Places API}
@@ -17,7 +17,8 @@ Gem::Specification.new do |gem|
   gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
   gem.test_files    = gem.files.grep(%r{^(test|spec|features|helper)/})
   gem.require_paths = ["lib"]
-  gem.add_development_dependency 'rspec', '~>2.1'
-  gem.add_development_dependency 'fakeweb', '~>1.3'
-  gem.add_dependency 'faraday', '~>0.8.4'
-end
+  gem.add_dependency 'faraday', '~>0.9.1'
+  gem.add_development_dependency 'rspec', '~>3.1'
+  gem.add_development_dependency 'vcr', '~>2.9'
+  gem.add_development_dependency 'webmock', '~>1.21'
+end

data/lib/here_places.rb

@@ -4,7 +4,6 @@ require_relative './here_places/base'
 require_relative './here_places/category'
 require_relative './here_places/discover'
 require_relative './here_places/error'
-require_relative './here_places/place'
 require_relative './here_places/suggest'
 
 # /discover/search?q=...&[at=...]
@@ -12,4 +11,22 @@ require_relative './here_places/suggest'
 # /discover/here?[at=...]
 # /places/{placeId}
 # /suggest?q=...&[at=...]
-# /categories/places?[at=...]
+# /categories/places?[at=...]
+
+module HerePlaces
+  BASE_URL = 'http://places.nlp.nokia.com/'.freeze
+  API_PREFIX = 'places/v1'.freeze
+
+  def self.set_keys(app_id, app_code)
+    @app_id = app_id
+    @app_code = app_code
+  end
+
+  def self.app_id
+    @app_id
+  end
+
+  def self.app_code
+    @app_code
+  end
+end

data/lib/here_places/base.rb

@@ -1,41 +1,42 @@
 module HerePlaces
   class Base
-    @@base_url = 'http://places.nlp.nokia.com/'
-    @@api_prefix = 'places/v1'
-
     attr_reader :conn
 
-    def initialize(app_id, app_code, log=false)
-      @app_id = app_id
-      @app_code = app_code
+    def initialize(log=false)
       @log = log
-      setup()
-    end
-    
-    def setup
-      @conn = Faraday.new(:url => @@base_url) do |faraday|
-        faraday.request  :url_encoded
-        faraday.response :logger if @log
-        faraday.adapter  Faraday.default_adapter
-      end
     end
 
-    def api(url_fragment, data={})
-      result = @conn.get do |req|
+    protected
+
+    def call_api(url_fragment, payload={})
+      result = connection.get do |req|
         req.url url_fragment
-        req.params['app_id'] = @app_id
-        req.params['app_code'] = @app_code
-        data.each do |key,value|
+        req.params['app_code'] = HerePlaces.app_code
+        req.params['app_id']   = HerePlaces.app_id
+        payload.each do |key,value|
           req.params[key] = value
         end
       end
-      
+
       parsed_result = JSON.parse(result.body)
-      if parsed_result["status"]
+
+      if result.status.to_i != 200
         raise HerePlaces::APIError.new(parsed_result), parsed_result['message']
       else
         parsed_result
       end
     end
+
+    private
+
+    attr_reader :log
+
+    def connection
+      @_connection ||= Faraday.new(:url => BASE_URL) do |faraday|
+        faraday.request  :url_encoded
+        faraday.response :logger if log
+        faraday.adapter  Faraday.default_adapter
+      end
+    end
   end
-end
+end

data/lib/here_places/category.rb

@@ -1,10 +1,13 @@
 module HerePlaces
   class Category < HerePlaces::Base
-    @@resource = 'categories'
+    def places(payload)
+      call_api(path, payload)
+    end
+
+    private
 
-    def places(data)
-      url = @@api_prefix + '/' + @@resource + '/' + 'places'
-      api(url, data)
+    def path
+      @_path ||= HerePlaces::API_PREFIX + '/' + 'categories' + '/' + 'places'
     end
   end
-end
+end

data/lib/here_places/discover.rb

@@ -1,11 +1,15 @@
 module HerePlaces
   class Discover < HerePlaces::Base
-    @@resource = 'discover'
     %w(search explore here).each do |meth|
-      define_method(meth) do |data|
-        url = @@api_prefix + '/' + @@resource + '/' + meth
-        api(url, data)
+      define_method(meth) do |payload|
+        call_api(path(meth), payload)
       end
     end
+
+    private
+
+    def path(meth)
+      HerePlaces::API_PREFIX + '/' + 'discover' + '/' + meth
+    end
   end
-end
+end

data/lib/here_places/error.rb

@@ -1,10 +1,10 @@
 module HerePlaces
   class APIError < StandardError
     attr_accessor :status, :error_message
-    
+
     def initialize(error)
       self.status = error["status"].to_i rescue 500
       self.error_message = error["error_message"] || 'Unknown Error'
     end
   end
-end
+end

data/lib/here_places/suggest.rb

@@ -1,10 +1,13 @@
 module HerePlaces
   class Suggest < HerePlaces::Base
-    @@resource = 'suggest'
-
     def suggest(data)
-      url = @@api_prefix + '/' + @@resource
-      api(url, data)
+      call_api(path, data)
+    end
+
+    private
+
+    def path
+      @_path ||= HerePlaces::API_PREFIX + '/' + 'suggest'
     end
   end
-end
+end

data/lib/here_places/version.rb

@@ -1,3 +1,3 @@
 module HerePlaces
-  VERSION = "0.0.2"
+  VERSION = "0.1.0"
 end

data/spec/category_spec.rb

@@ -1,18 +1,14 @@
 require 'spec_helper'
 
 describe HerePlaces::Category do
-  before(:each) do
-    app_id = 'APP_ID'
-    app_code = 'APP_CODE'
-    @data = {test: 'stuff'}
-    @h = HerePlaces::Category.new(app_id, app_code)
-    @h.stub!(:api)
-  end
+  let(:api) { described_class.new }
+  let(:payload) { { at: '52.5159,13.3777', cat: 'sights-museums' } }
 
-  it 'responds correctly to places method and delegates to the api call' do
-    resource_url = "#{API_PREFIX}/categories/places"
-    @h.should respond_to(:places)
-    @h.should_receive(:api).with(resource_url, @data)
-    @h.places(@data)
+  it "calls the api and returns results correctly" do
+    VCR.use_cassette("categories", record: :once) do
+      results = api.places(payload)
+      expect(results["items"][0]["title"]).to eq "Eat & Drink"
+    end
   end
-end
+
+end

data/spec/discover_spec.rb

@@ -1,20 +1,28 @@
 require 'spec_helper'
 
 describe HerePlaces::Discover do
-  before(:each) do
-    app_id = 'APP_ID'
-    app_code = 'APP_CODE'
-    @data = {test: 'stuff'}
-    @h = HerePlaces::Discover.new(app_id, app_code)
-    @h.stub!(:api)
+  let(:api) { described_class.new }
+  let(:payload) { { at: '52.5159,13.3777'} }
+
+  %w(explore here).each do |meth|
+    describe meth do
+      it "calls the api and returns results correctly" do
+        VCR.use_cassette("#{meth}", record: :once) do
+          results = api.send(:"#{meth}", payload)
+          expect(results["results"]["items"].count).to be > 0
+        end
+      end
+    end
   end
 
-  %w(search explore here).each do |meth|
-    it "responds correctly to #{meth} and delegates to the api call" do
-      resource_url = "#{API_PREFIX}/discover/#{meth}"
-      @h.should respond_to(meth.to_sym)
-      @h.should_receive(:api).with(resource_url, @data)
-      @h.send(meth.to_sym, @data)
+  describe "search" do
+    let(:payload) { { at: '52.5159,13.3777', q: 'Cafe'} }
+
+    it "calls the api and returns results correctly" do
+      VCR.use_cassette("search", record: :once) do
+        results = api.search(payload)
+        expect(results["results"]["items"].count).to be > 0
+      end
     end
   end
-end
+end

data/spec/error_spec.rb

@@ -0,0 +1,14 @@
+require 'spec_helper'
+
+describe "Error" do
+  let(:api) { HerePlaces::Suggest.new }
+  let(:payload) { { q: 'berl' } }
+
+  it "calls the api and returns results correctly" do
+    VCR.use_cassette("suggest-bad", record: :once) do
+      expect{
+        api.suggest(payload)
+      }.to raise_error HerePlaces::APIError
+    end
+  end
+end

data/spec/fixtures/vcr_cassettes/categories.yml

@@ -0,0 +1,99 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: http://places.nlp.nokia.com/places/v1/categories/places?app_code=<APP_CODE>&app_id=<APP_ID>&at=52.5159,13.3777&cat=sights-museums
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.9.1
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Cache-Control:
+      - max-age=7200, private, must-revalidate
+      Content-Language:
+      - en
+      Content-Type:
+      - application/json; charset=UTF-8
+      Date:
+      - Sat, 25 Apr 2015 12:21:26 GMT
+      Expires:
+      - Sat, 25 Apr 2015 14:21:26 GMT
+      Last-Modified:
+      - Tue, 21 Apr 2015 13:16:07 GMT
+      Set-Cookie:
+      - NLP.PP=e496f867-ef15-462b-96f8-67ef15862bdf;Path=/;Domain=.nlp.nokia.com;Expires=Thu,
+        22-Oct-2015 12:21:26 GMT
+      - NLP.PS=f9319e8f-edc0-4fd7-b19e-8fedc0bfd77e;Path=/;Domain=.nlp.nokia.com
+      Vary:
+      - Accept, Accept-Encoding, Accept-Language, X-Map-Viewport, Geolocation
+      X-Nlp-Tid:
+      - dae572b3-6e05-4eec-a572-b36e053eec66
+      Content-Length:
+      - '2270'
+      Connection:
+      - keep-alive
+    body:
+      encoding: UTF-8
+      string: '{"items":[{"id":"eat-drink","title":"Eat & Drink","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/03.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/eat-drink?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":[]},{"id":"restaurant","title":"Restaurant","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/03.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/restaurant?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["eat-drink"]},{"id":"snacks-fast-food","title":"Snacks/Fast
+        food","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/03.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/snacks-fast-food?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["eat-drink"]},{"id":"bar-pub","title":"Bar/Pub","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/22.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/bar-pub?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["eat-drink"]},{"id":"coffee-tea","title":"Coffee/Tea","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/23.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/coffee-tea?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["eat-drink"]},{"id":"coffee","title":"Coffee","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/23.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/coffee?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["coffee-tea"]},{"id":"tea","title":"Tea","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/23.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/tea?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["coffee-tea"]},{"id":"going-out","title":"Going
+        Out","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/05.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/going-out?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":[]},{"id":"dance-night-club","title":"Dance
+        or Nightclub","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/33.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/dance-night-club?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["going-out"]},{"id":"cinema","title":"Cinema","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/32.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/cinema?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["going-out"]},{"id":"theatre-music-culture","title":"Theatre,
+        Music & Culture","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/05.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/theatre-music-culture?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["going-out"]},{"id":"casino","title":"Casino","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/31.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/casino?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["going-out"]},{"id":"sights-museums","title":"Sights
+        & Museums","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/10.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/sights-museums?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":[]},{"id":"landmark-attraction","title":"Landmark/Attraction","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/38.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/landmark-attraction?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["sights-museums"]},{"id":"museum","title":"Museum","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/10.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/museum?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["sights-museums"]},{"id":"transport","title":"Transport","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/11.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/transport?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":[]},{"id":"airport","title":"Airport","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/40.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/airport?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["transport"]},{"id":"railway-station","title":"Railway
+        Station","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/43.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/railway-station?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["transport"]},{"id":"public-transport","title":"Public
+        Transport","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/11.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/public-transport?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["transport"]},{"id":"ferry-terminal","title":"Ferry
+        Terminal","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/41.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/ferry-terminal?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["transport"]},{"id":"taxi-stand","title":"Taxi
+        Stand","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/42.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/taxi-stand?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["transport"]},{"id":"accommodation","title":"Accommodation","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/01.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/accommodation?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":[]},{"id":"hotel","title":"Hotel","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/01.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/hotel?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["accommodation"]},{"id":"motel","title":"Motel","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/01.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/motel?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["accommodation"]},{"id":"hostel","title":"Hostel","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/01.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/hostel?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["accommodation"]},{"id":"camping","title":"Camping","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/14.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/camping?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["accommodation"]},{"id":"shopping","title":"Shopping","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/09.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/shopping?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":[]},{"id":"kiosk-convenience-store","title":"Kiosk/24-7/Convenience
+        Store","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/09.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/kiosk-convenience-store?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["shopping"]},{"id":"wine-and-liquor","title":"Wine
+        & Spirits","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/09.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/wine-and-liquor?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["kiosk-convenience-store"]},{"id":"mall","title":"Shopping
+        Centre","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/09.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/mall?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["shopping"]},{"id":"department-store","title":"Department
+        Store","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/09.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/department-store?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["shopping"]},{"id":"food-drink","title":"Food
+        & Drink","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/09.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/food-drink?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["shopping"]},{"id":"bookshop","title":"Book
+        Shop","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/09.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/bookshop?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["shopping"]},{"id":"pharmacy","title":"Chemist''s","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/37.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/pharmacy?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["shopping"]},{"id":"electronics-shop","title":"Electronics","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/09.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/electronics-shop?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["shopping"]},{"id":"hardware-house-garden-shop","title":"DIY/garden
+        centre","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/09.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/hardware-house-garden-shop?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["shopping"]},{"id":"clothing-accessories-shop","title":"Clothing
+        & Accessories","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/09.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/clothing-accessories-shop?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["shopping"]},{"id":"sport-outdoor-shop","title":"Outdoor
+        Sports","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/09.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/sport-outdoor-shop?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["shopping"]},{"id":"shop","title":"Shop","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/09.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/shop?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["shopping"]},{"id":"business-services","title":"Business
+        & Services","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/02.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/business-services?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":[]},{"id":"atm-bank-exchange","title":"ATM/Bank/Exchange","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/15.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/atm-bank-exchange?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["business-services"]},{"id":"police-emergency","title":"Police/Emergency","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/19.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/police-emergency?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["business-services"]},{"id":"ambulance-services","title":"Ambulance
+        Services","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/19.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/ambulance-services?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["police-emergency"]},{"id":"fire-department","title":"Fire
+        Brigade","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/19.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/fire-department?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["police-emergency"]},{"id":"police-station","title":"Police
+        Station","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/19.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/police-station?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["police-emergency"]},{"id":"post-office","title":"Post
+        Office","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/20.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/post-office?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["business-services"]},{"id":"tourist-information","title":"Tourist
+        Information","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/21.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/tourist-information?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["business-services"]},{"id":"petrol-station","title":"Petrol
+        Station","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/18.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/petrol-station?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["business-services"]},{"id":"car-rental","title":"Car
+        Hire","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/17.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/car-rental?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["business-services"]},{"id":"car-dealer-repair","title":"Car
+        Dealer/Repair","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/16.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/car-dealer-repair?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["business-services"]},{"id":"travel-agency","title":"Travel
+        Agency","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/02.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/travel-agency?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["business-services"]},{"id":"communication-media","title":"Communications/Media","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/02.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/communication-media?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["business-services"]},{"id":"business-industry","title":"Business/Industry","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/02.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/business-industry?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["business-services"]},{"id":"service","title":"Service","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/02.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/service?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["business-services"]},{"id":"facilities","title":"Facilities","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/04.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/facilities?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":[]},{"id":"hospital-health-care-facility","title":"Hospital
+        or Healthcare Facility","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/26.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/hospital-health-care-facility?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["facilities"]},{"id":"hospital","title":"Hospital","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/26.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/hospital?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["hospital-health-care-facility"]},{"id":"government-community-facility","title":"Government
+        or Community Facility","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/04.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/government-community-facility?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["facilities"]},{"id":"education-facility","title":"Educational
+        Facility","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/25.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/education-facility?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["facilities"]},{"id":"library","title":"Library","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/27.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/library?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["facilities"]},{"id":"fair-convention-facility","title":"Fair
+        & Convention Facility","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/24.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/fair-convention-facility?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["facilities"]},{"id":"parking-facility","title":"Parking
+        Facility","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/28.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/parking-facility?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["facilities"]},{"id":"toilet-rest-area","title":"Public
+        Toilet/Rest Area","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/29.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/toilet-rest-area?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["facilities"]},{"id":"sports-facility-venue","title":"Sport
+        Facility/Venue","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/30.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/sports-facility-venue?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["facilities"]},{"id":"facility","title":"Facility","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/04.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/facility?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["facilities"]},{"id":"religious-place","title":"Religious
+        Place","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/39.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/religious-place?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["facilities"]},{"id":"leisure-outdoor","title":"Leisure
+        & Outdoor","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/07.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/leisure-outdoor?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":[]},{"id":"recreation","title":"Recreation","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/07.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/recreation?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["leisure-outdoor"]},{"id":"amusement-holiday-park","title":"Theme
+        Park","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/34.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/amusement-holiday-park?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["leisure-outdoor"]},{"id":"zoo","title":"Zoo","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/34.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/zoo?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["amusement-holiday-park"]},{"id":"administrative-areas-buildings","title":"Administrative
+        Areas/Buildings","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/06.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/administrative-areas-buildings?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":[]},{"id":"administrative-region","title":"Administrative
+        Region","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/06.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/administrative-region?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["administrative-areas-buildings"]},{"id":"city-town-village","title":"City,
+        Town or Village","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/35.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/city-town-village?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["administrative-areas-buildings"]},{"id":"outdoor-area-complex","title":"Outdoor
+        Area/Complex","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/06.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/outdoor-area-complex?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["administrative-areas-buildings"]},{"id":"building","title":"Building","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/06.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/building?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["administrative-areas-buildings"]},{"id":"street-square","title":"Street
+        or Square","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/06.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/street-square?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["administrative-areas-buildings"]},{"id":"postal-area","title":"Postal
+        Area","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/06.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/postal-area?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["administrative-areas-buildings"]},{"id":"natural-geographical","title":"Natural
+        or Geographical","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/08.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/natural-geographical?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":[]},{"id":"body-of-water","title":"Body
+        of Water","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/36.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/body-of-water?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["natural-geographical"]},{"id":"mountain-hill","title":"Mountain
+        or Hill","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/08.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/mountain-hill?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["natural-geographical"]},{"id":"undersea-feature","title":"Undersea
+        Feature","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/08.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/undersea-feature?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["natural-geographical"]},{"id":"forest-heath-vegetation","title":"Forest,
+        Heath or Other Vegetation","icon":"http://download.vcdn.nokia.com/p/d/places2/icons/categories/08.icon","type":"urn:nlp-types:category","href":"http://places.nlp.nokia.com/places/v1/categories/places/forest-heath-vegetation?app_id=<APP_ID>&app_code=<APP_CODE>","system":"places","within":["natural-geographical"]}]}'
+    http_version: 
+  recorded_at: Sat, 25 Apr 2015 12:19:56 GMT
+recorded_with: VCR 2.9.3