- HTTP-Anfrage
- Suchparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- LatLng
- DayInfo
- Datum
- PollenTypeInfo
- PollenType
- IndexInfo
- Index
- Farbe
- PlantInfo
- Pflanze
- PlantDescription
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 |
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 sollen (Mindestwert 1, Höchstwert ist 5). |
pageSize |
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 |
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 |
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 |
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 ( |
Felder | |
---|---|
regionCode |
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[] |
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. 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 |
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, zu dem die Pollenflugvorhersage-Daten dargestellt werden. |
pollenTypeInfo[] |
Diese Liste enthält (bis zu) drei Pollenarten (Gras, Unkraut, Baum), die den in der Anfrage angegebenen Ort betreffen. |
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:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON-Darstellung |
---|
{ "year": integer, "month": integer, "day": integer } |
Felder | |
---|---|
year |
Jahr des Datums. Der Wert 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 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 ( |
Felder | |
---|---|
code |
Der Codename des Pollentyps. Beispiel: „GRASS“ |
displayName |
Eine menschenlesbare Darstellung des Pollentypnamens. Beispiel: „Gras“ |
indexInfo |
Enthält die Daten des Universal Pollen Index (UPI) für den Pollentyp. |
healthRecommendations[] |
Textbasierte Liste mit Erklärungen zu Gesundheitsinformationen, basierend auf dem aktuellen Pollenfluggehalt. |
inSeason |
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 ( |
Felder | |
---|---|
code |
Der Code des Index. Dieses Feld stellt den Index für Programmierzwecke dar, indem Snake Cases anstelle von Leerzeichen verwendet werden. Beispiel: „UPI“. |
displayName |
Eine menschenlesbare Darstellung des Indexnamens. Beispiel: „Universaler Pollenindex“. |
category |
Textklassifizierung der Interpretation des numerischen Indexwerts. Der Index besteht aus sechs Kategorien:
|
indexDescription |
Textuelle Erklärung der aktuellen Indexebene. |
color |
Die Farbe, mit der der numerische Pollen-Index-Wert dargestellt wird. |
value |
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 |
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 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 ( |
Felder | |
---|---|
code |
Der Name des Pflanzencodes. Beispiel: „COTTONWOOD“. Eine Liste aller verfügbaren Codes finden Sie hier. |
displayName |
Eine menschenlesbare Darstellung des Pflanzennamens. Beispiel: „Pflaume“. |
indexInfo |
Dieses Objekt enthält Daten, die einen bestimmten Pollenindexwert, eine Kategorie und eine Beschreibung darstellen. |
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 |
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 ( |
Felder | |
---|---|
type |
Die Pollenart der Pflanze. Beispiel: „GRASS“. Eine Liste aller verfügbaren Codes finden Sie hier. |
family |
Eine für Menschen lesbare Darstellung des Namens der Pflanzenfamilie. Beispiel: „Betulaceae (Familie der Birkengewächse)“. |
season |
Textuelle Liste mit Erläuterungen zu den Jahreszeiten, in denen die Pollenbelastung aktiv ist. Beispiel: „Später Winter, Frühling“. |
specialColors |
Textuelle Beschreibung der Pflanzenfarben von Blättern, Rinden, Blumen oder Samen, anhand derer die Pflanze identifiziert werden kann. |
specialShapes |
Eine Textbeschreibung der Pflanzenformen aus Blättern, Rinden, Blüten oder Samen, anhand derer die Pflanze identifiziert werden kann. |
crossReaction |
Textuelle Beschreibung von Pollen-Kreuzreaktionspflanzen. Beispiele: Pollen von Erle, Haselnuss, Hainbuche, Buche, Weide und Eiche. |
picture |
Einen Link zum Bild der Pflanze |
pictureCloseup |
Link zu einer Nahaufnahme der Pflanze |