- HTTP-Anfrage
- Suchparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- LatLng
- DayInfo
- Datum
- PollenTypeInfo
- PollenType
- IndexInfo
- Index
- Color
- PlantInfo
- Pflanze
- PlantDescription
- Testen!
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 |
Erforderlich. Der Längen- und Breitengrad, von dem aus die API nach Daten zur Pollenflugvorhersage sucht. |
days |
Erforderlich. Eine Zahl, die angibt, wie viele Prognosetage angefordert werden (Mindestwert 1, Höchstwert 5). |
pageSize |
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 |
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 |
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 |
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 ( |
Felder | |
---|---|
regionCode |
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[] |
Erforderlich. Dieses Objekt enthält die täglichen Prognoseinformationen für jeden angeforderten Tag. |
nextPageToken |
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 |
Der Breitengrad in Grad. Er muss im Bereich [-90,0, +90,0] liegen. |
longitude |
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 ( |
Felder | |
---|---|
date |
Das Datum in UTC, an dem die Pollenflugvorhersagedaten dargestellt werden. |
pollenTypeInfo[] |
Diese Liste enthält bis zu drei Pollentypen (GRASS, WEED, TREE), die sich auf den in der Anfrage angegebenen Standort auswirken. |
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:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON-Darstellung |
---|
{ "year": integer, "month": integer, "day": integer } |
Felder | |
---|---|
year |
Jahr des Datums. Muss zwischen 1 und 9999 liegen oder 0, um ein Datum ohne Jahr anzugeben. |
month |
Monat eines Jahres. Muss zwischen 1 und 12 liegen oder 0, um ein Jahr ohne Monat und Tag anzugeben. |
day |
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 ( |
Felder | |
---|---|
code |
Der Codename der Pollenart. Beispiel: „GRASS“ |
displayName |
Eine menschenlesbare Darstellung des Namen des Pollentyps. Beispiel: „Gras“ |
indexInfo |
Enthält die UPI-Daten (Universal Pollen Index) für den Pollentyp. |
healthRecommendations[] |
Textbasierte Liste von Erläuterungen, die sich auf Gesundheitsdaten basierend auf der aktuellen Pollenbelastung beziehen. |
inSeason |
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 ( |
Felder | |
---|---|
code |
Der Code des Index. Dieses Feld stellt den Index zu Programmierzwecken dar, indem Snake-Cases anstelle von Leerzeichen verwendet werden. Beispiel: „UPI“. |
displayName |
Eine menschenlesbare Darstellung des Indexnamens. Beispiel: „Universal Pollen Index“. |
category |
Textklassifizierung zur Interpretation der numerischen Indexpunktzahl. Der Index besteht aus sechs Kategorien:
|
indexDescription |
Textbasierte Erläuterung der aktuellen Indexebene. |
color |
Die Farbe, die zur Darstellung des numerischen Werts des Pollenindex verwendet wird. |
value |
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 darauf ausgelegt, die Konvertierung in und aus Farbdarstellungen in verschiedenen Sprachen vor der Kompaktheit zu vereinfachen. 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 |
Der Rotanteil der Farbe als Wert im Intervall [0, 1]. |
green |
Der Grünanteil der Farbe als Wert im Intervall [0, 1]. |
blue |
Der Blauanteil der Farbe als Wert im Intervall [0, 1]. |
alpha |
Der Anteil dieser Farbe, der auf den Pixel angewendet werden soll. Die endgültige Pixelfarbe wird durch folgende Gleichung definiert:
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 ( |
Felder | |
---|---|
code |
Der Name des Pflanzencodes. Beispiel: „COTTONWOOD“. Hier findest du eine Liste aller verfügbaren Codes. |
displayName |
Eine menschenlesbare Darstellung des Pflanzennamens. Beispiel: „Pappelholz“. |
indexInfo |
Dieses Objekt enthält Daten, die einen bestimmten Pollenindexwert, die Kategorie und die Beschreibung darstellen. |
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 |
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 ( |
Felder | |
---|---|
type |
Die Pollenart der Pflanze. Beispiel: „GRASS“. Hier findest du eine Liste aller verfügbaren Codes. |
family |
Eine menschenlesbare Darstellung des Namens der Pflanzenfamilie. Beispiel: „Betulaceae (Familie der Birkengewächse)“. |
season |
Textbasierte Liste von Erläuterungen zu Jahreszeiten, in denen der Pollen aktiv ist. Beispiel: „Später Winter, Frühling“. |
specialColors |
Textuelle Beschreibung der Pflanzen Farben von Blättern, Rinde, Blumen oder Samen, die die Identifizierung der Pflanze erleichtern. |
specialShapes |
Textuelle Beschreibung der Pflanzen Formen von Blättern, Rinde, Blumen oder Samen, anhand derer die Pflanze identifiziert werden kann. |
crossReaction |
Textuelle Beschreibung von Pflanzen mit Pollen-Kreuzreaktion. Beispiel: Pollen von Erle, Haselnuss, Hainbuche, Buche, Weide und Eiche. |
picture |
Link zum Bild der Pflanze. |
pictureCloseup |
Link zu einer Nahaufnahme der Pflanze. |