Обзор 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 прямо в браузере. Подробную информацию вы найдете в разделе Примеры часовых поясов руководства Запросы и ответы Time Zone API.
3 Основные сведения об ответах Узнайте, как использовать данные о часовых поясах в приложении или на сайте. Подробнее об ответах Time Zone API…
5 Добавьте данные о часовых поясах в свое приложение. Вы можете использовать данные о часовых поясах, чтобы улучшить работу приложений и сайтов в разных регионах.

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

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

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

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