Method: forecast.days.lookup

指定された場所の当日からの 10 日間の毎日の予報を返します。

HTTP リクエスト

GET https://weather.googleapis.com/v1/forecast/days:lookup

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

クエリ パラメータ

パラメータ
location

object (LatLng)

必須。毎日の予報を取得する場所。
unitsSystem

enum (UnitsSystem)

省略可。返される天気予報の単位系。指定しない場合、返される天気予報はメートル法になります（デフォルト = METRIC）。
pageSize

integer

省略可。ページごとに返す 1 日の天気予報レコードの最大数 - 1 ～ 10（両端を含む）の値。デフォルト値は 5 です。
pageToken

string

省略可。前のリクエストから受け取ったページトークン。後続のページを取得するために使用されます。
days

integer

省略可。現在の日付から取得する合計日数を制限します。1 ～ 10 の値（両端を含む）。デフォルト値は最大許容値の 10 です。
languageCode

string

省略可。クライアントがレスポンスの言語を選択できるようにします。その言語のデータを提供できない場合、API は最も近い一致を使用します。使用できる値は IETF BCP-47 標準に基づいています。デフォルト値は「en」です。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

days.lookup RPC のレスポンス。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "forecastDays": [
    {
      object (ForecastDay)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
フィールド
forecastDays[]

object (ForecastDay)

リクエストで指定された日数とページサイズに応じた、1 日ごとの予測レコード。
timeZone

object (TimeZone)

リクエストされた場所のタイムゾーン。
nextPageToken

string

次のページを取得するためのトークン。

認可スコープ

次の OAuth スコープが必要です。

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

ForecastDay

特定の場所での日次予報レコードを表します。

JSON 表現 
{
  "interval": {
    object (Interval)
  },
  "displayDate": {
    object (Date)
  },
  "daytimeForecast": {
    object (ForecastDayPart)
  },
  "nighttimeForecast": {
    object (ForecastDayPart)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "feelsLikeMaxTemperature": {
    object (Temperature)
  },
  "feelsLikeMinTemperature": {
    object (Temperature)
  },
  "maxHeatIndex": {
    object (Temperature)
  },
  "sunEvents": {
    object (SunEvents)
  },
  "moonEvents": {
    object (MoonEvents)
  }
}
フィールド
interval

object (Interval)

この予測日の開始（含む）と終了（含まない）の UTC 時間間隔。注: 1 日は午前 7 時（現地時間）に始まり、翌日の午前 7 時（現地時間）に終わります。たとえば、ローカル タイムゾーンが UTC-7 の場合、間隔は 14:00:00.000Z の時刻に始まり、翌日の同じ時刻に終了します。
displayDate

object (Date)

この毎日の天気予報が計算される場所のタイムゾーンの現地の日付（市民時間）。このフィールドは、クライアントでの表示に使用されることがあります。
daytimeForecast

object (ForecastDayPart)

1 日の昼間（午前 7 時から午後 7 時まで（現地時間））の天気予報。
nighttimeForecast

object (ForecastDayPart)

1 日の夜間（午後 7 時から翌朝 7 時まで、現地時間）の天気予報。
maxTemperature

object (Temperature)

1 日の最高気温。
minTemperature

object (Temperature)

1 日の最低気温。
feelsLikeMaxTemperature

object (Temperature)

1 日の最高体感温度。
feelsLikeMinTemperature

object (Temperature)

1 日の最低体感温度。
maxHeatIndex

object (Temperature)

1 日の最高暑さ指数。
sunEvents

object (SunEvents)

太陽に関連するイベント（日の出、日の入りなど）。
moonEvents

object (MoonEvents)

月に関連するイベント（月の出、月の入りなど）。

日付

誕生日などのように、カレンダーの日付全体またはその一部を表します。時間帯とタイムゾーンは、他の場所で指定されているか、重要ではありません。日付は西暦を基準にしており、これは次のいずれかを表します。

  • 年の値がゼロ以外である月と日の値を含む完全な日付
  • 年の値がゼロである月と日（記念日など）。
  • 月と日の値がゼロである単独の年。
  • 日の値がゼロである年と月（クレジット カードの有効期限など）

関連するタイプ:

JSON 表現 
{
  "year": integer,
  "month": integer,
  "day": integer
}
フィールド
year

integer

その日付の年。1～9999、または年のない日付を指定する場合は 0 にする必要があります。
month

integer

1 年の中の月。1～12、または月と日のない年を指定する場合は 0 にする必要があります。
day

integer

1 月の中の日付。1～31 で、その年と月で有効な値にする必要があります。または、日が重要でない場合は年のみか年と月を指定するには 0 にする必要があります。

ForecastDayPart

1 日の一部についての予測レコードを表します。

JSON 表現 
{
  "interval": {
    object (Interval)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
フィールド
interval

object (Interval)

この時間帯が開始（含む）および終了（含まない）する UTC の日付と時刻。注: 1 日の一部は、午前 7 時から午後 7 時まで（現地時間）です。たとえば、ローカル タイムゾーンが UTC-7 の場合、昼間の間隔は 14:00:00.000Z に始まり、翌日の 02:00:00.000Z に終了します。夜間の間隔は、翌日の 02:00:00.000Z に始まり、その日の 14:00:00.000Z に終了します。
weatherCondition

object (WeatherCondition)

天気予報の天気。
precipitation

object (Precipitation)

予測される降水量。
wind

object (Wind)

平均風向、最大風速、最大瞬間風速。
iceThickness

object (IceThickness)

1 日の特定の時間帯の氷の累積量。
relativeHumidity

integer

予測された相対湿度（0 ～ 100 の値）。
uvIndex

integer

予測される最大紫外線（UV）指数。
thunderstormProbability

integer

雷雨の平均確率。
cloudCover

integer

平均雲量（%）。

SunEvents

太陽に関連するイベント（日の出、日の入りなど）を表します。

JSON 表現 
{
  "sunriseTime": string,
  "sunsetTime": string
}
フィールド
sunriseTime

string (Timestamp format)

日の出の時刻。

注: 北極圏など、特殊なケースでは、日の出の時刻がない日もあります。このような場合、このフィールドは設定されません。

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"。
sunsetTime

string (Timestamp format)

日の入りの時刻。

注: 北極圏など、特殊なケースでは、1 日を通して日没がない場合があります。このような場合、このフィールドは設定されません。

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"。

MoonEvents

月に関連するイベント（月の出、月の入りなど）を表します。

JSON 表現 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
フィールド
moonriseTimes[]

string (Timestamp format)

月の上の縁が地平線上に現れる時刻（https://en.wikipedia.org/wiki/Moonrise_and_moonset) を参照）。

注: ほとんどの場合、1 日に 1 回だけ月が昇る時刻があります。それ以外の場合、リストが空になることがあります（たとえば、翌日の深夜 0 時以降に月が昇る場合）。ただし、特殊なケース（極地など）では、リストに複数の値が含まれることがあります。この場合、値は昇順で並べ替えられます。

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"。
moonsetTimes[]

string (Timestamp format)

月の上の端が地平線の下に沈む時刻（https://en.wikipedia.org/wiki/Moonrise_and_moonset) を参照）。

注: ほとんどの場合、1 日に 1 回月没時刻が設定されます。それ以外の場合、リストが空になることがあります（たとえば、翌日の深夜 0 時を過ぎてから月が沈む場合など）。ただし、特殊なケース（極地など）では、リストに複数の値が含まれることがあります。この場合、値は昇順で並べ替えられます。

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"。
moonPhase

enum (MoonPhase)

月相。

MoonPhase

月相（月の満ち欠け）をマークします。

列挙型
MOON_PHASE_UNSPECIFIED 月相が指定されていません。
NEW_MOON 月は太陽に照らされていません。
WAXING_CRESCENT 北半球では右側が 0 ～ 50% 照らされ 🌒、南半球では左側が 0 ～ 50% 照らされます 🌘。
FIRST_QUARTER 北半球では右側が 50.1% 照らされ 🌓、南半球では左側が 50.1% 照らされています 🌗。
WAXING_GIBBOUS 北半球では右側が 50 ～ 100% 照らされ 🌔、南半球では左側が 50 ～ 100% 照らされます 🌖。
FULL_MOON 月が完全に照らされている。
WANING_GIBBOUS 北半球では左側が 50 ～ 100% 照らされ 🌖、南半球では右側が 50 ～ 100% 照らされます 🌔。
LAST_QUARTER 北半球では左側が 50.1% 照らされ 🌗、南半球では右側が 50.1% 照らされています 🌓。
WANING_CRESCENT 北半球では左側が 0 ～ 50% 照らされ 🌘、南半球では右側が 0 ～ 50% 照らされます 🌒。