Convert locations to time zone

• We return five different bits of information about the time zone: name, now_in_dst, offset_sec, offset_string, short_name
  See the section of the API documentation describing the timezone annotation.
• The name field is in the tz database format. Example: Europe/Berlin.
• Time zones can and do change regularly, sometimes with very little notice. Governments chage DST rules, political boundaries shift, etc.

var api_key = 'YOUR-API-KEY';
var coords = '52.5432379, 13.4142133';  // lat, lng

var api_url = 'https://api.opencagedata.com/geocode/v1/json'

var request_url = api_url
  + '?'
  + 'key=' + api_key
  + '&q=' + encodeURIComponent(coords)
  + '&pretty=1';

// see full list of required and optional parameters:
// https://opencagedata.com/api#forward

var request = new XMLHttpRequest();
request.open('GET', request_url, true);

request.onload = function() {
    // see full list of possible response codes:
    // https://opencagedata.com/api#codes
    var data = JSON.parse(request.responseText);
    if (request.status === 200){  // Success!
        // see details of timezone response
        // https://opencagedata.com/api#timezone
        var tz = 'no time zone data returned';
        if (data.results[0].annotations.timezone.name != null){
            tz = data.results[0].annotations.timezone.name;
        }
        console.log('timezone: ' + tz);
    } else {
        console.log("unable to geocode! Response code: " + request.status);
        console.log('error msg: ' + data.status.message);
    }
};

request.onerror = function() {
    // There was a connection error of some sort
    console.log("unable to connect to server");
};
request.send();  // make the request

• OpenCage API reference section discussing the timezone annotation
• Wikipedia page about the tz database format
• OpenCage geocoding API Javascript tutorial