Начать

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
  &timestamp=1331161200
  &key=YOUR_API_KEY

КУЛЬ 

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=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 и справочные материалы по доступным параметрам.