指定された場所の現在の気象状況を返します。
HTTP リクエスト
GET https://weather.googleapis.com/v1/currentConditions:lookup
この URL は gRPC Transcoding 構文を使用します。
クエリ パラメータ
| パラメータ | |
|---|---|
location |
必須。現在の気象条件を取得する場所。 |
unitsSystem |
省略可。返される気象条件に使用する単位系。指定しない場合、返される気象条件はメートル法になります(デフォルト = METRIC)。 |
languageCode |
省略可。クライアントが回答の言語を選択できるようにします。その言語のデータを提供できない場合、API は最も近い一致を使用します。使用できる値は IETF BCP-47 標準に準拠しています。デフォルト値は「en」です。 |
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
currentConditions.lookup RPC のレスポンス。リクエストされた場所の現在の気象条件を表します。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
| JSON 表現 |
|---|
{ "currentTime": string, "timeZone": { object ( |
| フィールド | |
|---|---|
currentTime |
返されたデータに関連付けられている現在の時刻(UTC)。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
timeZone |
リクエストされた場所のタイムゾーン。 |
weatherCondition |
現在の気象状況。 |
temperature |
現在の気温。 |
feelsLikeTemperature |
リクエストされた場所の現在の体感温度の測定値。 |
dewPoint |
現在の露点温度。 |
heatIndex |
現在の暑さ指数。 注: 日本と韓国の地域では、高温の場合は |
windChill |
現在の体感温度(皮膚が感じる気温)。 注: 日本と韓国の地域では、非常に低い気温の場合は |
precipitation |
現在の降水確率と過去 1 時間の累積降水量。 |
airPressure |
現在の気圧。 |
wind |
現在の風の状況。 |
visibility |
現在の公開設定。 注: このフィールドは、日本と韓国の地域に対して空のオブジェクトを返します。 |
currentConditionsHistory |
過去 24 時間の現在の状況の変化。 |
isDaytime |
リクエストされた場所の現在時刻が、現地の日の出(含む)から日の入り(含まない)までの間である場合は true。それ以外の場合は夜間(日没から翌日の日の出まで)です。 |
relativeHumidity |
現在の相対湿度の割合(0 ~ 100 の値)。 |
uvIndex |
現在の紫外線(UV)指数。 |
thunderstormProbability |
現在の雷雨の確率(0 ~ 100 の値)。 注: 日本と韓国の地域の場合、このフィールドはレスポンスから省略されます。 |
cloudCover |
雲に覆われている空の現在の割合(0 ~ 100 の値)。 注: 日本と韓国の地域の場合、このフィールドはレスポンスから省略されます。 |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/cloud-platform
CurrentConditionsHistory
過去 24 時間の現在の状況の変化のセットを表します。
| JSON 表現 |
|---|
{ "temperatureChange": { object ( |
| フィールド | |
|---|---|
temperatureChange |
現在の温度から 24 時間前の温度を引いた値。 |
maxTemperature |
過去 24 時間の最高気温。 |
minTemperature |
過去 24 時間の最低気温。 |
snowQpf |
融雪や圧縮がないと仮定した場合に、一定期間に降ると予測される雪の量。注: これは実際の積雪量であり、液体の水量に換算したものではありません。QPF は Quantitative Precipitation Forecast(定量的降水量予測)の略です(詳しくは、QuantitativePrecipitationForecast の定義をご覧ください)。 |
qpf |
一定期間に降ると予測されるすべての降水(雨、雪、氷など)の合計液体水量。注: QPF は Quantitative Precipitation Forecast(定量的降水量予測)の略です(詳細については、QuantitativePrecipitationForecast の定義をご覧ください)。 |