Method: currentConditions.lookup

指定された場所の現在の気象状況を返します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

クエリ パラメータ

パラメータ
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)

現在の暑さ指数。

注: 日本と韓国の地域では、高温の場合は heatIndex が返され、それ以外の場合は省略されます。

windChill

object (Temperature)

現在の体感温度(皮膚が感じる気温)。

注: 日本と韓国の地域では、非常に低い気温の場合は windChill が返され、それ以外の場合は省略されます。

precipitation

object (Precipitation)

現在の降水確率と過去 1 時間の累積降水量。

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 の定義をご覧ください)。