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，并使用 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)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
字段
temperatureChange

object (Temperature)

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

object (Temperature)

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

object (Temperature)

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

object (QuantitativePrecipitationForecast)

过去 24 小时累积的降水量（雨或雪），以等同于液态水的量表示。注意：QPF 是“定量降水预报”的缩写（如需了解详情，请参阅 QuantitativePrecipitationForecast 定义）。