Запросы и ответы

Запросы часового пояса

Запросы API часовых поясов создаются в виде строки URL. API возвращает данные о часовом поясе для точки на Земле, заданной парой широта/долгота. Обратите внимание, что данные о часовых поясах могут быть недоступны для местоположений над водой, например над океанами или морями.

Запрос API часового пояса имеет следующую форму:

https://maps.googleapis.com/maps/api/timezone/outputFormat?parameters

где outputFormat может быть одним из следующих значений:

• json (рекомендуется), указывает вывод в нотации объектов JavaScript (JSON); или же
• xml указывает вывод в формате XML, заключенный в узел <TimeZoneResponse> .

Примечание. URL-адреса должны быть правильно закодированы , чтобы быть действительными, и ограничены 8192 символами для всех веб-служб. Помните об этом ограничении при создании URL-адресов. Обратите внимание, что разные браузеры, прокси-серверы и серверы также могут иметь разные ограничения на количество символов в URL.

Required parameters

• location

  A comma-separated latitude,longitude tuple, location=39.6034810,-119.6822510 , representing the location to look up.

• timestamp

  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, based on the time zone of the location .

  Note that the API does not take historical time zones into account. That is, if you specify a past timestamp, the API does not take into account the possibility that the location was previously in a different time zone.

Optional parameters

• language

  The language in which to return results.

  • See the list of supported languages . Google often updates the supported languages, so this list may not be exhaustive.
  • If language is not supplied, the API attempts to use the preferred language as specified in the Accept-Language header.
  • The API does its best to provide a street address that is readable for both the user and locals. To achieve that goal, it returns street addresses in the local language, transliterated to a script readable by the user if necessary, observing the preferred language. All other addresses are returned in the preferred language. Address components are all returned in the same language, which is chosen from the first component.
  • If a name is not available in the preferred language, the API uses the closest match.
  • The preferred language has a small influence on the set of results that the API chooses to return, and the order in which they are returned. The geocoder interprets abbreviations differently depending on language, such as the abbreviations for street types, or synonyms that may be valid in one language but not in another. For example, utca and tér are synonyms for street in Hungarian.

Generated from the OpenAPI specification . Edit Report bug

Примеры часовых поясов

Этот раздел включает несколько примеров запросов, демонстрирующих возможности API.

Приведенный ниже запрос выполняет запрос часового пояса для Невады, США. Отметка времени установлена ​​на 8 марта 2012 года.

URL-адрес

https://maps.googleapis.com/maps/api/timezone/json
  ?location=39.6034810%2C-119.6822510
  &timestamp=1331161200
  &key=YOUR_API_KEY

Примечание. Фрагменты, сгенерированные из спецификации OpenAPI на GitHub .

CURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY'

Примечание. Фрагменты, сгенерированные из спецификации OpenAPI на GitHub .

JavaScript

Чтобы совершать звонки в среде браузера, используйте Maps JavaScript API .

var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY',
  headers: { }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Примечание. Фрагменты, сгенерированные из спецификации OpenAPI на GitHub .

питон

import requests

url = "https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Примечание. Фрагменты, сгенерированные из спецификации OpenAPI на GitHub .

Ява

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY")
  .method("GET", body)
  .build();
Response response = client.newCall(request).execute();

Примечание. Фрагменты, сгенерированные из спецификации OpenAPI на GitHub .

Рубин

require "uri"
require "net/http"

url = URI("https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body

Примечание. Фрагменты, сгенерированные из спецификации OpenAPI на GitHub .

Идти

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510&timestamp=1331161200&key=YOUR_API_KEY"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

Примечание. Фрагменты, сгенерированные из спецификации OpenAPI на GitHub .

Почтальон

Спецификация OpenAPI также доступна в виде коллекции Postman .

Беги в Почтальоне

JSON

{
  "dstOffset": 0,
  "rawOffset": -28800,
  "status": "OK",
  "timeZoneId": "America/Los_Angeles",
  "timeZoneName": "Pacific Standard Time",
}

XML

<TimeZoneResponse>
 <status>OK</status>
 <raw_offset>-28800.0000000</raw_offset>
 <dst_offset>0.0000000</dst_offset>
 <time_zone_id>America/Los_Angeles</time_zone_id>
 <time_zone_name>Pacific Standard Time</time_zone_name>
</TimeZoneResponse>

Приведенный ниже запрос выполняет запрос часового пояса для Невады, США. Местоположение такое же, как и в приведенном выше запросе, но отметка времени установлена ​​на 15 марта 2012 г. Ответ теперь включает смещение летнего времени.

URL-адрес

https://maps.googleapis.com/maps/api/timezone/json
  ?location=39.6034810%2C-119.6822510
  &timestamp=1331766000
  &key=YOUR_API_KEY

Примечание. Фрагменты, сгенерированные из спецификации OpenAPI на GitHub .

CURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331766000&key=YOUR_API_KEY'

Примечание. Фрагменты, сгенерированные из спецификации OpenAPI на GitHub .

JavaScript

Чтобы совершать звонки в среде браузера, используйте Maps JavaScript API .

var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331766000&key=YOUR_API_KEY',
  headers: { }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Примечание. Фрагменты, сгенерированные из спецификации OpenAPI на GitHub .

питон

import requests

url = "https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331766000&key=YOUR_API_KEY"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Примечание. Фрагменты, сгенерированные из спецификации OpenAPI на GitHub .

Ява

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331766000&key=YOUR_API_KEY")
  .method("GET", body)
  .build();
Response response = client.newCall(request).execute();

Примечание. Фрагменты, сгенерированные из спецификации OpenAPI на GitHub .

Рубин

require "uri"
require "net/http"

url = URI("https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331766000&key=YOUR_API_KEY")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body

Примечание. Фрагменты, сгенерированные из спецификации OpenAPI на GitHub .

Идти

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510&timestamp=1331766000&key=YOUR_API_KEY"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

Примечание. Фрагменты, сгенерированные из спецификации OpenAPI на GitHub .

Почтальон

Спецификация OpenAPI также доступна в виде коллекции Postman .

Беги в Почтальоне

JSON

{
  "dstOffset": 3600,
  "rawOffset": -28800,
  "status": "OK",
  "timeZoneId": "America/Los_Angeles",
  "timeZoneName": "Pacific Daylight Time",
}

XML

<TimeZoneResponse>
 <status>OK</status>
 <raw_offset>-28800.0000000</raw_offset>
 <dst_offset>3600.0000000</dst_offset>
 <time_zone_id>America/Los_Angeles</time_zone_id>
 <time_zone_name>Pacific Daylight Time</time_zone_name>
</TimeZoneResponse>

Этот пример похож на два предыдущих, но задает языковой параметр. Теперь ответ будет переведен на испанский язык.

URL-адрес

https://maps.googleapis.com/maps/api/timezone/json
  ?language=es
  &location=39.6034810%2C-119.6822510
  &timestamp=1331766000
  &key=YOUR_API_KEY

Примечание. Фрагменты, сгенерированные из спецификации OpenAPI на GitHub .

CURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331766000&language=es&key=YOUR_API_KEY'

Примечание. Фрагменты, сгенерированные из спецификации OpenAPI на GitHub .

JavaScript

Чтобы совершать звонки в среде браузера, используйте Maps JavaScript API .

var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331766000&language=es&key=YOUR_API_KEY',
  headers: { }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Примечание. Фрагменты, сгенерированные из спецификации OpenAPI на GitHub .

питон

import requests

url = "https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331766000&language=es&key=YOUR_API_KEY"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Примечание. Фрагменты, сгенерированные из спецификации OpenAPI на GitHub .

Ява

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331766000&language=es&key=YOUR_API_KEY")
  .method("GET", body)
  .build();
Response response = client.newCall(request).execute();

Примечание. Фрагменты, сгенерированные из спецификации OpenAPI на GitHub .

Рубин

require "uri"
require "net/http"

url = URI("https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331766000&language=es&key=YOUR_API_KEY")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body

Примечание. Фрагменты, сгенерированные из спецификации OpenAPI на GitHub .

Идти

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510&timestamp=1331766000&language=es&key=YOUR_API_KEY"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

Примечание. Фрагменты, сгенерированные из спецификации OpenAPI на GitHub .

Почтальон

Спецификация OpenAPI также доступна в виде коллекции Postman .

Беги в Почтальоне

JSON

{
  "dstOffset": 3600,
  "rawOffset": -28800,
  "status": "OK",
  "timeZoneId": "America/Los_Angeles",
  "timeZoneName": "hora de verano del Pacífico",
}

XML

<TimeZoneResponse>
 <status>OK</status>
 <raw_offset>-28800.0000000</raw_offset>
 <dst_offset>3600.0000000</dst_offset>
 <time_zone_id>America/Los_Angeles</time_zone_id>
 <time_zone_name>hora de verano del Pacífico</time_zone_name>
</TimeZoneResponse>

Ответы часового пояса

Для каждого допустимого запроса служба часовых поясов возвращает ответ в формате, указанном в URL-адресе запроса.

TimeZoneResponse

Field	Required	Type	Description
status	required	TimeZoneStatus	See TimeZoneStatus for more information.
dstOffset	optional	number	The offset for daylight-savings time in seconds. This will be zero if the time zone is not in Daylight Savings Time during the specified timestamp .
errorMessage	optional	string	Detailed information about the reasons behind the given status code. Included if status other than Ok .
rawOffset	optional	number	The offset from UTC (in seconds) for the given location. This does not take into effect daylight savings.
timeZoneId	optional	string	a string containing the ID of the time zone, such as "America/Los_Angeles" or "Australia/Sydney". These IDs are defined by Unicode Common Locale Data Repository (CLDR) project , and currently available in file timezone.xml. When a timezone has several IDs, the canonical one is returned. In xml responses, this is the first alias of each timezone. For example, "Asia/Calcutta" is returned, not "Asia/Kolkata".
timeZoneName	optional	string	The long form name of the time zone. This field will be localized if the language parameter is set. eg. Pacific Daylight Time or Australian Eastern Daylight Time .

Generated from the OpenAPI specification . Edit Report bug

TimeZoneStatus

The status field within the Time Zone response object contains the status of the request. The status field may contain the following values:

• OK indicates that the request was successful.

• INVALID_REQUEST indicates that the request was malformed.

• OVER_DAILY_LIMIT indicates any of the following:

  • The API key is missing or invalid.
  • Billing has not been enabled on your account.
  • A self-imposed usage cap has been exceeded.
  • The provided method of payment is no longer valid (for example, a credit card has expired).

• OVER_QUERY_LIMIT indicates the requestor has exceeded quota.

• REQUEST_DENIED indicates that the API did not complete the request. Confirm that the request was sent over HTTPS instead of HTTP.

• UNKNOWN_ERROR indicates an unknown error.

• ZERO_RESULTS indicates that no time zone data could be found for the specified position or time. Confirm that the request is for a location on land, and not over water.

Generated from the OpenAPI specification . Edit Report bug

Расчет местного времени

Местное время заданного местоположения является суммой параметра timestamp и полей dstOffset и rawOffset из результата.