Обзор 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, где вы также можете найти инструкции по установке и примеры кода.

Что дальше