指定した場所の現在の天気を返します。
HTTP リクエスト
GET https://weather.googleapis.com/v1/currentConditions:lookup
この URL は gRPC Transcoding 構文を使用します。
クエリ パラメータ
パラメータ | |
---|---|
location |
必須。現在の天気情報を取得する場所。 |
units |
省略可。返される天候の状態に使用する単位システム。指定しない場合、返される天候はメートル法で表示されます(デフォルト = METRIC)。 |
language |
省略可。クライアントがレスポンスの言語を選択できるようにします。その言語のデータを提供できない場合は、最も近い一致が使用されます。使用できる値は IETF BCP-47 標準に準拠しています。デフォルト値は「en」です。 |
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
currentConditions.lookup RPC のレスポンス - リクエストされた場所の現在の天気を表します。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
JSON 表現 |
---|
{ "currentTime": string, "timeZone": { object ( |
フィールド | |
---|---|
current |
返されたデータに関連付けられた現在の時刻(UTC)。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
time |
リクエストされた場所のタイムゾーン。 |
weather |
現在の天候状態。 |
temperature |
現在の気温。 |
feels |
リクエストされた場所の現在の体感温度。 |
dew |
現在の露点温度。 |
heat |
現在の暑さ指数。 |
wind |
現在の風速と気温から算出される、皮膚に感じる気温。 |
precipitation |
現在の降水確率と過去 1 時間の降水量の合計。 |
air |
現在の気圧の状態。 |
wind |
現在の風の状態。 |
visibility |
現在の公開設定。 |
current |
過去 24 時間の現在の状況の変化。 |
is |
リクエストされた場所の現在時刻が、現地の日の出時刻(含む)から日の入り時刻(含まない)の間にある場合、true になります。それ以外の場合は、夜間(日没から次の日の日の出まで)です。 |
relative |
現在の相対湿度の割合(0 ~ 100 の値)。 |
uv |
現在の紫外線(UV)インデックス。 |
thunderstorm |
現在の雷雨の確率(0 ~ 100 の値)。 |
cloud |
雲に覆われている空の現在の割合(0 ~ 100 の値)。 |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/cloud-platform
CurrentConditionsHistory
過去 24 時間の現在の状況の変化のセットを表します。
JSON 表現 |
---|
{ "temperatureChange": { object ( |
フィールド | |
---|---|
temperature |
現在の気温から 24 時間前の気温を差し引いた値。 |
max |
過去 24 時間の最高気温。 |
min |
過去 24 時間の最低気温。 |
qpf |
過去 24 時間に降った降水量(雨または雪)の量(液体水換算)。注: QPF は定量的降水量予報の略です(詳細については、QuantitativePrecipitationForecast の定義をご覧ください)。 |