Class: CensusApi::Request

Inherits:
Object
  • Object
show all
Defined in:
lib/census_api/request.rb

Overview

> CensusApi::Request

client#initialize method takes an url, vintage, source, options hash. client#find method accepts source and options hash, which include :key, :fields, :level, :within and :vintage.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(vintage, source, options) ⇒ Request

Returns a new instance of Request.



13
14
15
16
17
 
# File 'lib/census_api/request.rb', line 13

def initialize(vintage, source, options)
  uri = "/data/#{vintage}/#{source}?#{to_params(options)}"
  @response = $census_connection.get(uri.to_s)
  @response.flush
end

Instance Attribute Details

#response ⇒ Object

Returns the value of attribute response.



11
12
13
 
# File 'lib/census_api/request.rb', line 11

def response
  @response
end

Class Method Details

.find(source, options = {}) ⇒ Object 



19
20
21
22
23
24
25
26
27
28
29
30
31
 
# File 'lib/census_api/request.rb', line 19

def self.find(source, options = {})
  fields = options[:fields]
  fields = fields.split(',').push('NAME').join(',') if fields.is_a? String
  fields = fields.push('NAME').join(',') if fields.is_a? Array
  level  = format(options[:level], false, source)
  params = { key: options[:key], get: fields, for: level }
  unless (options[:within].nil? || (options[:within].is_a?(Array) && options[:within].compact.empty?))
    params.merge!(in: format(options[:within][0], true, source))
  end
  options.merge!(vintage: 2010) unless options[:vintage]
  request = new(options[:vintage], source, params)
  request.parse_response
end

Instance Method Details

#parse_response ⇒ Object 



33
34
35
36
37
38
39
40
 
# File 'lib/census_api/request.rb', line 33

def parse_response
  case @response.code
  when 200
    response_success(@response)
  else
    response_error(@response)
  end
end

#to_params(options) ⇒ Object 



42
43
44
 
# File 'lib/census_api/request.rb', line 42

def to_params(options)
  options.map { |k,v| "#{k}=#{v}" }.join("&")
end