module GoogleMapsService::Apis::TimeZone

Performs requests to the Google Maps TimeZone API.“”“

Public Instance Methods

timezone(location, timestamp: Time.now, language: nil) click to toggle source

Get time zone for a location on the earth, as well as that location's time offset from UTC.

@example Current time zone

timezone = client.timezone([39.603481, -119.682251])

@example Time zone at certain time

timezone = client.timezone([39.603481, -119.682251], timestamp: Time.at(1608))

@param [Hash, Array] location The latitude/longitude value representing the location to

look up.

@param [Integer, DateTime] timestamp Timestamp specifies the desired time as seconds since

midnight, January 1, 1970 UTC. The Time Zone API uses the timestamp to
determine whether or not Daylight Savings should be applied. Times
before 1970 can be expressed as negative values. Optional. Defaults to
`Time.now`.

@param [String] language The language in which to return results.

@return [Hash] Time zone object.

# File lib/google_maps_service/apis/time_zone.rb, line 27
def timezone(location, timestamp: Time.now, language: nil)
  location = GoogleMapsService::Convert.latlng(location)
  timestamp = GoogleMapsService::Convert.time(timestamp)

  params = {
    location: location,
    timestamp: timestamp
  }

  params[:language] = language if language

  return get('/maps/api/timezone/json', params)
end