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 ×tamp=1331161200 &key=YOUR_API_KEY
CURL
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=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×tamp=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×tamp=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×tamp=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×tamp=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×tamp=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 и справочный материал по доступным параметрам.