Method: forecast.lookup

Gibt tägliche Polleninformationen für bis zu 5 Tage in mehr als 65 Ländern mit einer Auflösung von bis zu 1 km zurück.

HTTP-Anfrage

GET https://pollen.googleapis.com/v1/forecast:lookup

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
location

object (LatLng)

Erforderlich. Der Längen- und Breitengrad, von dem aus die API nach Daten zur Pollenflugvorhersage sucht.

days

integer

Erforderlich. Eine Zahl, die angibt, wie viele Prognosetage angefordert werden (Mindestwert 1, Höchstwert 5).

pageSize

integer

Optional. Die maximale Anzahl der täglichen Informationsdatensätze, die pro Seite zurückgegeben werden sollen. Der Standard- und Maximalwert ist 5, was für Daten von 5 Tagen steht.

pageToken

string

Optional. Seitentoken, das bei einem vorherigen täglichen Anruf empfangen wurde. Damit wird die nachfolgende Seite abgerufen.

Wenn Sie einen Wert für das Seitentoken angeben, müssen alle anderen angegebenen Anfrageparameter mit dem vorherigen Aufruf übereinstimmen, in dem das Seitentoken bereitgestellt wurde.

languageCode

string

Optional. Ermöglicht dem Client, die Sprache für die Antwort auszuwählen. Wenn für diese Sprache keine Daten bereitgestellt werden können, verwendet die API die genaueste Übereinstimmung. Die zulässigen Werte basieren auf dem IETF BCP-47-Standard. Der Standardwert ist „en“.

plantsDescription

boolean

Optional. Enthält allgemeine Informationen über Pflanzen, einschließlich Details zu ihrer Saisonalität, speziellen Formen und Farben, Informationen zu allergischen Kreuzreaktionen und Pflanzenfotos. Der Standardwert ist „true“.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

JSON-Darstellung
{
  "regionCode": string,
  "dailyInfo": [
    {
      object (DayInfo)
    }
  ],
  "nextPageToken": string
}
Felder
regionCode

string

Der Alpha-2-Code nach ISO_3166-1 des Landes bzw. der Region, die dem in der Anfrage angegebenen Ort entspricht. Dieses Feld kann in der Antwort weggelassen werden, wenn sich der in der Anfrage angegebene Standort in einem umstrittenen Gebiet befindet.

dailyInfo[]

object (DayInfo)

Erforderlich. Dieses Objekt enthält die täglichen Prognoseinformationen für jeden angeforderten Tag.

nextPageToken

string

Optional. Das Token zum Abrufen der nächsten Seite.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

LatLng

Ein Objekt, das ein Paar aus Breiten- und Längengrad darstellt. Es wird als Paar aus Werten vom Typ „Double“ (Breiten- und Längengrad) ausgedrückt. Sofern nicht anders angegeben, muss dieses Objekt dem WGS84-Standard entsprechen. Die Werte müssen innerhalb normalisierter Bereiche liegen.

JSON-Darstellung
{
  "latitude": number,
  "longitude": number
}
Felder
latitude

number

Der Breitengrad in Grad. Er muss im Bereich [-90,0, +90,0] liegen.

longitude

number

Der Längengrad in Grad. Er muss im Bereich [-180,0, +180,0] liegen.

DayInfo

Dieses Objekt enthält die täglichen Prognoseinformationen für jeden angeforderten Tag.

JSON-Darstellung
{
  "date": {
    object (Date)
  },
  "pollenTypeInfo": [
    {
      object (PollenTypeInfo)
    }
  ],
  "plantInfo": [
    {
      object (PlantInfo)
    }
  ]
}
Felder
date

object (Date)

Das Datum in UTC, an dem die Pollenflugvorhersagedaten dargestellt werden.

pollenTypeInfo[]

object (PollenTypeInfo)

Diese Liste enthält bis zu drei Pollentypen (GRASS, WEED, TREE), die sich auf den in der Anfrage angegebenen Standort auswirken.

plantInfo[]

object (PlantInfo)

Diese Liste enthält bis zu 15 Pollenarten, die den in der Anfrage angegebenen Standort beeinflussen.

Datum

Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Tageszeit und Zeitzone werden entweder an anderer Stelle angegeben oder sind unbedeutend. Das Datum bezieht sich auf den gregorianischen Kalender. Dies kann Folgendes darstellen:

  • Ein vollständiges Datum mit Werten für Jahr, Monat und Tag ungleich null.
  • Ein Monat und ein Tag mit einem Jahr von 0 (z. B. ein Jahrestag).
  • Ein Jahr für sich alleine, mit einem Monat und einem Tag von null.
  • Ein Jahr und ein Monat mit 0 Tag (z. B. dem Ablaufdatum einer Kreditkarte).

Ähnliche Typen:

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

integer

Jahr des Datums. Muss zwischen 1 und 9999 liegen oder 0, um ein Datum ohne Jahr anzugeben.

month

integer

Monat eines Jahres. Muss zwischen 1 und 12 liegen oder 0, um ein Jahr ohne Monat und Tag anzugeben.

day

integer

Tag im Monat. Muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein, oder 0, um ein Jahr allein oder ein Jahr und Monat anzugeben, wenn der Tag nicht von Bedeutung ist.

PollenTypeInfo

Dieses Objekt enthält den Indextyp des Pollentyps und Gesundheitsempfehlungen zum jeweiligen Pollentyp.

JSON-Darstellung
{
  "code": enum (PollenType),
  "displayName": string,
  "indexInfo": {
    object (IndexInfo)
  },
  "healthRecommendations": [
    string
  ],
  "inSeason": boolean
}
Felder
code

enum (PollenType)

Der Codename der Pollenart. Beispiel: „GRASS“

displayName

string

Eine menschenlesbare Darstellung des Namen des Pollentyps. Beispiel: „Gras“

indexInfo

object (IndexInfo)

Enthält die UPI-Daten (Universal Pollen Index) für den Pollentyp.

healthRecommendations[]

string

Textbasierte Liste von Erläuterungen, die sich auf Gesundheitsdaten auf Grundlage der aktuellen Pollenbelastung beziehen.

inSeason

boolean

Angabe, ob die Pflanze Saison hat oder nicht.

PollenType

Code für die Pollenart

Enums
POLLEN_TYPE_UNSPECIFIED Nicht spezifizierter Pflanzentyp.
GRASS Graspollenart.
TREE Baumpollenart.
WEED Art der Unkrautpollenart.

IndexInfo

Dieses Objekt enthält Daten, die einen bestimmten Pollenindexwert, die Kategorie und die Beschreibung darstellen.

JSON-Darstellung
{
  "code": enum (Index),
  "displayName": string,
  "category": string,
  "indexDescription": string,
  "color": {
    object (Color)
  },
  "value": integer
}
Felder
code

enum (Index)

Der Code des Index. Dieses Feld stellt den Index zu Programmierzwecken dar, indem Snake-Cases anstelle von Leerzeichen verwendet werden. Beispiel: „UPI“.

displayName

string

Eine menschenlesbare Darstellung des Indexnamens. Beispiel: „Universal Pollen Index“.

category

string

Textklassifizierung zur Interpretation der numerischen Indexpunktzahl. Der Index besteht aus sechs Kategorien:

  • 0: "Keine"
  • 1: „Sehr niedrig“
  • 2: „Niedrig“
  • 3: „Moderat“
  • 4: „Hoch“
  • 5: „Sehr hoch
indexDescription

string

Textbasierte Erläuterung der aktuellen Indexebene.

color

object (Color)

Die Farbe, die für den numerischen Wert des Pollenindex verwendet wird.

value

integer

Der numerische Wert des Index. Der numerische Bereich liegt zwischen 0 und 5.

Index

Indexcode

Enums
INDEX_UNSPECIFIED Nicht angegebener Index.
UPI Universal Pollen Index.

Farbe

Ermöglicht die Darstellung einer Farbe im RGBA-Farbraum. Diese Darstellung ist auf die einfache Konvertierung in und aus Farbdarstellungen in verschiedenen Sprachen statt auf Kompaktheit ausgelegt. Die Felder dieser Darstellung können beispielsweise einfach dem Konstruktor von java.awt.Color in Java bereitgestellt werden. Sie kann auch einfach über die Methode +colorWithRed:green:blue:alpha von UIColor in iOS bereitgestellt werden. Außerdem lässt er sich mit wenig Aufwand in JavaScript als CSS-String rgba() formatieren.

Diese Referenzseite enthält keine Informationen zum absoluten Farbraum, der zur Interpretation des RGB-Werts verwendet werden sollte, z. B. sRGB, Adobe RGB, DCI-P3 und BT.2020. Standardmäßig sollte in Anwendungen der sRGB-Farbraum verwendet werden.

Wenn die Farbgleichheit beschlossen werden muss, werden Implementierungen, sofern nicht anders angegeben, zwei Farben als gleich behandelt, wenn sich alle ihre Rot-, Grün-, Blau- und Alphawerte um höchstens 1e-5 unterscheiden.

Beispiel (Java):

 import com.google.type.Color;

 // ...
 public static java.awt.Color fromProto(Color protocolor) {
   float alpha = protocolor.hasAlpha()
       ? protocolor.getAlpha().getValue()
       : 1.0;

   return new java.awt.Color(
       protocolor.getRed(),
       protocolor.getGreen(),
       protocolor.getBlue(),
       alpha);
 }

 public static Color toProto(java.awt.Color color) {
   float red = (float) color.getRed();
   float green = (float) color.getGreen();
   float blue = (float) color.getBlue();
   float denominator = 255.0;
   Color.Builder resultBuilder =
       Color
           .newBuilder()
           .setRed(red / denominator)
           .setGreen(green / denominator)
           .setBlue(blue / denominator);
   int alpha = color.getAlpha();
   if (alpha != 255) {
     result.setAlpha(
         FloatValue
             .newBuilder()
             .setValue(((float) alpha) / denominator)
             .build());
   }
   return resultBuilder.build();
 }
 // ...

Beispiel (iOS/Obj-C):

 // ...
 static UIColor* fromProto(Color* protocolor) {
    float red = [protocolor red];
    float green = [protocolor green];
    float blue = [protocolor blue];
    FloatValue* alpha_wrapper = [protocolor alpha];
    float alpha = 1.0;
    if (alpha_wrapper != nil) {
      alpha = [alpha_wrapper value];
    }
    return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
 }

 static Color* toProto(UIColor* color) {
     CGFloat red, green, blue, alpha;
     if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
       return nil;
     }
     Color* result = [[Color alloc] init];
     [result setRed:red];
     [result setGreen:green];
     [result setBlue:blue];
     if (alpha <= 0.9999) {
       [result setAlpha:floatWrapperWithValue(alpha)];
     }
     [result autorelease];
     return result;
}
// ...

Beispiel (JavaScript):

// ...

var protoToCssColor = function(rgb_color) {
   var redFrac = rgb_color.red || 0.0;
   var greenFrac = rgb_color.green || 0.0;
   var blueFrac = rgb_color.blue || 0.0;
   var red = Math.floor(redFrac * 255);
   var green = Math.floor(greenFrac * 255);
   var blue = Math.floor(blueFrac * 255);

   if (!('alpha' in rgb_color)) {
      return rgbToCssColor(red, green, blue);
   }

   var alphaFrac = rgb_color.alpha.value || 0.0;
   var rgbParams = [red, green, blue].join(',');
   return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};

var rgbToCssColor = function(red, green, blue) {
  var rgbNumber = new Number((red << 16) | (green << 8) | blue);
  var hexString = rgbNumber.toString(16);
  var missingZeros = 6 - hexString.length;
  var resultBuilder = ['#'];
  for (var i = 0; i < missingZeros; i++) {
     resultBuilder.push('0');
  }
  resultBuilder.push(hexString);
  return resultBuilder.join('');
};

// ...
JSON-Darstellung
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
Felder
red

number

Der Rotanteil der Farbe als Wert im Intervall [0, 1].

green

number

Der Grünanteil der Farbe als Wert im Intervall [0, 1].

blue

number

Der Blauanteil der Farbe als Wert im Intervall [0, 1].

alpha

number

Der Anteil dieser Farbe, der auf den Pixel angewendet werden soll. Die endgültige Pixelfarbe wird durch folgende Gleichung definiert:

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

Der Wert 1,0 entspricht einer soliden Farbdarstellung, während die Farbe bei einem Wert von 0,0 vollständig transparent ist. Dabei wird anstelle eines einfachen Float-Skalarwerts eine Wrapper-Nachricht verwendet, sodass zwischen einem Standardwert und dem zurückgesetzten Wert unterschieden werden kann. Wenn keine Angabe gemacht wird, wird dieses Farbobjekt als Volltonfarbe gerendert, so als ob dem Alphawert explizit der Wert 1,0 zugewiesen worden wäre.

PlantInfo

Dieses Objekt enthält die täglichen Informationen zu einer bestimmten Pflanze.

JSON-Darstellung
{
  "code": enum (Plant),
  "displayName": string,
  "indexInfo": {
    object (IndexInfo)
  },
  "plantDescription": {
    object (PlantDescription)
  },
  "inSeason": boolean
}
Felder
code

enum (Plant)

Der Name des Pflanzencodes. Beispiel: „COTTONWOOD“. Hier findest du eine Liste aller verfügbaren Codes.

displayName

string

Eine menschenlesbare Darstellung des Pflanzennamens. Beispiel: „Pappelholz“.

indexInfo

object (IndexInfo)

Dieses Objekt enthält Daten, die einen bestimmten Pollenindexwert, die Kategorie und die Beschreibung darstellen.

plantDescription

object (PlantDescription)

Enthält allgemeine Informationen über Pflanzen, einschließlich Details zu ihrer Saisonalität, speziellen Formen und Farben, Informationen zu allergischen Kreuzreaktionen und Pflanzenfotos.

inSeason

boolean

Gibt an, ob die Pflanze Saison hat oder nicht.

Pflanze

Listet verfügbare Pflanzen mit variierender Verfügbarkeit an verschiedenen Standorten auf.

Enums
PLANT_UNSPECIFIED Unbekannter Pflanzencode.
ALDER Erle wird als Baumpollenart klassifiziert.
ASH Esche wird als Baumpollenart klassifiziert.
BIRCH Birke wird als Baumpollenart klassifiziert.
COTTONWOOD Pappel wird als Baumpollentyp eingestuft.
ELM Ulme ist als Baumpollenart klassifiziert.
MAPLE Ahorn wird als Baumpollenart klassifiziert.
OLIVE Die Pflanze wird als Baumpollenart eingestuft.
JUNIPER Wacholder wird als Baumpollenart eingestuft.
OAK Eiche wird als Baumpollenart eingestuft.
PINE Die Kiefer wird als Baumpollenart klassifiziert.
CYPRESS_PINE Die Zypressenkiefer wird als Baumpollenart klassifiziert.
HAZEL Haselnus wird als Baumpollentyp eingestuft.
GRAMINALES Graminales gehören zur Art des Graspollens.
RAGWEED Ambrosia gehört zu den Unkrautpollentypen.
MUGWORT Beifuß ist eine Art von Unkrautpollen.

PlantDescription

Enthält allgemeine Informationen über Pflanzen, einschließlich Details zu ihrer Saisonalität, speziellen Formen und Farben, Informationen zu allergischen Kreuzreaktionen und Pflanzenfotos.

JSON-Darstellung
{
  "type": enum (PollenType),
  "family": string,
  "season": string,
  "specialColors": string,
  "specialShapes": string,
  "crossReaction": string,
  "picture": string,
  "pictureCloseup": string
}
Felder
type

enum (PollenType)

Die Pollenart der Pflanze. Beispiel: „GRASS“. Hier findest du eine Liste aller verfügbaren Codes.

family

string

Eine menschenlesbare Darstellung des Namens der Pflanzenfamilie. Beispiel: „Betulaceae (Familie der Birkengewächse)“.

season

string

Textbasierte Liste von Erläuterungen zu Jahreszeiten, in denen der Pollen aktiv ist. Beispiel: „Später Winter, Frühling“.

specialColors

string

Textuelle Beschreibung der Pflanzen Farben von Blättern, Rinde, Blumen oder Samen, die die Identifizierung der Pflanze erleichtern.

specialShapes

string

Textuelle Beschreibung der Pflanzen Formen von Blättern, Rinde, Blumen oder Samen, anhand derer die Pflanze identifiziert werden kann.

crossReaction

string

Textuelle Beschreibung von Pflanzen mit Pollen-Kreuzreaktion. Beispiel: Pollen von Erle, Haselnuss, Hainbuche, Buche, Weide und Eiche.

picture

string

Link zum Bild der Pflanze.

pictureCloseup

string

Link zu einer Nahaufnahme der Pflanze.