![Обзор API часового пояса](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/images/landing/places-api_480.png?authuser=5&hl=ru)
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 ×tamp=1331161200 &key=YOUR_API_KEY
Ресурсы
В следующей таблице приведены ресурсы, доступные через API часовых поясов, а также данные, которые он возвращает.
Ресурсы данных | Данные возвращены | Формат возврата |
---|---|---|
Часовой пояс Вы предоставляете свой запрос вместе с местоположением и отметкой времени. См. необходимые параметры . |
|
|
Как использовать 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, где вы также можете найти инструкции по установке и пример кода.
Что дальше
- Узнайте, как отправлять запросы на часовой пояс : перейдите в раздел «Запросы и ответы на часовой пояс» .
- Следуйте рекомендациям : перейдите к разделу «Рекомендации по использованию веб-служб» .