Method: forecast.lookup

Gibt tägliche Polleninformationen von bis zu 5 Tagen 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 sollen (Mindestwert 1, Höchstwert ist 5).
pageSize

integer

Optional. Die maximale Anzahl der täglichen Informationseinträge, die pro Seite zurückgegeben werden sollen. Der Standard- und Maximalwert ist 5 (Daten aus 5 Tagen).
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen täglichen Aufruf empfangen wurde. Sie wird verwendet, um die nachfolgende Seite abzurufen.

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

string

Optional. Ermöglicht dem Client, die Sprache für die Antwort auszuwählen. Wenn für diese Sprache keine Daten zur Verfügung gestellt werden können, verwendet die API die genaueste Übereinstimmung. Zulässige 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 deren Saisonabhängigkeit, besonderen Formen und Farben, Informationen zu allergischen Kreuzreaktionen und Pflanzenfotos.

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 ISO_3166-1 Alpha-2-Code des Landes/der Region, die dem in der Anfrage angegebenen Standort 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. Dies wird als Paar von Double-Werten zur Darstellung von Breiten- und Längengraden 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, zu dem die Pollenflugvorhersage-Daten dargestellt werden.
pollenTypeInfo[]

object (PollenTypeInfo)

Diese Liste enthält (bis zu) drei Pollenarten (Gras, Unkraut, Baum), die den in der Anfrage angegebenen Ort betreffen.
plantInfo[]

object (PlantInfo)

Diese Liste enthält (bis zu) 15 Pollenarten, die den in der Anfrage angegebenen Ort betreffen.

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 bedeuten:

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

Ähnliche Typen:

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

integer

Jahr des Datums. Der Wert 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 eines Monats Der Wert muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Mit 0 können Sie ein Jahr allein oder ein Jahr und einen Monat angeben, bei dem der Tag nicht von Bedeutung ist.

PollenTypeInfo

Dieses Objekt enthält den Pollentypindex und Gesundheitsempfehlungen zu bestimmten Pollentypen.

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

enum (PollenType)

Der Codename des Pollentyps. Beispiel: „GRASS“
displayName

string

Eine menschenlesbare Darstellung des Pollentypnamens. Beispiel: „Gras“
indexInfo

object (IndexInfo)

Enthält die Daten des Universal Pollen Index (UPI) für den Pollentyp.
healthRecommendations[]

string

Textbasierte Liste mit Erklärungen zu Gesundheitsinformationen, basierend auf dem aktuellen Pollenfluggehalt.
inSeason

boolean

Gibt an, ob die Pflanze in der Saison ist oder nicht.

PollenType

Pollentyp-Code

Enums
POLLEN_TYPE_UNSPECIFIED Nicht angegebener Pflanzentyp.
GRASS Pollenart von Gras.
TREE Pollentyp des Baumes.
WEED Pollen von Unkraut.

IndexInfo

Dieses Objekt enthält Daten, die einen bestimmten Pollenindexwert, eine Kategorie und eine 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 für Programmierzwecke dar, indem Snake Cases anstelle von Leerzeichen verwendet werden. Beispiel: „UPI“.
displayName

string

Eine menschenlesbare Darstellung des Indexnamens. Beispiel: „Universaler Pollenindex“.
category

string

Textklassifizierung der Interpretation des numerischen Indexwerts. Der Index besteht aus sechs Kategorien:

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

string

Textuelle Erklärung der aktuellen Indexebene.
color

object (Color)

Die Farbe, mit der der numerische Pollen-Index-Wert dargestellt wird.
value

integer

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

Index

Indexcode

Enums
INDEX_UNSPECIFIED Index nicht angegeben.
UPI Universal Pollen Index.

Farbe

Ermöglicht die Darstellung einer Farbe im RGBA-Farbraum. Diese Darstellung wurde für eine einfache Konvertierung in und aus Farbdarstellungen in verschiedenen Sprachen über Kompaktheit entwickelt. Die Felder dieser Darstellung können beispielsweise dem Konstruktor von java.awt.Color in Java ganz einfach zur Verfügung gestellt werden. Sie können auch einfach an die Methode +colorWithRed:green:blue:alpha von UIColor in iOS übergeben werden. Mit nur wenig Aufwand kann sie in JavaScript als CSS-rgba()-String formatiert werden.

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 für Anwendungen der sRGB-Farbraum verwendet werden.

Wenn eine Farbgleichheit entschieden werden muss, behandeln Implementierungen, sofern nicht anders angegeben, zwei Farben als gleich, wenn sich ihre Rot-, Grün-, Blau- und Alpha-Werte jeweils 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 dieses Farbobjekt nicht angegeben wird, wird es als Volltonfarbe dargestellt (als ob dem Alphawert explizit der Wert 1,0 gegeben 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“. Eine Liste aller verfügbaren Codes finden Sie hier.
displayName

string

Eine menschenlesbare Darstellung des Pflanzennamens. Beispiel: „Pflaume“.
indexInfo

object (IndexInfo)

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

object (PlantDescription)

Enthält allgemeine Informationen über Pflanzen, einschließlich Details zu deren Saisonabhängigkeit, besonderen Formen und Farben, Informationen zu allergischen Kreuzreaktionen und Pflanzenfotos.
inSeason

boolean

Zeigt an, ob die Pflanze gerade Saison hat oder nicht.

Pflanze

Listet verfügbare Pflanzen mit unterschiedlicher Verfügbarkeit zwischen Standorten auf.

Enums
PLANT_UNSPECIFIED Nicht spezifizierter Pflanzencode.
ALDER Erle wird als Baumpollenart eingestuft.
ASH Asche wird als Baumpollenart eingestuft.
BIRCH Birke gilt als Baumpollenart.
COTTONWOOD Baumwolle wird als Baumpollentyp klassifiziert.
ELM Ulme wird als Pollenart von Bäumen eingestuft.
MAPLE Ahorn wird als Arten von Baumpollen eingestuft.
OLIVE Oliven gelten als Pollen von Bäumen.
JUNIPER Wacholder wird als Baumpollenart eingestuft.
OAK Eiche gilt als Pollenart von Bäumen.
PINE Kiefer wird als Baumpollenart eingestuft.
CYPRESS_PINE Zypressenkiefern gelten als Pollen von Bäumen.
HAZEL Haselnuss wird als Baumpollenart eingestuft.
GRAMINALES Graminales gelten als Pollen von Gräsern.
RAGWEED Ambrosia gilt als Pollen von Unkraut.
MUGWORT Beifuß wird als Pollenart von Unkraut eingestuft.

PlantDescription

Enthält allgemeine Informationen über Pflanzen, einschließlich Details zu deren Saisonabhängigkeit, besonderen 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“. Eine Liste aller verfügbaren Codes finden Sie hier.
family

string

Eine für Menschen lesbare Darstellung des Namens der Pflanzenfamilie. Beispiel: „Betulaceae (Familie der Birkengewächse)“.
season

string

Textuelle Liste mit Erläuterungen zu den Jahreszeiten, in denen die Pollenbelastung aktiv ist. Beispiel: „Später Winter, Frühling“.
specialColors

string

Textuelle Beschreibung der Pflanzenfarben von Blättern, Rinden, Blumen oder Samen, anhand derer die Pflanze identifiziert werden kann.
specialShapes

string

Eine Textbeschreibung der Pflanzenformen aus Blättern, Rinden, Blüten oder Samen, anhand derer die Pflanze identifiziert werden kann.
crossReaction

string

Textuelle Beschreibung von Pollen-Kreuzreaktionspflanzen. Beispiele: Pollen von Erle, Haselnuss, Hainbuche, Buche, Weide und Eiche.
picture

string

Einen Link zum Bild der Pflanze
pictureCloseup

string

Link zu einer Nahaufnahme der Pflanze