API часовых поясов предоставляет данные о смещении времени для различных местоположений на Земле. Запросите информацию о часовом поясе для конкретной пары широта/долгота и даты. API вернет название часового пояса, смещение времени относительно UTC и смещение, связанное с переходом на летнее время.
Пример запроса и ответа
Доступ к API часовых поясов осуществляется через интерфейс HTTPS. Запросы формируются в виде строки URL, содержащей координаты широты/долготы для указания location , метку timestamp для указания даты и ваш ключ API.
Приведенный ниже запрос выполняет запрос часового пояса для штата Невада, США. Временная метка установлена на 8 марта 2012 года.
URL
https://maps.googleapis.com/maps/api/timezone/json ?location=39.6034810%2C-119.6822510 ×tamp=1733428634 &key=YOUR_API_KEY
локон
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1733428634&key=YOUR_API_KEY'
Вы можете проверить это, введя URL-адрес в свой веб-браузер (обязательно замените YOUR_API_KEY на свой фактический ключ API ). В ответе будут указаны данные о часовом поясе для указанного местоположения и даты (timestamp) .
Для получения дополнительной информации о создании URL-адресов запросов, доступных параметрах и понимании ответа ознакомьтесь с руководством разработчика .
Ниже приведён пример ответа в формате JSON:
JSON
{ "dstOffset": 0, "rawOffset": -28800, "status": "OK", "timeZoneId": "America/Los_Angeles", "timeZoneName": "Pacific Standard Time", }
XML
<TimeZoneResponse> <status>OK</status> <raw_offset>-28800.0000000</raw_offset> <dst_offset>0.0000000</dst_offset> <time_zone_id>America/Los_Angeles</time_zone_id> <time_zone_name>Pacific Standard Time</time_zone_name> </TimeZoneResponse>
Начните программировать с помощью наших клиентских библиотек.
Клиентские библиотеки упрощают разработку с использованием API веб-сервисов Google Maps, предоставляя простые нативные реализации распространенных задач, таких как аутентификация, ограничение запросов и автоматическое повторение попыток. API часовых поясов доступен в Java-клиенте, Python-клиенте, Go-клиенте и Node.js-клиенте для сервисов Google Maps .
Аутентификация, квоты, ценообразование и правила.
Аутентификация
Для использования API часовых поясов необходимо сначала включить API и получить соответствующие учетные данные для аутентификации. Дополнительную информацию см. в разделе «Начало работы с платформой Google Maps» .
Квоты и цены
Подробную информацию о квотах и ценах, установленных для API часовых поясов, можно найти на странице использования и выставления счетов .
Политики
Использование API часовых поясов должно осуществляться в соответствии с политикой API .
Узнать больше
В API часовых поясов вы также можете задать языковой параметр, чтобы получать результаты на языках, отличных от английского по умолчанию. Дополнительные примеры и подробности см. в Руководстве разработчика API часовых поясов .
Руководство разработчика по API часовых поясов предназначено для веб- и мобильных разработчиков, которые хотят добавить данные о времени на карты, предоставляемые одним из API платформы Google Maps. В нем содержится вводная информация об использовании API и справочные материалы по доступным параметрам.