- Richiesta HTTP
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- LatLng
- DayInfo
- Data
- PollenTypeInfo
- PollenType
- IndexInfo
- Indice
- Colore
- PlantInfo
- Pianta
- PlantDescription
Restituisce fino a 5 giorni di informazioni giornaliere sul polline in più di 65 paesi, con una risoluzione fino a 1 km.
Richiesta HTTP
GET https://pollen.googleapis.com/v1/forecast:lookup
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri di ricerca
Parametri | |
---|---|
location |
Obbligatorio. La longitudine e la latitudine da cui l'API cerca i dati di previsione relativi al polline. |
days |
Obbligatorio. Un numero che indica il numero di giorni di previsione da richiedere (valore minimo 1, valore massimo 5). |
pageSize |
Campo facoltativo. Il numero massimo di record di informazioni giornalieri da restituire per pagina. Il valore predefinito e massimo è 5 (5 giorni di dati). |
pageToken |
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. |
languageCode |
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". |
plantsDescription |
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. |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"regionCode": string,
"dailyInfo": [
{
object ( |
Campi | |
---|---|
regionCode |
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. |
dailyInfo[] |
Obbligatorio. Questo oggetto contiene le informazioni di previsione giornaliere per ogni giorno richiesto. |
nextPageToken |
Campo facoltativo. Il token per recuperare la pagina successiva. |
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.
LatLng
Un oggetto che rappresenta una coppia di latitudine/longitudine. Questo valore viene espresso come una coppia di doppi per rappresentare i gradi di latitudine e i gradi di longitudine. Se non diversamente specificato, questo oggetto deve essere conforme allo standard WGS84. I valori devono essere compresi in intervalli normalizzati.
Rappresentazione JSON |
---|
{ "latitude": number, "longitude": number } |
Campi | |
---|---|
latitude |
Latitudine in gradi. Deve essere compreso nell'intervallo [-90,0, +90,0]. |
longitude |
Longitudine in gradi. Deve essere compreso nell'intervallo [-180,0, +180,0]. |
DayInfo
Questo oggetto contiene le informazioni di previsione giornaliere per ogni giorno richiesto.
Rappresentazione JSON |
---|
{ "date": { object ( |
Campi | |
---|---|
date |
La data in UTC in cui sono rappresentati i dati di previsione del polline. |
pollenTypeInfo[] |
Questo elenco includerà (fino a) tre tipi di polline (erba, erbe infestanti, alberi) che interessano la località specificata nella richiesta. |
plantInfo[] |
Questo elenco includerà (fino a) 15 specie di polline che interessano la località specificata nella richiesta. |
Data
Rappresenta una data di calendario intera o parziale, ad esempio un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Può rappresentare uno dei seguenti valori:
- Una data completa, con valori di anno, mese e giorno diversi da zero.
- Un mese e un giorno, con un anno zero (ad esempio, un anniversario).
- Un anno per sé, con un mese e un giorno zero.
- Un anno e un mese, con un giorno zero (ad esempio, la data di scadenza di una carta di credito).
Tipi correlati:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Rappresentazione JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Campi | |
---|---|
year |
Anno della data. Il valore deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno. |
month |
Mese dell'anno. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza giorno e mese. |
day |
Giorno del mese. Deve essere compreso tra 1 e 31 ed essere valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e un mese in cui il giorno non è significativo. |
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.
Rappresentazione JSON |
---|
{ "code": enum ( |
Campi | |
---|---|
code |
Il nome in codice del tipo di polline. Ad esempio: "GRASS" |
displayName |
Una rappresentazione leggibile del nome del tipo di polline. Esempio: "Erba" |
indexInfo |
Contiene i dati dell'indice universale di polline (UPI) per il tipo di polline. |
healthRecommendations[] |
Elenco testuale di spiegazioni, correlate alle informazioni sullo stato di salute in base agli attuali livelli di polline. |
inSeason |
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. |
IndexInfo
Questo oggetto contiene dati che rappresentano una categoria, una descrizione e un valore specifico dell'indice di polline.
Rappresentazione JSON |
---|
{ "code": enum ( |
Campi | |
---|---|
code |
Il codice dell'indice. Questo campo rappresenta l'indice a fini di programmazione utilizzando custodie snake anziché spazi. Esempio: "UPI". |
displayName |
Una rappresentazione leggibile del nome dell'indice. Esempio: "Indice di polline universale". |
category |
Classificazione testuale dell'interpretazione del punteggio numerico dell'indice. L'indice è costituito da sei categorie:
|
indexDescription |
Spiegazione testuale del livello di indice corrente. |
color |
Il colore utilizzato per rappresentare il punteggio numerico dell'indice di polline. |
value |
Il punteggio numerico dell'indice. L'intervallo numerico è compreso tra 0 e 5. |
Indice
Codice indice
Enum | |
---|---|
INDEX_UNSPECIFIED |
Indice non specificato. |
UPI |
Indice di polline universale. |
Colore
Rappresenta un colore nello spazio colore RGBA. Questa rappresentazione è stata concepita per semplificare la conversione da e verso rappresentazioni cromatiche in vari linguaggi rispetto alla compattezza. Ad esempio, i campi di questa rappresentazione possono essere banalimente forniti al costruttore di java.awt.Color
in Java; possono anche essere forniti in modo banale al metodo +colorWithRed:green:blue:alpha
di UIColor in iOS e, con un piccolo lavoro, può essere facilmente formattato in una stringa CSS rgba()
in JavaScript.
Questa pagina di riferimento non contiene informazioni sullo spazio colore assoluto che dovrebbe essere utilizzato per interpretare il valore RGB, ad esempio sRGB, Adobe RGB, DCI-P3 e BT.2020. Per impostazione predefinita, le applicazioni devono utilizzare lo spazio colore sRGB.
Quando è necessario determinare l'uguaglianza dei colori, le implementazioni, a meno che non sia documentato diversamente, considerano uguali due colori se tutti i valori di rosso, verde, blu e alfa differiscono al massimo 1e-5
.
Esempio (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();
}
// ...
Esempio (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;
}
// ...
Esempio (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('');
};
// ...
Rappresentazione JSON |
---|
{ "red": number, "green": number, "blue": number, "alpha": number } |
Campi | |
---|---|
red |
La quantità di rosso nel colore come valore nell'intervallo [0, 1]. |
green |
La quantità di verde nel colore come valore nell'intervallo [0, 1]. |
blue |
La quantità di blu nel colore come valore nell'intervallo [0, 1]. |
alpha |
La frazione di questo colore da applicare al pixel. In altre parole, il colore dei pixel finale viene definito dall'equazione:
Ciò significa che un valore pari a 1,0 corrisponde a un colore a tinta unita, mentre un valore pari a 0,0 corrisponde a un colore completamente trasparente. Questo utilizza un messaggio wrapper anziché un semplice valore scalare in virgola mobile, in modo che sia possibile distinguere tra un valore predefinito e il valore che viene annullato. Se omesso, questo oggetto colore viene visualizzato in un colore a tinta unita (come se al valore alfa fosse stato assegnato esplicitamente il valore 1,0). |
PlantInfo
Questo oggetto contiene le informazioni giornaliere su una pianta specifica.
Rappresentazione JSON |
---|
{ "code": enum ( |
Campi | |
---|---|
code |
Il nome in codice dell'impianto. Ad esempio: "COTTONWOOD". Qui è disponibile un elenco di tutti i codici disponibili. |
displayName |
Una rappresentazione leggibile del nome della pianta. Esempio: "Cottonwood". |
indexInfo |
Questo oggetto contiene dati che rappresentano una categoria, una descrizione e un valore specifico dell'indice di polline. |
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. |
inSeason |
Indica se la pianta è in stagione o meno. |
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.
Rappresentazione JSON |
---|
{
"type": enum ( |
Campi | |
---|---|
type |
Il tipo di polline della pianta. Ad esempio: "GRASS". Qui è disponibile un elenco di tutti i codici disponibili. |
family |
Una rappresentazione leggibile del nome della famiglia della pianta. Esempio: "Betulacee (famiglia della betulla)". |
season |
Elenco testuale di spiegazioni delle stagioni in cui è attivo il polline. Esempio: "Tardo inverno, primavera". |
specialColors |
Descrizione testuale dei colori delle piante, come foglie, corteccia, fiori o semi, per identificare la pianta. |
specialShapes |
Descrizione testuale delle forme di foglie, corteccia, fiori o semi delle piante per aiutarti a identificare la pianta. |
crossReaction |
Descrizione testuale di piante con reazione crociata al polline. Esempio: Polline di ontano, nocciolo, carpino, faggio, salice e quercia. |
picture |
Link all'immagine della pianta. |
pictureCloseup |
Link a un'immagine in primo piano della pianta. |