Package google.maps.pollen.v1

Index

Pollen

Dienstdefinition für die Pollen API.

LookupForecast

rpc LookupForecast(LookupForecastRequest) returns (LookupForecastResponse)

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.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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

LookupHeatmapTile

rpc LookupHeatmapTile(LookupHeatmapTileRequest) returns (HttpBody)

Gibt ein Byte-Array zurück, das die Daten des PNG-Kachelbilds enthält.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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

Index

Indexcode

Enums
INDEX_UNSPECIFIED Nicht angegebener Index.
UPI Universal Pollen Index.

IndexInfo

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

Felder
code

Index

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

display_name

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
index_description

string

Textbasierte Erläuterung der aktuellen Indexebene.

color

Color

Die Farbe, die zur Darstellung des numerischen Werts des Pollenindex verwendet wird.

value

int32

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

LookupForecastRequest

Felder
location

LatLng

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

days

int32

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

page_size

int32

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.

page_token

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.

language_code

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“.

plants_description

bool

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“.

LookupForecastResponse

Felder
region_code

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.

daily_info[]

DayInfo

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

next_page_token

string

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

DayInfo

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

Felder
date

Date

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

pollen_type_info[]

PollenTypeInfo

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

plant_info[]

PlantInfo

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

LookupHeatmapTileRequest

Eine Heatmap-Kachelanforderung. Die Struktur entspricht dem standardmäßigen GET-Aufruf des Kachelservers, also https://pollen.googleapis.com/v1/mapTypes/{map_type}/heatmapTiles/{zoom}/{x}/{y}.

Beispiel: [https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/0/0/0]

Felder
map_type

MapType

Erforderlich. Der Typ der Pollen-Heatmap. Definiert die Kombination aus Pollentyp und -index, die auf der Karte grafisch dargestellt wird.

zoom

int32

Erforderlich. Die Zoomstufe der Karte. Definiert, wie groß oder klein der Inhalt einer Karte in einer Kartenansicht angezeigt wird.

  • Zoomstufe 0 bezieht sich auf die gesamte Welt in einer einzelnen Kachel.
  • Zoomstufe 1 gibt die gesamte Welt in 4 Kacheln an.
  • Zoomstufe 2 gibt die ganze Welt mit 16 Kacheln an.
  • Zoomstufe 16 umfasst die gesamte Erde mit 65.536 Kacheln.

Zulässige Werte: 0–16

x

int32

Erforderlich. Definiert den Ost-West-Punkt in der angeforderten Kachel.

y

int32

Erforderlich. Definiert den Nord-Süd-Punkt in der angeforderten Kachel.

Kartentyp

Der Typ der Pollen-Heatmap. Definiert die Kombination aus Pollentyp und -index, die auf der Karte grafisch dargestellt wird.

Enums
MAP_TYPE_UNSPECIFIED Kartentyp nicht angegeben
TREE_UPI Der Heatmap-Typ stellt eine Grafikkarte mit einem Baumindex dar.
GRASS_UPI Der Heatmap-Typ repräsentiert eine grafische Karte mit Grasindex.
WEED_UPI Der Heatmap-Typ stellt eine grafische Karte mit Unkrautindex dar.

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.

Felder
type

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“.

special_colors

string

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

special_shapes

string

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

cross_reaction

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.

picture_closeup

string

Link zu einer Nahaufnahme der Pflanze.

PlantInfo

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

Felder
code

Plant

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

display_name

string

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

index_info

IndexInfo

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

plant_description

PlantDescription

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

in_season

bool

Gibt an, 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.

PollenTypeInfo

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

Felder
code

PollenType

Der Codename der Pollenart. Beispiel: „GRASS“

display_name

string

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

index_info

IndexInfo

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

health_recommendations[]

string

Textuelle Liste von Erläuterungen, die sich auf Gesundheitsdaten basierend auf dem aktuellen Pollenspiegel beziehen.

in_season

bool

Angabe, ob die Pflanze Saison hat oder nicht.