Time Zone API предоставляет данные о смещении времени для местоположений на поверхности Земли. Запросите информацию о часовом поясе для определенной пары широты/долготы и даты. API возвращает название часового пояса, смещение по времени относительно UTC и смещение летнего времени.
Пример запроса и ответа
Доступ к Time Zone 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
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 Карт, предоставляя простые нативные реализации распространенных задач, таких как аутентификация, регулирование запросов и автоматический повтор. Time Zone API доступен в клиентах Java, Python, Go и Node.js для сервисов Google Карт.
Аутентификация, квоты, цены и правила
Аутентификация
Чтобы использовать Time Zone API, сначала включите API и получите необходимые учетные данные для аутентификации. Подробнее см. в разделе Начало работы с платформой Google Карт.
Квоты и цены
Подробную информацию о квотах и ценах для Time Zone API можно найти на странице Статистика использования и оплата.
Правила
Использовать Time Zone API необходимо в соответствии с правилами API.
Подробнее…
В Time Zone API можно задать параметр языка, чтобы получать результаты не только на английском языке, который используется по умолчанию. Дополнительные примеры и подробную информацию можно найти в руководстве для разработчиков по Time Zone API.
Руководство для разработчиков по Time Zone API предназначено для разработчиков сайтов и мобильных приложений, которые хотят добавить данные о часовом поясе на карты, предоставляемые одним из API платформы Google Карт. В ней рассказывается, как использовать API, и приводятся справочные материалы по доступным параметрам.