Package google.maps.pollen.v1

Indeks

Pyłek

Definicja usługi dla interfejsu Pollen API.

LookupForecast

rpc LookupForecast(LookupForecastRequest) returns (LookupForecastResponse)

Zwraca dane o stężeniu pyłków dziennie z maksymalnie 5 dni w ponad 65 krajach (z dokładnością do 1 km).

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

LookupHeatmapTile

rpc LookupHeatmapTile(LookupHeatmapTileRequest) returns (HttpBody)

Zwraca tablicę bajtów zawierającą dane obrazu PNG z kafelkiem.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

Indeks

Kod indeksu

Wartości w polu enum
INDEX_UNSPECIFIED Nieokreślony indeks.
UPI Uniwersalny indeks pyłków.

IndexInfo

Ten obiekt zawiera dane reprezentujące określoną wartość indeksu pyłków, kategorię i opis.

Pola
code

Index

Kod indeksu. To pole przedstawia indeks do celów programowania z wykorzystaniem przypadków typu „snake” zamiast spacji. Przykład: „UPI”.

display_name

string

Zrozumiała dla człowieka nazwa nazwy indeksu. Przykład: „Uniwersalny indeks pyłków”.

category

string

Klasyfikacja tekstu interpretacji wyniku liczbowego indeksu. Indeks składa się z 6 kategorii:

  • 0: „Brak”
  • 1: „Bardzo niski”
  • 2: „Niska”
  • 3. „Umiarkowane”
  • 4: „Wysoki”
  • 5: „Bardzo wysoki
index_description

string

Wyjaśnienie tekstowe bieżącego poziomu indeksu.

color

Color

Kolor użyty do przedstawienia wyniku liczbowego w zakresie stężenia pyłków.

value

int32

Wynik liczbowy indeksu. Zakres liczbowy należy do zakresu od 0 do 5.

LookupForecastRequest

Pola
location

LatLng

Wymagane. Długość i szerokość geograficzna, z których interfejs API wyszukuje dane dotyczące prognozy stężenia pyłków.

days

int32

Wymagane. Liczba, która wskazuje, ile dni objęty prognozą ma zostać wysłane (minimalna wartość 1, wartość maksymalna to 5).

page_size

int32

Opcjonalnie: Maksymalna liczba dziennych rekordów informacyjnych do zwrócenia na stronę. Wartość domyślna i maksymalna to 5, co oznacza dane z 5 dni.

page_token

string

Opcjonalnie: Token strony otrzymany z poprzedniego dziennego połączenia. Służy do pobierania następnej strony.

Pamiętaj, że gdy podajesz wartość tokena strony, wszystkie pozostałe parametry żądania muszą pasować do poprzedniego wywołania, które dostarczyło token strony.

language_code

string

Opcjonalnie: Umożliwia klientowi wybór języka odpowiedzi. Jeśli nie można dostarczyć danych dla tego języka, interfejs API używa najbliższego dopasowania. Dozwolone wartości zależą od standardu IETF BCP-47. Wartością domyślną jest „en”.

plants_description

bool

Opcjonalnie: Zawiera ogólne informacje o roślinach, m.in. szczegóły dotyczące ich sezonowości, specjalne kształty i kolory, informacje o reakcjach krzyżowych oraz zdjęcia roślin. Wartość domyślna to „true”.

LookupForecastResponse

Pola
region_code

string

Kod ISO_3166-1 alfa-2 kraju lub regionu odpowiadający lokalizacji podanej w żądaniu. To pole może zostać pominięte w odpowiedzi, jeśli lokalizacja podana w prośbie znajduje się na terytorium, którego dotyczy spór.

daily_info[]

DayInfo

Wymagane. Ten obiekt zawiera informacje o prognozie dziennej dla każdego żądanego dnia.

next_page_token

string

Opcjonalnie: Token pobierania następnej strony.

DayInfo

Ten obiekt zawiera informacje o prognozie dziennej dla każdego żądanego dnia.

Pola
date

Date

Dzień, w którym podawane są dane dotyczące prognozy stężenia pyłków w strefie czasowej UTC.

pollen_type_info[]

PollenTypeInfo

Ta lista będzie zawierać maksymalnie 3 rodzaje pyłków (GRASS, WEED, Drzewo) wpływające na lokalizację wskazaną w prośbie.

plant_info[]

PlantInfo

Ta lista będzie zawierać do 15 gatunków pyłków wpływających na lokalizację podaną w prośbie.

LookupHeatmapTileRequest

Żądanie kafelka mapy termicznej. Struktura jest zgodna ze standardowym wywołaniem GET serwera kafelków, tj. https://pollen.googleapis.com/v1/mapTypes/{map_type}/heatmapTiles/{zoom}/{x}/{y}

Przykład: [https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/0/0/0]

Pola
map_type

MapType

Wymagane. Rodzaj mapy termicznej pyłków. Definiuje kombinację rodzaju i indeksu pyłków, które graficznie reprezentuje mapa.

zoom

int32

Wymagane. Poziom powiększenia mapy. Określa, jak duża lub mała zawartość mapy jest wyświetlana w widoku mapy.

  • Powiększenie na poziomie 0 to cały świat na jednym kafelku.
  • Powiększenie na poziomie 1 to cały świat podzielony na 4 kafelki.
  • W powiększeniu 2 to cały świat podzielony na 16 kafelków.
  • Powiększenie na poziomie 16 to cały świat podzielony na 65 536 kafelków.

Dozwolone wartości: 0–16

x

int32

Wymagane. Definiuje punkt wschód-zachód na żądanym kafelku.

y

int32

Wymagane. Definiuje punkt północ-południe żądanego kafelka.

MapType

Rodzaj mapy termicznej pyłków. Definiuje kombinację rodzaju i indeksu pyłków, które graficznie reprezentuje mapa.

Wartości w polu enum
MAP_TYPE_UNSPECIFIED Nieokreślony typ mapy.
TREE_UPI Typ mapy termicznej reprezentuje mapę graficzną indeksu drzew.
GRASS_UPI Typ mapy termicznej jest mapą graficzną wskaźnika trawy.
WEED_UPI Typ mapy termicznej jest mapą graficzną wskaźnika chwastów.

Roślina

Zawiera listę dostępnych roślin o różnej dostępności w poszczególnych lokalizacjach.

Wartości w polu enum
PLANT_UNSPECIFIED Nieokreślony kod rośliny.
ALDER Olchę zalicza się do rodzaju pyłków drzew.
ASH Popielaty są klasyfikowane jako rodzaj pyłków drzew.
BIRCH Brzoza jest klasyfikowana jako rodzaj pyłków drzew.
COTTONWOOD Topa jest klasyfikowana jako rodzaj pyłku drzewa.
ELM Wiąz jest klasyfikowany jako rodzaj pyłków drzew.
MAPLE Klon jest klasyfikowany jako rodzaj pyłków drzew.
OLIVE Oliwka jest klasyfikowana jako rodzaj pyłków drzew.
JUNIPER Jałowiec jest klasyfikowany jako rodzaj pyłków drzew.
OAK Dąb jest klasyfikowany jako rodzaj pyłków drzew.
PINE Sosna jest klasyfikowana jako rodzaj pyłków drzew.
CYPRESS_PINE Sosna cyprysowa jest klasyfikowana jako rodzaj pyłków drzew.
HAZEL Leszczyna jest klasyfikowana jako rodzaj pyłku drzewa.
GRAMINALES Graminales jest klasyfikowany jako pyłek trawy.
RAGWEED Ambrozja jest klasyfikowana jako rodzaj pyłku chwastego.
MUGWORT Bylina jest klasyfikowana jako rodzaj pyłków chwastych.

PlantDescription

Zawiera ogólne informacje o roślinach, m.in. szczegóły dotyczące ich sezonowości, specjalne kształty i kolory, informacje o reakcjach krzyżowych oraz zdjęcia roślin.

Pola
type

PollenType

Rodzaj pyłków rośliny. Na przykład: „GRASS”. Tutaj znajdziesz listę wszystkich dostępnych kodów.

family

string

Zrozumiała dla człowieka nazwa rodziny roślin. Przykład: „Betulaceae (brzozowate)”.

season

string

Tekstowa lista terminów, w których pyłki są aktywne. Przykład: „Późna zima, wiosna”.

special_colors

string

Opis tekstowy roślin kolory liści, kory, kwiatów i nasion, które ułatwiają identyfikację rośliny.

special_shapes

string

Opis tekstowy roślin kształt liści, kory, kwiatów lub nasion, co pomaga zidentyfikować roślinę.

cross_reaction

string

Opis tekstowy przedstawiający rośliny będące reakcją krzyżową w postaci pyłków. Pyłki brzozy, buka, dębu, grabu, olchy, leszczyny i wierzby.

picture

string

Link do zdjęcia rośliny.

picture_closeup

string

Link do zdjęcia rośliny w zbliżeniu.

PlantInfo

Ten obiekt zawiera dzienne informacje o określonej roślinie.

Pola
code

Plant

Nazwa kodowa rośliny. Na przykład: „COTTONWOOD”. Tutaj znajdziesz listę wszystkich dostępnych kodów.

display_name

string

Czytelna dla człowieka wersja nazwy rośliny. Przykład: „Cottonwood”.

index_info

IndexInfo

Ten obiekt zawiera dane reprezentujące konkretną wartość indeksu pyłków, kategorię i opis.

plant_description

PlantDescription

Zawiera ogólne informacje o roślinach, m.in. szczegóły dotyczące ich sezonowości, specjalne kształty i kolory, informacje o reakcjach krzyżowych oraz zdjęcia roślin.

in_season

bool

Wskazywanie roślin, które są w sezonie lub nie.

PollenType

Kod typu stężenia pyłków

Wartości w polu enum
POLLEN_TYPE_UNSPECIFIED Nieokreślony typ rośliny.
GRASS Typ pyłków traw.
TREE Typ pyłków drzew.
WEED Rodzaj pyłków chwastów.

PollenTypeInfo

Ten obiekt zawiera informacje o indeksie typu pyłków i zaleceniach dotyczących zdrowia w przypadku konkretnego rodzaju pyłków.

Pola
code

PollenType

Nazwa kodowa rodzaju pyłku. Na przykład: „GRASS”

display_name

string

Zrozumiała dla człowieka nazwa nazwy typu pyłku. Przykład: „trawa”.

index_info

IndexInfo

Zawiera dane uniwersalnego indeksu pyłków (UPI) dla tego rodzaju pyłków.

health_recommendations[]

string

Lista tekstowa wyjaśnień związanych ze statystykami dotyczącymi zdrowia na podstawie bieżących poziomów stężenia pyłków.

in_season

bool

Wskazanie, czy roślina jest w sezonie.