Обзор API часового пояса

API часового пояса — это служба, которая принимает HTTP-запрос координат широты и долготы, а также желаемой даты и времени. Он возвращает данные часового пояса для местоположения, включая смещения для UTC и летнего времени.

Зачем использовать API часового пояса

С помощью API часового пояса вы можете разрабатывать приложения, которые предоставляют идентификатор часового пояса и имя для дат и времени в определенных местах на карте. Например, вы можете отобразить следующие данные о часовом поясе:

  • Локализованные названия часовых поясов для мест на карте из платформы Google Maps.
  • Смещение часового пояса от UTC и для перехода на летнее время.

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

Что вы можете сделать с помощью API часового пояса

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

Как работает API часового пояса

API часового пояса принимает HTTPS-запрос координат широты и долготы, желаемую дату и время в виде отметки времени и, при необходимости, код языка. Он возвращает данные в формате, указанном в запросе. В следующем примере показан запрос для Невады, США, с запрошенными выходными данными в формате JSON. 

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

Ресурсы

В следующей таблице приведены ресурсы, доступные через API часовых поясов, а также данные, которые он возвращает.

Ресурсы данных Данные возвращены Формат возврата
Часовой пояс

Вы предоставляете свой запрос вместе с местоположением и отметкой времени. См. необходимые параметры .

  • Идентификатор часового пояса.
  • Название часового пояса, возможно локализованное
  • Смещение от UTC, в секундах
  • Смещение на летнее время, в секундах
  • См. Часовой пояс для конкретных примеров ответов.
  • JSON
  • XML

Как использовать API часового пояса

1 Настроить Начните с настройки проекта Google Cloud и выполните следующие инструкции по настройке.
2 Попробуйте запрос часового пояса Получив ключ API, вы можете начать тестирование API часового пояса прямо из браузера. Дополнительные сведения см. в разделе Примеры часовых поясов в руководстве по запросам и ответам на часовые пояса .
3 Понимать основы ответа Узнайте, как использовать данные о часовых поясах в вашем приложении или на веб-сайте. Подробности см. в разделе «Ответы о часовом поясе» .
5 Включите данные о часовом поясе в свое приложение! Вы можете использовать данные о часовом поясе, чтобы улучшить приложения и веб-сайты для пользователей в разных регионах с разным временем.

Доступные клиентские библиотеки

Вызовите этот API на выбранном вами языке через одну из следующих клиентских библиотек:

Клиент Java, клиент Python, клиент Go и клиент Node.js для служб Google Maps — это клиентские библиотеки, поддерживаемые сообществом, с открытым исходным кодом по лицензии Apache 2.0 . Загрузите их с GitHub, где вы также можете найти инструкции по установке и пример кода.

Что дальше