Method: currentConditions.lookup

返回指定地点的当前天气状况。

HTTP 请求

GET https://weather.googleapis.com/v1/currentConditions:lookup

网址采用 gRPC 转码语法。

查询参数

参数
location

object (LatLng)

必需。要获取当前天气状况的位置。
unitsSystem

enum (UnitsSystem)

可选。返回的天气状况所使用的单位制。如果未提供，返回的天气状况将采用公制（默认值 = METRIC）。
languageCode

string

可选。允许客户端选择回答所用的语言。如果无法提供该语言的数据，API 会使用最接近的匹配项。允许的值取决于 IETF BCP-47 标准。默认值为“en”。

请求正文

请求正文必须为空。

响应正文

针对 currentConditions.lookup RPC 的响应 - 表示所请求位置的当前天气状况。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "currentTime": string,
  "timeZone": {
    object (TimeZone)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "currentConditionsHistory": {
    object (CurrentConditionsHistory)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
字段
currentTime

string (Timestamp format)

与返回的数据关联的当前时间 (UTC)。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
timeZone

object (TimeZone)

所请求位置的时区。
weatherCondition

object (WeatherCondition)

当前天气状况。
temperature

object (Temperature)

当前温度。
feelsLikeTemperature

object (Temperature)

所请求位置的当前体感温度。
dewPoint

object (Temperature)

当前温度。
heatIndex

object (Temperature)

当前酷热指数温度。
windChill

object (Temperature)

当前风寒指数，即皮肤感受到的气温。

注意：对于日本和韩国境内的地点，此字段会返回一个空对象。
precipitation

object (Precipitation)

当前降水概率和过去一小时的累积降水量。
airPressure

object (AirPressure)

当前气压状况。
wind

object (Wind)

当前风况。
visibility

object (Visibility)

当前公开范围。

注意：对于日本和韩国境内的地点，此字段会返回一个空对象。
currentConditionsHistory

object (CurrentConditionsHistory)

过去 24 小时内当前状况的变化。
isDaytime

boolean

如果所请求位置的当前时间介于当地日出时间（含）和日落时间（不含）之间，则为 True。否则，即为夜间（日落到次日日出之间）。
relativeHumidity

integer

当前相对湿度百分比（值介于 0 到 100 之间）。
uvIndex

integer

当前紫外线 (UV) 指数。
thunderstormProbability

integer

当前雷暴概率（值介于 0 到 100 之间）。

注意：对于日本和韩国境内的地点，此字段会从响应中省略。
cloudCover

integer

当前云层覆盖天空的百分比（值介于 0 到 100 之间）。

注意：对于日本和韩国境内的地点，此字段会从响应中省略。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

CurrentConditionsHistory

表示过去 24 小时内当前状况的一组变化。

JSON 表示法 
{
  "temperatureChange": {
    object (Temperature)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
字段
temperatureChange

object (Temperature)

当前温度减去 24 小时前的温度。
maxTemperature

object (Temperature)

过去 24 小时内的最高温度。
minTemperature

object (Temperature)

过去 24 小时内的最低温度。
snowQpf

object (QuantitativePrecipitationForecast)

在假设没有融化或压实的情况下，预计在一段时间内降落的雪量。注意：这是实际降雪量，而不是其液态水当量。QPF 是 Quantitative Precipitation Forecast（定量降水预报）的缩写（如需了解详情，请参阅 QuantitativePrecipitationForecast 定义）。
qpf

object (QuantitativePrecipitationForecast)

预计在一段时间内落下的所有降水（雨、雪、冰等）的总液态水当量。注意：QPF 是 Quantitative Precipitation Forecast（定量降水预报）的缩写（如需了解详情，请参阅 QuantitativePrecipitationForecast 定义）。