Gem which gives you a simple way to find local time (timezone) of some place, address, city, region country or any other location which you want.

1. Create google app for your project to use Google API.

2. Enable Geocoding API and TimeZone API access for your google app.

3. Get API_KEY from settings of your google app (something like "AIzaSyCqfXRRJ1d8mCS_I0Kcs4XnaZ9KYRUrJVE").

4. Set up your google app for work (in development mode usage of API is limited: only 2500 requests per day)

5. Add this line to your application's Gemfile:

   gem 'which_time'

And then execute:

$ bundle

Manually:

gem install which_time

WhichTime.in somewhere, api_key: google_api_key

or

WhichTime.in somewhere, api_key: google_api_key, time: your_time

or

WhichTime.in somewhere, api_key: google_api_key, time: your_time, http_proxy: proxy_url

• "somewhere" - may be an address or some place ("Lviv city, Naykova str." or "'Naturlih' pub, Kyiv" e.g.)
• "google_api_key" - API_KEY of Google application with an access to TimeZone and Geocoding API
• "your_time" - is not mandatory (Time.now is default)
• "proxy_url" - proxy host with port ( is not mandatory, 'https://fooproxy.com:8080' etc.)

examples:

  WhichTime.in "Kyiv, pub 'Naturlih'", api_key: "AIzaSyCqfXRRJ1d8mCS_I0Kcs4XnaZ9KYRUrJVE"
  # => 2015-07-06 03:53:10 +0300
  WhichTime.in "Kyiv", api_key: "AIzaSyCqfXRRJ1d8mCS_I0Kcs4XnaZ9KYRUrJVE", time: 2.days.ago
  # => 2015-07-04 03:53:10 +0300

WhichTime.new( somewhere, api_key: google_api_key, time: your_time ).time
# => 2015-07-06 03:53:10 +0300 

WhichTime.new( somewhere, api_key: google_api_key ).timezone

examples:

  WhichTime.new("Kyiv, pub 'Naturlih'", api_key: "AIzaSyCqfXRRJ1d8mCS_I0Kcs4XnaZ9KYRUrJVE").timezone
  WhichTime.in("Kyiv", api_key: "AIzaSyCqfXRRJ1d8mCS_I0Kcs4XnaZ9KYRUrJVE").timezone
  # => "Europe/Kiev"

WhichTime.new( somewhere, api_key: google_api_key ).location
# => {"lat"=>50.4501, "lng"=>30.5234}

WhichTime.new( somewhere, api_key: google_api_key ).coordinates
# => "50.4501,30.5234"

1. Fork it ( https://github.com/bmalets/which_time/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)
5. Create a new Pull Request