policymap_wrap 0.2.0 → 0.3.0

data/README.rdoc

@@ -72,6 +72,16 @@ Other search options:
   :lat => 33.805094   # Only to be used if boundary_ids (above) is not specified
   :lng => -118.353717
 
+=== PolicyMap::Client.containment_search(<search_options>)
+
+A +:containment+ type of search *returns a hash (with symbolized keys)* containing boundary IDs for each of the boundary types contained by the specified boundary ID. 
+For example, if the boundary ID is for Alameda County, specifying :city as the boundary_types will reveal all cities within Alameda county.
+
+Required search options:
+
+  :boundary_types => [:city, :zip, :state]   # Can be a single boundary type, an array, or :all
+  :boundary_id => 590932   # The ID of the boundary to use as the "container"
+
 === Available Boundary Types
 
   :state

data/VERSION

@@ -1 +1 @@
-0.2.0
+0.3.0

data/lib/policymap_wrap/client.rb

@@ -109,6 +109,25 @@ module PolicyMap
         @@connection.get endpoint, data
       end
       
+      def containment_search(*args)
+        default_options = @@default_options
+        default_options[:t] = "cnt"
+        
+        options = extract_options!(args)
+        
+        raise InsufficientArgsForSearch unless options.has_key?(:boundary_types) && options.has_key?(:boundary_id)
+        
+        options[:boundary_types] = Array(options[:boundary_types]).collect {|bt| BOUNDARY_TYPES[bt] }.join(',')
+        HashUtils.rename_key!(options, :boundary_types, :ct)
+        HashUtils.rename_key!(options, :boundary_id, :bi)
+        
+        
+        options = default_options.merge(options)
+        
+        result = get(Endpoint.endpoint_url, options)
+        result['cnt'].collect {|hsh| HashUtils.symbolize_keys(hsh) }
+      end
+      
     private
     
       def extract_options!(args)

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: policymap_wrap
 version: !ruby/object:Gem::Version 
-  hash: 23
+  hash: 19
   prerelease: false
   segments: 
   - 0
-  - 2
+  - 3
   - 0
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors: 
 - Mauricio Gomes
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-08-07 00:00:00 -04:00
+date: 2010-08-17 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency