Method: forecast.lookup

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

查詢參數

要求主體

要求主體必須為空白。

回應主體

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

代表經緯度組合的物件。以一對雙精準數表示經度度數和緯度度數。除非另有指定，否則這個物件必須符合 WGS84 標準。此外，值必須在正規化範圍內。

這個物件包含每日要求每日的天氣預報資訊。

代表完整或部分的日曆日期，例如生日。您可以指明時段和時區，或者在其他地方指定時間或時區。日期以公曆為基準。可能代表下列其中一項：

• 完整日期，具有非零的年、月和日值。
• 日期為 0 的月份和日期，例如週年紀念日。
• 有 1 年，第 0 個月卻為 0 天。
• 年和月，但數字為零 (例如信用卡到期日)。

相關類型：

• google.type.TimeOfDay
• google.type.DateTime
• google.protobuf.Timestamp

這個物件包含花粉類型索引和特定花粉類型健康建議資訊。

花粉類型代碼

這個物件包含代表特定花粉指數值、類別和說明的資料。

索引代碼

此屬性代表 RGBA 色域中的顏色。這種呈現方式是為了簡化與不同語言的色彩表示法之間相互轉換的設計。例如，您可以透過 Java 將這個表示法的欄位輕鬆提供給 java.awt.Color 的建構函式；此方法也能一併提供給 iOS 中 UIColor 的 +colorWithRed:green:blue:alpha 方法；而且只要稍加練習，就可以輕鬆使用 JavaScript 將 CSS rgba() 字串格式化。

本參考頁面沒有關於解讀 RGB 值的絕對色彩空間資訊，例如 sRGB、Adobe RGB、DCI-P3 和 BT.2020。根據預設，應用程式應採用 sRGB 色域。

除非另有說明，否則需要決定顏色相等、實作時，如果所有顏色的紅色、綠色、藍色和 Alpha 值各有落差，兩者最多可以有 1e-5。

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

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

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

// ...

這個物件包含特定植物的每日資訊。

列出不同地點供應情況的可用植物。

包含植物的一般資訊，包括植物的一般資訊、特殊形狀和顏色、過敏的交叉反應資訊和植物相片。