Method: forecast.lookup

Menampilkan informasi serbuk sari harian hingga 5 hari di lebih dari 65 negara, resolusi hingga 1 km.

Permintaan HTTP

GET https://pollen.googleapis.com/v1/forecast:lookup

URL menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
location

object (LatLng)

Wajib diisi. Bujur dan lintang tempat API menelusuri data perkiraan serbuk sari.

days

integer

Wajib diisi. Angka yang menunjukkan jumlah hari perkiraan yang akan diminta (nilai minimum 1, nilai maksimum adalah 5).

pageSize

integer

Opsional. Jumlah maksimum catatan info harian untuk ditampilkan per halaman. Nilai default dan maksimum adalah 5, yang menunjukkan data selama 5 hari.

pageToken

string

Opsional. Token halaman yang diterima dari panggilan harian sebelumnya. Ini digunakan untuk mengambil halaman berikutnya.

Perhatikan bahwa saat memberikan nilai untuk token halaman, semua parameter permintaan lain yang diberikan harus cocok dengan panggilan sebelumnya yang menyediakan token halaman.

languageCode

string

Opsional. Memungkinkan klien memilih bahasa untuk respons. Jika data tidak dapat diberikan untuk bahasa tersebut, API akan menggunakan pencocokan terdekat. Nilai yang diizinkan bergantung pada standar BCP-47 IETF. Nilai defaultnya adalah "en".

plantsDescription

boolean

Opsional. Berisi informasi umum tentang tanaman, termasuk detail tentang tren musiman, bentuk dan warna khusus, informasi tentang reaksi silang alergi, dan foto tanaman. Nilai defaultnya adalah "true".

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "regionCode": string,
  "dailyInfo": [
    {
      object (DayInfo)
    }
  ],
  "nextPageToken": string
}
Kolom
regionCode

string

Kode ISO_3166-1 alpha-2 negara/wilayah yang sesuai dengan lokasi yang diberikan dalam permintaan. Kolom ini mungkin dihilangkan dari respons jika lokasi yang diberikan dalam permintaan berada di wilayah yang disengketakan.

dailyInfo[]

object (DayInfo)

Wajib diisi. Objek ini berisi informasi prakiraan cuaca harian untuk setiap hari yang diminta.

nextPageToken

string

Opsional. Token untuk mengambil halaman berikutnya.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

LatLng

Objek yang merepresentasikan pasangan garis lintang/bujur. Objek ini dinyatakan sebagai pasangan double untuk mewakili derajat lintang dan derajat bujur. Kecuali jika ditentukan lain, objek ini harus sesuai dengan standar WGS84. Nilai harus berada dalam rentang yang dinormalisasi.

Representasi JSON
{
  "latitude": number,
  "longitude": number
}
Kolom
latitude

number

Lintang dalam derajat. Harus dalam rentang [-90.0, +90.0].

longitude

number

Bujur dalam derajat. Harus dalam rentang [-180.0, +180.0].

DayInfo

Objek ini berisi informasi prakiraan cuaca harian untuk setiap hari yang diminta.

Representasi JSON
{
  "date": {
    object (Date)
  },
  "pollenTypeInfo": [
    {
      object (PollenTypeInfo)
    }
  ],
  "plantInfo": [
    {
      object (PlantInfo)
    }
  ]
}
Kolom
date

object (Date)

Tanggal dalam UTC saat data perkiraan serbuk sari ditampilkan.

pollenTypeInfo[]

object (PollenTypeInfo)

Daftar ini akan mencakup hingga tiga jenis serbuk sari (GRASS, WEED, TREE) yang memengaruhi lokasi yang ditentukan dalam permintaan.

plantInfo[]

object (PlantInfo)

Daftar ini akan mencakup hingga 15 spesies serbuk sari yang memengaruhi lokasi yang ditentukan dalam permintaan.

Tanggal

Mewakili seluruh atau sebagian tanggal kalender, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau tidak signifikan. Tanggal ini relatif terhadap Kalender Gregorian. ID ini dapat mewakili salah satu dari hal berikut:

  • Tanggal lengkap, dengan nilai tahun, bulan, dan hari bukan nol.
  • Bulan dan hari, dengan tahun nol (misalnya, hari jadi).
  • Tahun saja, dengan bulan nol dan hari nol.
  • Tahun dan bulan, dengan hari nol (misalnya, tanggal habis masa berlaku kartu kredit).

Jenis terkait:

Representasi JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Kolom
year

integer

Tahun dalam tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun.

month

integer

Bulan dalam setahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari.

day

integer

Hari dalam sebulan. Harus dari 1 hingga 31 dan berlaku untuk tahun dan bulan, atau 0 untuk menentukan tahun saja atau tahun dan bulan jika hari dianggap tidak signifikan.

PollenTypeInfo

Objek ini berisi indeks jenis serbuk sari dan informasi rekomendasi kesehatan tentang jenis serbuk sari tertentu.

Representasi JSON
{
  "code": enum (PollenType),
  "displayName": string,
  "indexInfo": {
    object (IndexInfo)
  },
  "healthRecommendations": [
    string
  ],
  "inSeason": boolean
}
Kolom
code

enum (PollenType)

Nama kode jenis serbuk sari. Misalnya: "GRASS"

displayName

string

Representasi nama jenis serbuk sari yang dapat dibaca manusia. Contoh: "Rumput"

indexInfo

object (IndexInfo)

Berisi data Universal Pollen Index (UPI) untuk jenis serbuk sari.

healthRecommendations[]

string

Daftar penjelasan secara tekstual, terkait dengan insight kesehatan berdasarkan kadar serbuk sari saat ini.

inSeason

boolean

Indikasi apakah tanaman sedang musim atau tidak.

PollenType

Kode Jenis Serbuk sari

Enum
POLLEN_TYPE_UNSPECIFIED Jenis tanaman tidak ditentukan.
GRASS Jenis serbuk sari rumput.
TREE Jenis serbuk sari pohon.
WEED Jenis serbuk sari gulma.

IndexInfo

Objek ini berisi data yang mewakili nilai, kategori, dan deskripsi indeks serbuk sari tertentu.

Representasi JSON
{
  "code": enum (Index),
  "displayName": string,
  "category": string,
  "indexDescription": string,
  "color": {
    object (Color)
  },
  "value": integer
}
Kolom
code

enum (Index)

Kode indeks. Kolom ini mewakili indeks untuk tujuan pemrograman dengan menggunakan kasus snake, bukan spasi. Contoh: "UPI".

displayName

string

Representasi nama indeks yang dapat dibaca manusia. Contoh: "Universal Pollen Index".

category

string

Klasifikasi teks untuk interpretasi skor numerik indeks. Indeks ini terdiri dari enam kategori:

  • 0: "Tidak ada"
  • 1: "Sangat rendah"
  • 2: "Rendah"
  • 3: "Sedang"
  • 4: "Tinggi"
  • 5: "Sangat tinggi
indexDescription

string

Penjelasan tekstual tentang level indeks saat ini.

color

object (Color)

Warna yang digunakan untuk mewakili skor numerik Indeks Serbuk sari.

value

integer

Skor numerik indeks. Rentang numerik adalah antara 0 dan 5.

Indeks

Kode Indeks

Enum
INDEX_UNSPECIFIED Indeks tidak ditentukan.
UPI Indeks Serbuk sari Universal.

Warna

Mewakili warna dalam ruang warna RGBA. Representasi ini dirancang untuk kemudahan konversi ke dan dari representasi warna dalam berbagai bahasa daripada kerapatan. Misalnya, kolom representasi ini dapat dengan mudah diberikan ke konstruktor java.awt.Color di Java; ini juga dapat dengan mudah diberikan ke metode +colorWithRed:green:blue:alpha UIColor di iOS; dan, hanya dengan sedikit upaya, dapat dengan mudah diformat menjadi string rgba() CSS di JavaScript.

Halaman referensi ini tidak memiliki informasi tentang ruang warna absolut yang harus digunakan untuk menafsirkan nilai RGB—misalnya, sRGB, Adobe RGB, DCI-P3, dan BT.2020. Secara default, aplikasi harus menggunakan ruang warna sRGB.

Saat kesetaraan warna perlu ditentukan, implementasi, kecuali jika didokumentasikan sebaliknya, memperlakukan dua warna sama jika semua nilai merah, hijau, biru, dan alfa masing-masing berbeda paling banyak sebesar 1e-5.

Contoh (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();
 }
 // ...

Contoh (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;
}
// ...

Contoh (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('');
};

// ...
Representasi JSON
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
Kolom
red

number

Jumlah merah dalam warna sebagai nilai dalam interval [0, 1].

green

number

Jumlah hijau dalam warna sebagai nilai dalam interval [0, 1].

blue

number

Jumlah biru dalam warna sebagai nilai dalam interval [0, 1].

alpha

number

Fraksi warna ini yang harus diterapkan ke piksel. Yaitu, warna piksel akhir ditentukan oleh persamaan:

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

Ini berarti bahwa nilai 1,0 berarti warna solid, sedangkan nilai 0,0 berarti warna yang sepenuhnya transparan. Kode ini menggunakan pesan wrapper, bukan skalar float sederhana sehingga memungkinkan untuk membedakan antara nilai default dan nilai yang tidak disetel. Jika dihilangkan, objek warna ini dirender sebagai warna solid (seolah-olah nilai alfa secara eksplisit diberi nilai 1,0).

PlantInfo

Objek ini berisi informasi harian tentang tanaman tertentu.

Representasi JSON
{
  "code": enum (Plant),
  "displayName": string,
  "indexInfo": {
    object (IndexInfo)
  },
  "plantDescription": {
    object (PlantDescription)
  },
  "inSeason": boolean
}
Kolom
code

enum (Plant)

Nama kode tanaman. Misalnya: "COTTONWOOD". Daftar semua kode yang tersedia dapat ditemukan di sini.

displayName

string

Representasi nama tanaman yang dapat dibaca manusia. Contoh: "Katun".

indexInfo

object (IndexInfo)

Objek ini berisi data yang mewakili nilai, kategori, dan deskripsi indeks serbuk sari tertentu.

plantDescription

object (PlantDescription)

Berisi informasi umum tentang tanaman, termasuk detail tentang tren musiman, bentuk dan warna khusus, informasi tentang reaksi silang alergi, dan foto tanaman.

inSeason

boolean

Indikasi tanaman sedang musim atau tidak.

Tanaman

Mencantumkan tanaman yang tersedia dengan ketersediaan yang bervariasi di seluruh lokasi.

Enum
PLANT_UNSPECIFIED Kode tanaman tidak ditentukan.
ALDER Alder diklasifikasikan sebagai jenis serbuk sari pohon.
ASH Abu diklasifikasikan sebagai jenis serbuk sari pohon.
BIRCH Birch diklasifikasikan sebagai jenis serbuk sari pohon.
COTTONWOOD Kapas diklasifikasikan sebagai jenis serbuk sari pohon.
ELM Elm diklasifikasikan sebagai jenis serbuk sari pohon.
MAPLE Maple diklasifikasikan sebagai jenis serbuk sari pohon.
OLIVE Zaitun diklasifikasikan sebagai jenis serbuk sari pohon.
JUNIPER Juniper diklasifikasikan sebagai jenis serbuk sari pohon.
OAK Ek diklasifikasikan sebagai jenis serbuk sari pohon.
PINE Pinus diklasifikasikan sebagai jenis serbuk sari pohon.
CYPRESS_PINE Pinus cemara diklasifikasikan sebagai jenis serbuk sari pohon.
HAZEL Hazel diklasifikasikan sebagai jenis serbuk sari pohon.
GRAMINALES Graminale diklasifikasikan sebagai jenis serbuk sari rumput.
RAGWEED Ragweed diklasifikasikan sebagai jenis serbuk sari gulma.
MUGWORT Mugwort diklasifikasikan sebagai jenis serbuk sari gulma.

PlantDescription

Berisi informasi umum tentang tanaman, termasuk detail tentang tren musiman, bentuk dan warna khusus, informasi tentang reaksi silang alergi, dan foto tanaman.

Representasi JSON
{
  "type": enum (PollenType),
  "family": string,
  "season": string,
  "specialColors": string,
  "specialShapes": string,
  "crossReaction": string,
  "picture": string,
  "pictureCloseup": string
}
Kolom
type

enum (PollenType)

Jenis serbuk sari tanaman. Misalnya: "GRASS". Daftar semua kode yang tersedia dapat ditemukan di sini.

family

string

Representasi nama keluarga tanaman yang dapat dibaca manusia. Contoh: "Betulaceae (keluarga Birch)".

season

string

Daftar tekstual penjelasan musim tempat serbuk sari aktif. Contoh: "Akhir musim dingin, musim semi".

specialColors

string

Deskripsi tekstual tanaman warna daun, kulit kayu, bunga, atau biji yang membantu mengidentifikasi tanaman.

specialShapes

string

Deskripsi tekstual tanaman bentuk daun, kulit kayu, bunga, atau biji yang membantu mengidentifikasi tanaman.

crossReaction

string

Deskripsi tekstual tentang tumbuhan reaksi silang serbuk sari. Contoh: Serbuk sari Alder, Hazel, Hornbeam, Beech, Willow, dan Ek.

picture

string

Link ke gambar tanaman.

pictureCloseup

string

Link ke gambar close-up tanaman.