Начать

API часовых поясов предоставляет данные о смещении времени для местоположений на поверхности земли. Запросить информацию о часовом поясе для конкретной пары широта/долгота и даты. API возвращает название этого часового пояса, смещение времени от UTC и смещение летнего времени.

Образец запроса и ответа

Доступ к API часовых поясов через интерфейс HTTPS с запросами, созданными в виде строки URL, с использованием координат широты и долготы для указания location , timestamp для указания даты и вашего ключа API.

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

URL-адрес

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

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'

JavaScript

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);
});

Питон

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)

Ява

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();

Рубин

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

Идти

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 также доступна в виде коллекции Postman .

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

Вы можете проверить это, введя URL-адрес в свой веб-браузер (не забудьте заменить YOUR_API_KEY вашим фактическим ключом API ). Ответ включает данные о часовом поясе для указанного местоположения и даты (timestamp) .

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

Ниже приведен пример ответа в формате JSON:

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>

Начните программировать с нашими клиентскими библиотеками

Клиентские библиотеки упрощают разработку с помощью API-интерфейсов веб-служб Google Maps, предоставляя простые встроенные реализации общих задач, таких как проверка подлинности, регулирование запросов и автоматический повтор. API часовых поясов доступен в клиенте Java, клиенте Python, клиенте Go и клиенте Node.js для сервисов Google Maps .

Аутентификация, квоты, цены и политики

Аутентификация

Чтобы использовать API часовых поясов, вы должны сначала включить API и получить надлежащие учетные данные для аутентификации. Дополнительную информацию см. в разделе Начало работы с платформой Google Maps .

Квоты и цены

Просмотрите страницу использования и выставления счетов , чтобы узнать подробности о квотах и ​​ценах, установленных для API часовых поясов.

Политики

Использование API часовых поясов должно соответствовать политике API .

Учить больше

В API часовых поясов вы также можете установить языковой параметр для возврата результатов на языках, отличных от английского по умолчанию. Дополнительные примеры и другие подробности см. в Руководстве разработчика API часовых поясов .

Руководство разработчика API часовых поясов предназначено для разработчиков веб-сайтов и мобильных устройств, которые хотят включать данные о времени на картах, предоставляемых одним из API платформы Google Maps. Он содержит введение в использование API и справочный материал по доступным параметрам.