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=1331161200 &key=YOUR_API_KEY
КУЛЬ
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1331161200&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 Карт. В нем содержится введение в использование API и справочные материалы по доступным параметрам.