Class: DarkskyRubyClient::Client

Inherits:
Object
  • Object
show all
Defined in:
lib/darksky_ruby_client/client.rb

Constant Summary collapse

@@base_url = 
'https://api.darksky.net/forecast/'

Instance Method Summary collapse

Constructor Details

#initialize(key) ⇒ Client

Initialize

Parameters:

  • key (String) —

    Secret key of the api.



26
27
28
29
30
 
# File 'lib/darksky_ruby_client/client.rb', line 26

def initialize(key)
  @secret_key = key
  @parallel_requests = false
  @responses = {}
end

Instance Method Details

#base_url ⇒ Object

Don’t need this method to use until the base_url of darksky api has changed.



15
16
17
 
# File 'lib/darksky_ruby_client/client.rb', line 15

def base_url
  @@base_url
end

#base_url=(value) ⇒ Object

Don’t need this method to use until the base_url of darksky api has changed.



20
21
22
 
# File 'lib/darksky_ruby_client/client.rb', line 20

def base_url=(value)
  @@base_url = value
end

#init_client ⇒ Object

Init client for typhoeus



109
110
111
 
# File 'lib/darksky_ruby_client/client.rb', line 109

def init_client
  @client = Typhoeus::Request.new(@request_url)
end

#run ⇒ Object

Run a request.



114
115
116
 
# File 'lib/darksky_ruby_client/client.rb', line 114

def run
  @client.run
end

#some_weather_forecast(locations, **options) ⇒ Object

TODO Parallel requests



90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
 
# File 'lib/darksky_ruby_client/client.rb', line 90

def some_weather_forecast(locations, **options)
  @parallel_requests = true
  hydra = Typhoeus::Hydra.new
  locations.with_indifferent_access
  locations.each {|place_name, location|
    latitude = location[:latitude] if location.include?(:latitude)
    longitude = location[:longitude] if location.include?(:longitude)
    weather_forecast(latitude, longitude, options)
    @client.on_complete do |response|
      @responses[place_name] = response
    end
    hydra.queue @client
    @client
  }
  hydra.run
  return @responses
end

#weather_forecast(lat, long, **options) ⇒ Object

A single request for forecast request Please check darksky.net/dev/docs#forecast-request for details. exlude= e.g. exclude: “currently,flags” Exclude some number of data blocks from the API response. This is useful for reducing latency and saving cache space. The value blocks should be a comma-delimeted list (without spaces) of any of the following:

  • currently

  • minutely

  • hourly

  • daily

  • alerts

  • flags

extend= e.g. hourly: “24” When present, return hour-by-hour data for the next 168 hours, instead of the next 48. When using this option, we strongly recommend enabling HTTP compression. e.g. lang: “en” Return summary properties in the desired language. (Note that units in the summary will be set according to the units parameter, so be sure to set both parameters appropriately.) Please check with darksky.net/dev/docs#forecast-request for available languages. units= e.g. units: “auto” Return weather conditions in the requested units.

units

should be one of the following:

  • auto: automatically select units based on geographic location

  • ca: same as si, except that windSpeed and windGust are in kilometers per hour

  • uk2: same as si, except that nearestStormDistance and visibility are in miles,

    and windSpeed and windGust in miles per hour

  • us: Imperial units (the default)

  • si: SI units

Please check with darksky.net/dev/docs#forecast-request for available SI units.

Parameters:

  • lat (String) —

    The latitude of a location (in decimal degrees).

  • long (String) —

    The longitude of a location (in decimal degrees).

  • options (Hash) —

    Use if you want to specify “explicit, extend, lang, units”.

Options Hash (**options):

  • :exclude (String)
  • :extend (String)
  • :lang (String)
  • :units (String) 


69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
 
# File 'lib/darksky_ruby_client/client.rb', line 69

def weather_forecast(lat, long, **options)
  @request_url = @@base_url + @secret_key + '/' + lat + ',' + long + '/'
  unless options.empty? then
    options.each {|key, value|
      if [:exclude, :extend, :lang, :units].include?(key)
        p @request_url[-1]
        if @request_url[-1] == '/'
          @request_url = '?' + key.to_s + '=' + value
        else
          @request_url = '&' + key.to_s + '=' + value
        end
      else
        @log.warn("invalid options key \"#{key}\".")
      end
    }
  end
  init_client
  run unless @parallel_requests
end