Обзор Time Zone API

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

Зачем использовать Time Zone API

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

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

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

Что можно делать с помощью Time Zone API

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

Как работает Time Zone API

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

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

Ресурсы

В таблице ниже перечислены ресурсы, доступные через Time Zone API, и возвращаемые ими данные.

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

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

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

Как использовать Time Zone API

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

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

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

Клиенты для Java, Python, Go и Node.js для сервисов Google Карт – это клиентские библиотеки, поддерживаемые сообществом, на базе ПО с открытым исходным кодом, которые предоставляются согласно лицензии Apache 2.0. Их можно скачать на сайте GitHub, где также опубликованы образцы кода и инструкции по установке.

Дальнейшие действия