Обзор 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-клиент для сервисов Google Maps
• Клиент Python для сервисов Google Maps
• Клиент Go для сервисов Google Maps
• Клиент Node.js для сервисов Google Maps

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

Что дальше

• Узнайте, как отправлять запросы на часовой пояс . Перейдите в раздел «Запросы и ответы на часовой пояс» .
• Следуйте рекомендациям : перейдите к разделу «Рекомендации по использованию веб-служб» .