Method: forecast.days.lookup

Gibt bis zu 10 Tage mit täglichen Vorhersagen für einen bestimmten Ort zurück, beginnend mit dem aktuellen Tag.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
location

object (LatLng)

Erforderlich. Der Standort, für den die tägliche Vorhersage abgerufen werden soll.
unitsSystem

enum (UnitsSystem)

Optional. Das Einheitensystem, das für die zurückgegebenen Wetterbedingungen verwendet werden soll. Wenn keine Angabe erfolgt, werden die zurückgegebenen Wetterbedingungen im metrischen System angegeben (Standard = METRIC).
pageSize

integer

Optional. Die maximale Anzahl der täglich zurückzugebenden Vorhersagedatensätze pro Seite. Der Wert muss zwischen 1 und 10 liegen (einschließlich). Der Standardwert ist 5.
pageToken

string

Optional. Ein Seitentoken, das von einer vorherigen Anfrage empfangen wurde. Sie wird zum Abrufen der nachfolgenden Seite verwendet.
days

integer

Optional. Begrenzt die Anzahl der ab dem aktuellen Tag abzurufenden Tage auf einen Wert zwischen 1 und 10 (einschließlich). Der Standardwert ist der maximal zulässige Wert von 10.
languageCode

string

Optional. Ermöglicht dem Client, die Sprache für die Antwort auszuwählen. Wenn für diese Sprache keine Daten verfügbar sind, wird die nächstgelegene Übereinstimmung verwendet. Zulässige Werte basieren auf dem IETF BCP-47-Standard. Der Standardwert ist „en“.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort für den RPC „days.lookup“.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "forecastDays": [
    {
      object (ForecastDay)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Felder
forecastDays[]

object (ForecastDay)

Die täglichen Vorhersagedatensätze entsprechend der Anzahl der Tage und der Seitengröße, die in der Anfrage angegeben sind.
timeZone

object (TimeZone)

Die Zeitzone am angeforderten Ort.
nextPageToken

string

Das Token zum Abrufen der nächsten Seite.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

ForecastDay

Stellt einen täglichen Prognosedatensatz für einen bestimmten Standort dar.

JSON-Darstellung 
{
  "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)
  }
}
Felder
interval

object (Interval)

Das UTC-Zeitintervall, in dem dieser prognostizierte Tag beginnt (einschließlich) und endet (ausschließlich). Hinweis: Ein Tag beginnt um 7:00 Uhr und endet am nächsten Tag um 7:00 Uhr Ortszeit. Beispiel: Wenn die lokale Zeitzone UTC-7 ist, beginnt das Intervall um 14:00:00.000Z und endet am nächsten Tag zur selben Stunde.
displayDate

object (Date)

Das lokale Datum in der Zeitzone des Ortes (bürgerliche Zeit), für das diese Tagesvorhersage berechnet wird. Dieses Feld kann für die Anzeige auf dem Client verwendet werden.
daytimeForecast

object (ForecastDayPart)

Die vorhergesagten Wetterbedingungen für den Tag (7:00 bis 19:00 Uhr Ortszeit).
nighttimeForecast

object (ForecastDayPart)

Die prognostizierten Wetterbedingungen für die Nacht (19:00 Uhr bis 7:00 Uhr am nächsten Tag, Ortszeit).
maxTemperature

object (Temperature)

Die Höchsttemperatur des Tages.
minTemperature

object (Temperature)

Die niedrigste Temperatur des Tages.
feelsLikeMaxTemperature

object (Temperature)

Die maximale (hohe) gefühlte Temperatur im Tagesverlauf.
feelsLikeMinTemperature

object (Temperature)

Die niedrigste gefühlte Temperatur im Laufe des Tages.
maxHeatIndex

object (Temperature)

Die maximale Hitzeindex-Temperatur im Laufe des Tages.
sunEvents

object (SunEvents)

Die Ereignisse im Zusammenhang mit der Sonne (z.B. Sonnenaufgang, Sonnenuntergang).
moonEvents

object (MoonEvents)

Die Ereignisse im Zusammenhang mit dem Mond (z.B. Mondaufgang, Monduntergang).

Datum

Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Die Uhrzeit und die Zeitzone werden entweder an einer anderen Stelle angegeben oder sind nicht relevant. Das Datum wird relativ zum gregorianischen Kalender angegeben. Das kann Folgendes darstellen:

  • Ein vollständiges Datum mit Werten für Jahr, Monat und Tag, die nicht 0 sind.
  • Einen Monat und einen Tag mit einem Jahr von 0 (z. B. ein Jahrestag).
  • Ein Jahr für sich, mit einem Monat und einem Tag von 0.
  • Ein Jahr und ein Monat mit einem Tag von 0, z. B. ein Ablaufdatum der Kreditkarte.

Ähnliche Typen:

JSON-Darstellung 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Felder
year

integer

Jahr des Datums. Es muss zwischen 1 und 9999 liegen oder kann 0 sein, wenn ein Datum ohne Jahresangabe angegeben wird.
month

integer

Monat eines Jahres. Die Angabe muss zwischen 1 und 12 liegen. Sie kann auch 0 sein, wenn ein Jahr ohne Monat und Tag angegeben wird.
day

integer

Tag des Monats. Die Angabe muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Sie kann auch 0 sein, wenn das Jahr bzw. der Monat angegeben wird, der Tag selbst jedoch nicht von Belang ist.

ForecastDayPart

Stellt einen Prognosedatensatz für einen Teil des Tages dar.

JSON-Darstellung 
{
  "interval": {
    object (Interval)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Felder
interval

object (Interval)

Das UTC-Datum und die UTC-Uhrzeit, zu der dieser Teil des Tages beginnt (einschließlich) und endet (ausschließlich). Hinweis: Ein Teil eines Tages beginnt um 7:00 Uhr und endet um 19:00 Uhr desselben Tages (Ortszeit). Beispiel: Wenn die lokale Zeitzone UTC-7 ist, beginnt das Tageszeitintervall um 14:00:00.000Z und endet am nächsten Tag um 02:00:00.000Z. Das Nachtzeitintervall beginnt am nächsten Tag um 02:00:00.000Z und endet am selben Tag um 14:00:00.000Z.
weatherCondition

object (WeatherCondition)

Die vorhergesagte Wetterlage.
precipitation

object (Precipitation)

Der vorhergesagte Niederschlag.
wind

object (Wind)

Die durchschnittliche Windrichtung sowie die maximale Windgeschwindigkeit und Windböe.
iceThickness

object (IceThickness)

Die angesammelte Menge an Eis für den Teil des Tages.
relativeHumidity

integer

Der prognostizierte Prozentsatz der relativen Luftfeuchtigkeit (Werte von 0 bis 100).
uvIndex

integer

Der maximal prognostizierte ultraviolette (UV) Index.
thunderstormProbability

integer

Die durchschnittliche Gewitterwahrscheinlichkeit.
cloudCover

integer

Durchschnittlicher Prozentsatz der Wolkendecke.

SunEvents

Stellt die Ereignisse im Zusammenhang mit der Sonne dar (z.B. Sonnenaufgang, Sonnenuntergang).

JSON-Darstellung 
{
  "sunriseTime": string,
  "sunsetTime": string
}
Felder
sunriseTime

string (Timestamp format)

Die Zeit, zu der die Sonne aufgeht.

HINWEIS: In einigen besonderen Fällen (z.B. nördlich des Polarkreises) gibt es an einem Tag möglicherweise keine Sonnenaufgangszeit. In diesen Fällen wird dieses Feld nicht festgelegt.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
sunsetTime

string (Timestamp format)

Die Zeit, zu der die Sonne untergeht.

HINWEIS: In einigen besonderen Fällen (z.B. nördlich des Polarkreises) gibt es an einem Tag möglicherweise keine Sonnenuntergangszeit. In diesen Fällen wird dieses Feld nicht festgelegt.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

MoonEvents

Stellt die Ereignisse im Zusammenhang mit dem Mond dar, z.B. Mondaufgang und Monduntergang.

JSON-Darstellung 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
Felder
moonriseTimes[]

string (Timestamp format)

Die Zeit, zu der der obere Rand des Mondes über dem Horizont erscheint (siehe https://en.wikipedia.org/wiki/Moonrise_and_moonset)).

HINWEIS: In den meisten Fällen gibt es nur eine Zeit für den Mondaufgang pro Tag. In anderen Fällen ist die Liste möglicherweise leer, z.B. wenn der Mond nach Mitternacht des nächsten Tages aufgeht. In Sonderfällen (z.B. in Polarregionen) kann die Liste jedoch mehr als einen Wert enthalten. In diesen Fällen werden die Werte in aufsteigender Reihenfolge sortiert.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
moonsetTimes[]

string (Timestamp format)

Die Zeit, zu der der obere Rand des Mondes unter dem Horizont verschwindet (siehe https://en.wikipedia.org/wiki/Moonrise_and_moonset)).

HINWEIS: In den meisten Fällen gibt es nur eine Monduntergangszeit pro Tag. In anderen Fällen ist die Liste möglicherweise leer, z.B. wenn der Mond nach Mitternacht des nächsten Tages untergeht. In Sonderfällen (z.B. in Polarregionen) kann die Liste jedoch mehr als einen Wert enthalten. In diesen Fällen werden die Werte in aufsteigender Reihenfolge sortiert.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
moonPhase

enum (MoonPhase)

Die Mondphase.

MoonPhase

Markiert die Mondphase.

Enums
MOON_PHASE_UNSPECIFIED Nicht angegebene Mondphase.
NEW_MOON Der Mond wird nicht von der Sonne beleuchtet.
WAXING_CRESCENT Der Mond wird in der nördlichen Hemisphäre zu 0–50 % auf der rechten Seite beleuchtet 🌒 und in der südlichen Hemisphäre auf der linken Seite 🌘.
FIRST_QUARTER Der Mond wird in der nördlichen Hemisphäre zu 50,1% auf der rechten Seite 🌓 und in der südlichen Hemisphäre auf der linken Seite 🌗 beleuchtet.
WAXING_GIBBOUS Der Mond ist in der nördlichen Hemisphäre zu 50–100 % auf der rechten Seite 🌔 und in der südlichen Hemisphäre auf der linken Seite 🌖 beleuchtet.
FULL_MOON Der Mond ist vollständig beleuchtet.
WANING_GIBBOUS Der Mond wird in der nördlichen Hemisphäre zu 50–100 % auf der linken Seite 🌖 und in der südlichen Hemisphäre auf der rechten Seite 🌔 beleuchtet.
LAST_QUARTER Der Mond wird in der nördlichen Hemisphäre zu 50,1% auf der linken Seite 🌗 und in der südlichen Hemisphäre auf der rechten Seite 🌓 beleuchtet.
WANING_CRESCENT Der Mond ist in der nördlichen Hemisphäre zu 0–50 % auf der linken Seite 🌘 und in der südlichen Hemisphäre auf der rechten Seite 🌒 beleuchtet.