Package google.maps.pollen.v1

Indice

Polline

Definizione del servizio per l'API Pollen.

LookupForecast

rpc LookupForecast(LookupForecastRequest) returns (LookupForecastResponse)

Restituisce fino a 5 giorni di informazioni giornaliere sul polline in più di 65 paesi, con una risoluzione fino a 1 km.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

LookupHeatmapTile

rpc LookupHeatmapTile(LookupHeatmapTileRequest) returns (HttpBody)

Restituisce un array di byte contenente i dati dell'immagine PNG del riquadro.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

Indice

Codice indice

Enum
INDEX_UNSPECIFIED Indice non specificato.
UPI Indice di polline universale.

IndexInfo

Questo oggetto contiene dati che rappresentano una categoria, una descrizione e un valore specifico dell'indice di polline.

Campi
code

Index

Il codice dell'indice. Questo campo rappresenta l'indice a fini di programmazione utilizzando custodie snake anziché spazi. Esempio: "UPI".

display_name

string

Una rappresentazione leggibile del nome dell'indice. Esempio: "Indice di polline universale".

category

string

Classificazione testuale dell'interpretazione del punteggio numerico dell'indice. L'indice è costituito da sei categorie:

  • 0: "Nessuno"
  • 1: "Molto basso"
  • 2: "Bassa"
  • 3: "Moderato"
  • 4: "Alta"
  • 5: "Molto alto
index_description

string

Spiegazione testuale del livello di indice corrente.

color

Color

Il colore utilizzato per rappresentare il punteggio numerico dell'indice di polline.

value

int32

Il punteggio numerico dell'indice. L'intervallo numerico è compreso tra 0 e 5.

LookupForecastRequest

Campi
location

LatLng

Obbligatorio. La longitudine e la latitudine da cui l'API cerca i dati di previsione relativi al polline.

days

int32

Obbligatorio. Un numero che indica il numero di giorni di previsione da richiedere (valore minimo 1, valore massimo 5).

page_size

int32

Campo facoltativo. Il numero massimo di record di informazioni giornalieri da restituire per pagina. Il valore predefinito e massimo è 5 (5 giorni di dati).

page_token

string

Campo facoltativo. Un token di pagina ricevuto da una precedente chiamata giornaliera. Viene utilizzato per recuperare la pagina successiva.

Tieni presente che, quando fornisci un valore per il token di pagina, tutti gli altri parametri di richiesta forniti devono corrispondere alla chiamata precedente che ha fornito il token di pagina.

language_code

string

Campo facoltativo. Consente al client di scegliere la lingua per la risposta. Se non è possibile fornire dati per quella lingua, l'API utilizza la corrispondenza più vicina. I valori consentiti si basano sullo standard IETF BCP-47. Il valore predefinito è "en".

plants_description

bool

Campo facoltativo. Contiene informazioni generali sulle piante, tra cui dettagli sulla loro stagionalità, forme e colori speciali, informazioni sulle reazioni crociate allergiche e foto delle piante.

LookupForecastResponse

Campi
region_code

string

Il codice ISO_3166-1 alpha-2 del paese o della regione corrispondente alla località fornita nella richiesta. Questo campo potrebbe essere omesso dalla risposta se la località fornita nella richiesta si trova in un territorio conteso.

daily_info[]

DayInfo

Obbligatorio. Questo oggetto contiene le informazioni di previsione giornaliere per ogni giorno richiesto.

next_page_token

string

Campo facoltativo. Il token per recuperare la pagina successiva.

DayInfo

Questo oggetto contiene le informazioni di previsione giornaliere per ogni giorno richiesto.

Campi
date

Date

La data in UTC in cui sono rappresentati i dati di previsione del polline.

pollen_type_info[]

PollenTypeInfo

Questo elenco includerà (fino a) tre tipi di polline (erba, erbe infestanti, alberi) che interessano la località specificata nella richiesta.

plant_info[]

PlantInfo

Questo elenco includerà (fino a) 15 specie di polline che interessano la località specificata nella richiesta.

LookupHeatmapTileRequest

Richiesta di riquadro della mappa termica. La struttura è conforme alla chiamata GET standard del server riquadri, ad esempio https://pollen.googleapis.com/v1/mapTypes/{map_type}/heatmapTiles/{zoom}/{x}/{y}

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

Campi
map_type

MapType

Obbligatorio. Il tipo di mappa termica del polline. Definisce la combinazione di tipo di polline e indice che la mappa rappresenterà graficamente.

zoom

int32

Obbligatorio. Il livello di zoom della mappa. Definisce quanto grande o piccolo i contenuti di una mappa vengono visualizzati in una visualizzazione mappa.

  • Il livello di zoom 0 mostra il mondo intero in un unico riquadro.
  • Il livello di zoom 1 mostra il mondo intero in 4 riquadri.
  • Il livello di zoom 2 mostra il mondo intero in 16 riquadri.
  • Il livello di zoom 16 è il mondo intero in 65.536 riquadri.

Valori consentiti: 0-16

x

int32

Obbligatorio. Definisce il punto est-ovest nel riquadro richiesto.

y

int32

Obbligatorio. Definisce il punto nord-sud nel riquadro richiesto.

MapType

Il tipo di mappa termica del polline. Definisce la combinazione di tipo di polline e indice che la mappa rappresenterà graficamente.

Enum
MAP_TYPE_UNSPECIFIED Tipo di mappa non specificato.
TREE_UPI Il tipo di mappa termica rappresenta una mappa grafica dell'indice degli alberi.
GRASS_UPI Il tipo di mappa termica rappresenterà una mappa grafica con indice erboso.
WEED_UPI Il tipo di mappa termica rappresenterà una mappa grafica dell'indice delle erbe infestanti.

Pianta

Elenca le piante disponibili con disponibilità variabile in base alle località.

Enum
PLANT_UNSPECIFIED Codice dell'impianto non specificato.
ALDER L'ontano è classificato come tipo di polline degli alberi.
ASH La cenere è classificata come tipo di polline degli alberi.
BIRCH La betulla è classificata come tipo di polline degli alberi.
COTTONWOOD Il pioppo è classificato come tipo di polline degli alberi.
ELM L'olmo è classificato come tipo di polline degli alberi.
MAPLE L'acero è classificato come tipo di polline degli alberi.
OLIVE L'ulivo è classificato come tipo di polline degli alberi.
JUNIPER Il ginepro è classificato come tipo di polline degli alberi.
OAK La quercia è classificata come tipo di polline degli alberi.
PINE Il pino è classificato come tipo di polline degli alberi.
CYPRESS_PINE Il cipresso è classificato come tipo di polline degli alberi.
HAZEL L'amamelide è classificato come tipo di polline degli alberi.
GRAMINALES Le graminacee sono classificate come tipo di polline di erba.
RAGWEED L'ambrosia è classificata come tipo di polline di erbe infestanti.
MUGWORT L'artemisia comune è classificata come tipo di polline di erbe infestanti.

PlantDescription

Contiene informazioni generali sulle piante, tra cui dettagli sulla loro stagionalità, forme e colori speciali, informazioni sulle reazioni crociate allergiche e foto delle piante.

Campi
type

PollenType

Il tipo di polline della pianta. Ad esempio: "GRASS". Qui è disponibile un elenco di tutti i codici disponibili.

family

string

Una rappresentazione leggibile del nome della famiglia della pianta. Esempio: "Betulacee (famiglia della betulla)".

season

string

Elenco testuale di spiegazioni delle stagioni in cui è attivo il polline. Esempio: "Tardo inverno, primavera".

special_colors

string

Descrizione testuale dei colori delle piante, come foglie, corteccia, fiori o semi, per identificare la pianta.

special_shapes

string

Descrizione testuale delle forme di foglie, corteccia, fiori o semi delle piante per aiutarti a identificare la pianta.

cross_reaction

string

Descrizione testuale di piante con reazione crociata al polline. Esempio: Polline di ontano, nocciolo, carpino, faggio, salice e quercia.

picture

string

Link all'immagine della pianta.

picture_closeup

string

Link a un'immagine in primo piano della pianta.

PlantInfo

Questo oggetto contiene le informazioni giornaliere su una pianta specifica.

Campi
code

Plant

Il nome in codice dell'impianto. Ad esempio: "COTTONWOOD". Qui è disponibile un elenco di tutti i codici disponibili.

display_name

string

Una rappresentazione leggibile del nome della pianta. Esempio: "Cottonwood".

index_info

IndexInfo

Questo oggetto contiene dati che rappresentano una categoria, una descrizione e un valore specifico dell'indice di polline.

plant_description

PlantDescription

Contiene informazioni generali sulle piante, tra cui dettagli sulla loro stagionalità, forme e colori speciali, informazioni sulle reazioni crociate allergiche e foto delle piante.

in_season

bool

Indica se la pianta è in stagione o meno.

PollenType

Codice tipo di polline

Enum
POLLEN_TYPE_UNSPECIFIED Tipo di pianta non specificato.
GRASS Tipo di polline di erba.
TREE Tipo di polline degli alberi.
WEED Tipo di polline di erbe infestanti.

PollenTypeInfo

Questo oggetto contiene l'indice del tipo di polline e le informazioni sui consigli per la salute relativi a un tipo specifico di polline.

Campi
code

PollenType

Il nome in codice del tipo di polline. Ad esempio: "GRASS"

display_name

string

Una rappresentazione leggibile del nome del tipo di polline. Esempio: "Erba"

index_info

IndexInfo

Contiene i dati dell'indice universale di polline (UPI) per il tipo di polline.

health_recommendations[]

string

Elenco testuale di spiegazioni, correlate alle informazioni sullo stato di salute in base agli attuali livelli di polline.

in_season

bool

Indica se la pianta è in stagione o meno.