Возвращает текущие погодные условия в заданном месте.
HTTP-запрос
GET https://weather.googleapis.com/v1/currentConditions:lookup
URL использует синтаксис перекодировки gRPC .
Параметры запроса
| Параметры | |
|---|---|
location | Обязательно. Местоположение, для которого необходимо получить текущие погодные условия. |
unitsSystem | Необязательно. Система единиц измерения, используемая для возвращаемых погодных условий. Если не указано, возвращаемые погодные условия будут представлены в метрической системе (по умолчанию = МЕТРИЧЕСКАЯ). |
languageCode | Необязательно. Позволяет клиенту выбрать язык ответа. Если данные для этого языка не могут быть предоставлены, API использует наиболее близкое соответствие. Допустимые значения основаны на стандарте IETF BCP-47. Значение по умолчанию — «en». |
Текст запроса
Тело запроса должно быть пустым.
Тело ответа
Ответ на RPC currentConditions.lookup — представляет текущие погодные условия в запрошенном месте.
В случае успеха тело ответа содержит данные со следующей структурой:
| JSON-представление |
|---|
{ "currentTime": string, "timeZone": { object ( |
| Поля | |
|---|---|
currentTime | Текущее время (UTC), связанное с возвращенными данными. Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: |
timeZone | Часовой пояс в запрашиваемом месте. |
weatherCondition | Текущие погодные условия. |
temperature | Текущая температура. |
feelsLikeTemperature | Показатель того, как ощущается температура в указанном месте в данный момент. |
dewPoint | Текущая температура точки росы. |
heatIndex | Текущая температура теплового индекса. |
windChill | Текущий уровень холода от ветра, температура воздуха, воздействующая на кожу. |
precipitation | Текущая вероятность осадков и количество осадков, накопленных за последний час. |
airPressure | Текущие условия давления воздуха. |
wind | Текущие ветровые условия. |
visibility | Текущая видимость. |
currentConditionsHistory | Изменения текущих условий за последние 24 часа. |
isDaytime | Истина, если текущее время в указанном месте находится между местным временем восхода солнца (включительно) и временем захода солнца (исключительно). В противном случае — ночь (между временем захода солнца и следующим восходом солнца). |
relativeHumidity | Текущий процент относительной влажности (значения от 0 до 100). |
uvIndex | Текущий ультрафиолетовый (УФ) индекс. |
thunderstormProbability | Текущая вероятность грозы (значения от 0 до 100). |
cloudCover | Текущий процент неба, закрытый облаками (значения от 0 до 100). |
Области авторизации
Требуется следующая область OAuth:
-
https://www.googleapis.com/auth/cloud-platform
ТекущиеСостоянияИстория
Представляет собой набор изменений текущих условий за последние 24 часа.
| JSON-представление |
|---|
{ "temperatureChange": { object ( |
| Поля | |
|---|---|
temperatureChange | Текущая температура минус температура 24 часа назад. |
maxTemperature | Максимальная (высокая) температура за последние 24 часа. |
minTemperature | Минимальная (низкая) температура за последние 24 часа. |
snowQpf | Количество снега, измеренное в эквиваленте жидкой воды, выпавшего за последние 24 часа. Примечание: QPF — это сокращение от Quantitative Precipitation Forecast (количественный прогноз осадков) (подробнее см. в определении QuantitativePrecipitationForecast). |
qpf | Количество осадков, измеренное в жидком водном эквиваленте, накопленное за последние 24 часа. Примечание: QPF — это сокращение от Quantitative Precipitation Forecast (количественный прогноз осадков) (подробнее см. в определении QuantitativePrecipitationForecast). |