Method: forecast.lookup

65 से ज़्यादा देशों में हर दिन के पराग कणों की जानकारी के साथ, 5 दिनों तक दिखाई जाती है. इस जानकारी का रिज़ॉल्यूशन 1 कि॰मी॰ तक हो सकता है.

एचटीटीपी अनुरोध

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

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

क्वेरी पैरामीटर

पैरामीटर
location

object (LatLng)

ज़रूरी है. वह देशांतर और अक्षांश जिससे एपीआई, पराग कणों के अनुमान का डेटा खोजता है.

days

integer

ज़रूरी है. वह संख्या जो बताती है कि पूर्वानुमान के लिए कितने दिनों का अनुरोध करना है (कम से कम वैल्यू 1 और ज़्यादा से ज़्यादा वैल्यू 5 है).

pageSize

integer

ज़रूरी नहीं. हर पेज पर रोज़ाना मिलने वाली जानकारी के रिकॉर्ड की ज़्यादा से ज़्यादा संख्या. डिफ़ॉल्ट और ज़्यादा से ज़्यादा पांच वैल्यू है, जो पांच दिनों का डेटा है.

pageToken

string

ज़रूरी नहीं. रोज़ के पिछले कॉल से मिला पेज टोकन. इसका इस्तेमाल, अगले पेज को वापस पाने के लिए किया जाता है.

ध्यान दें कि पेज टोकन के लिए वैल्यू देते समय, दिए गए अन्य सभी अनुरोध पैरामीटर, पेज टोकन देने वाले पिछले कॉल से मैच होने चाहिए.

languageCode

string

ज़रूरी नहीं. इससे क्लाइंट को जवाब के लिए भाषा चुनने की अनुमति मिलती है. अगर उस भाषा के लिए डेटा नहीं दिया जा सकता, तो एपीआई सबसे नज़दीकी मिलान का इस्तेमाल करता है. अनुमति वाली वैल्यू, IETF BCP-47 स्टैंडर्ड पर आधारित होती हैं. इसकी डिफ़ॉल्ट वैल्यू "en" है.

plantsDescription

boolean

ज़रूरी नहीं. इसमें पौधों के बारे में सामान्य जानकारी होती है. जैसे, मौसम के बारे में जानकारी, खास आकार और रंग, एलर्जी के संपर्क में आए लोगों की जानकारी, और पौधों की फ़ोटो. डिफ़ॉल्ट वैल्यू "सही" है.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना
{
  "regionCode": string,
  "dailyInfo": [
    {
      object (DayInfo)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
regionCode

string

अनुरोध में दी गई जगह से जुड़े देश/इलाके का ISO_3166-1 alpha-2 कोड. अगर अनुरोध में दी गई जगह किसी विवादित देश/इलाके में है, तो इस फ़ील्ड को जवाब में शामिल नहीं किया जा सकता.

dailyInfo[]

object (DayInfo)

ज़रूरी है. इस ऑब्जेक्ट में, अनुरोध किए गए हर दिन के मौसम के पूर्वानुमान की जानकारी होती है.

nextPageToken

string

ज़रूरी नहीं. अगला पेज वापस पाने के लिए टोकन.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

LatLng

ऐसा ऑब्जेक्ट जो अक्षांश/देशांतर की जोड़ी को दिखाता है. डिग्री अक्षांश और डिग्री देशांतर को दिखाने के लिए, इसे डबल के जोड़े के तौर पर दिखाया जाता है. जब तक अलग से न बताया गया हो, यह ऑब्जेक्ट WGS84 मानक के मुताबिक होना चाहिए. वैल्यू, नॉर्मलाइज़ की जा सकने वाली रेंज के अंदर होनी चाहिए.

JSON के काेड में दिखाना
{
  "latitude": number,
  "longitude": number
}
फ़ील्ड
latitude

number

डिग्री में अक्षांश. यह [-90.0, +90.0] की रेंज में होना चाहिए.

longitude

number

डिग्री में देशांतर. यह [-180.0, +180.0] की रेंज में होना चाहिए.

DayInfo

इस ऑब्जेक्ट में, अनुरोध किए गए हर दिन के मौसम के पूर्वानुमान की जानकारी होती है.

JSON के काेड में दिखाना
{
  "date": {
    object (Date)
  },
  "pollenTypeInfo": [
    {
      object (PollenTypeInfo)
    }
  ],
  "plantInfo": [
    {
      object (PlantInfo)
    }
  ]
}
फ़ील्ड
date

object (Date)

यूटीसी फ़ॉर्मैट में वह तारीख जब पराग कणों के अनुमान का डेटा दिखाया जाता है.

pollenTypeInfo[]

object (PollenTypeInfo)

इस सूची में, अनुरोध में बताई गई जगह पर असर डालने वाले ज़्यादा से ज़्यादा तीन तरह के पराग कणों (जीआरएसएस, डब्ल्यूईईडी, टीआरईई) शामिल होंगे.

plantInfo[]

object (PlantInfo)

इस सूची में, पराग कणों की ज़्यादा से ज़्यादा 15 प्रजातियों को शामिल किया जाएगा. ये प्रजातियों के पराग कण, अनुरोध में बताई गई जगह पर असर डालते हैं.

तारीख

पूरी या आंशिक तारीख को दिखाता है, जैसे कि जन्मदिन. दिन का समय और टाइम ज़ोन की जानकारी कहीं और दी गई है या ज़्यादा अहम नहीं हैं. यह तारीख, ग्रेगोरियन कैलेंडर के हिसाब से है. यह इनमें से कोई एक चीज़ हो सकती है:

  • पूरी तारीख, जिसमें साल, महीने, और दिन की वैल्यू शून्य के अलावा किसी अन्य वैल्यू के तौर पर शामिल हों.
  • कोई महीना और दिन, जिसमें शून्य साल लिखा हो. जैसे, सालगिरह.
  • अपने आप में एक वर्ष, एक शून्य महीना और एक शून्य दिन.
  • साल और महीने, जिनमें दिन और समय शून्य हो. उदाहरण के लिए, क्रेडिट कार्ड की समयसीमा खत्म होने की तारीख.

मिलते-जुलते टाइप:

JSON के काेड में दिखाना
{
  "year": integer,
  "month": integer,
  "day": integer
}
फ़ील्ड
year

integer

तारीख का साल. 1 से 9999 के बीच की संख्या होनी चाहिए, या बिना साल वाली तारीख को बताने के लिए 0 होना चाहिए.

month

integer

साल का महीना. यह वैल्यू 1 से 12 के बीच होनी चाहिए. अगर किसी साल में महीना और दिन नहीं है, तो उस साल की जानकारी देने के लिए यह संख्या 0 होनी चाहिए.

day

integer

महीने का दिन. इसमें 1 से 31 तक का अंतर हो सकता है. साथ ही, यह साल और महीने के लिए मान्य होना चाहिए. इसके अलावा, किसी साल के बारे में बताने के लिए, वैल्यू 0 होनी चाहिए या साल और महीने के बीच की कोई खास जानकारी नहीं होनी चाहिए.

PollenTypeInfo

इस ऑब्जेक्ट में, पराग के टाइप इंडेक्स और किसी खास तरह के पराग कणों के बारे में स्वास्थ्य से जुड़े सुझाव की जानकारी शामिल है.

JSON के काेड में दिखाना
{
  "code": enum (PollenType),
  "displayName": string,
  "indexInfo": {
    object (IndexInfo)
  },
  "healthRecommendations": [
    string
  ],
  "inSeason": boolean
}
फ़ील्ड
code

enum (PollenType)

पराग के प्रकार का कोड नाम. उदाहरण के लिए: "GRASS"

displayName

string

पराग के टाइप के नाम को इंसान आसानी से पढ़ सकते हैं. उदाहरण: "घास"

indexInfo

object (IndexInfo)

इसमें पराग के प्रकार के लिए यूनिवर्सल पॉलेन इंडेक्स (UPI) डेटा शामिल होता है.

healthRecommendations[]

string

पराग के मौजूदा लेवल के आधार पर स्वास्थ्य की अहम जानकारी से जुड़ी जानकारी की टेक्स्ट के रूप में सूची.

inSeason

boolean

इस बात की जानकारी देना कि पौधा किसी मौसम में है या नहीं.

PollenType

पराग प्रकार कोड

Enums
POLLEN_TYPE_UNSPECIFIED यह जानकारी नहीं है कि पौधे किस तरह का है.
GRASS घास के पराग कणों का प्रकार.
TREE पेड़ के पराग कणों का टाइप.
WEED खरपतवार के पराग कणों का प्रकार.

IndexInfo

इस ऑब्जेक्ट में खास पॉलेन इंडेक्स वैल्यू, कैटगरी, और जानकारी दिखाने वाला डेटा है.

JSON के काेड में दिखाना
{
  "code": enum (Index),
  "displayName": string,
  "category": string,
  "indexDescription": string,
  "color": {
    object (Color)
  },
  "value": integer
}
फ़ील्ड
code

enum (Index)

इंडेक्स का कोड. यह फ़ील्ड प्रोग्रामिंग के लिए इंडेक्स दिखाता है. इसके लिए, स्पेस के बजाय सांप के केस का इस्तेमाल किया जाता है. उदाहरण के लिए: "UPI".

displayName

string

इंडेक्स के नाम की ऐसी जानकारी जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. उदाहरण: "यूनिवर्सल पॉलेन इंडेक्स".

category

string

इंडेक्स न्यूमेरिक स्कोर की परिभाषा का टेक्स्ट क्लासिफ़िकेशन. इंडेक्स में छह कैटगरी होती हैं:

  • 0: "कोई नहीं"
  • 1: "बहुत कम"
  • 2: "कम"
  • 3: "सामान्य"
  • 4: "ज़्यादा"
  • 5: "बहुत ज़्यादा
indexDescription

string

मौजूदा इंडेक्स लेवल की टेक्स्ट के तौर पर जानकारी.

color

object (Color)

पराग इंडेक्स संख्या वाले स्कोर को दिखाने के लिए इस्तेमाल किया गया रंग.

value

integer

इंडेक्स का अंकों में स्कोर. अंकों वाली रेंज 0 और 5 के बीच है.

इंडेक्स

इंडेक्स कोड

Enums
INDEX_UNSPECIFIED इंडेक्स की जानकारी नहीं है.
UPI यूनिवर्सल पॉलेन इंडेक्स.

रंग

RGBA कलर स्पेस में कोई रंग दिखाता है. यह प्रज़ेंटेशन इस तरह से डिज़ाइन किया गया है कि कॉम्पैक्टनेस के बजाय, अलग-अलग भाषाओं में रंग को आसानी से समझा जा सके और उन्हें अलग-अलग भाषाओं में कैसे दिखाया जा सके. उदाहरण के लिए, इस प्रतिनिधित्व के फ़ील्ड को Java में java.awt.Color के कंस्ट्रक्टर को आसानी से दिया जा सकता है; इसे iOS में, UIColor के +colorWithRed:green:blue:alpha तरीके में भी आसानी से उपलब्ध कराया जा सकता है; और बस थोड़ी सी मेहनत करके, इसे JavaScript में सीएसएस rgba() स्ट्रिंग में आसानी से फ़ॉर्मैट किया जा सकता है.

इस रेफ़रंस पेज में उस ऐब्सलूट कलर स्पेस से जुड़ी जानकारी नहीं है जिसका इस्तेमाल आरजीबी वैल्यू को समझने के लिए किया जाना चाहिए. उदाहरण के लिए, sRGB, Adobe RGB, DCI-P3, और BT.2020. डिफ़ॉल्ट रूप से, ऐप्लिकेशन को sRGB में कलर स्पेस के तौर पर माना जाना चाहिए.

जब रंग की समानता तय करने की ज़रूरत हो, तो लागू करने पर, जब तक कि कोई और दस्तावेज़ न हो, दो रंगों को बराबर मानें. अगर सभी लाल, हरे, नीले और ऐल्फ़ा वैल्यू में से हर एक की वैल्यू में ज़्यादा से ज़्यादा 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('');
};

// ...
JSON के काेड में दिखाना
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
फ़ील्ड
red

number

इंटरवल [0, 1] में वैल्यू के तौर पर रंग में लाल रंग.

green

number

इंटरवल [0, 1] में वैल्यू के तौर पर रंग में हरे रंग की मात्रा.

blue

number

इंटरवल [0, 1] में वैल्यू के तौर पर रंग में नीले रंग की मात्रा.

alpha

number

इस रंग का वह हिस्सा, जिसे पिक्सल पर लागू किया जाना चाहिए. इसका मतलब है कि आखिरी पिक्सल का रंग समीकरण से तय होता है:

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

इसका मतलब है कि 1.0 वैल्यू किसी ठोस रंग से मेल खाती है, जबकि 0.0 वैल्यू पूरी तरह से पारदर्शी रंग से मेल खाती है. यह किसी सामान्य फ़्लोट स्केलर के बजाय रैपर मैसेज का इस्तेमाल करता है, ताकि डिफ़ॉल्ट वैल्यू और सेट न की जा रही वैल्यू के बीच अंतर किया जा सके. अगर छोड़ दिया जाता है, तो इस रंग ऑब्जेक्ट को एक ठोस रंग के रूप में रेंडर किया जाता है (जैसे कि ऐल्फ़ा वैल्यू को साफ़ तौर पर 1.0 का मान दिया गया था).

PlantInfo

इस ऑब्जेक्ट में किसी खास पौधे के बारे में हर दिन की जानकारी होती है.

JSON के काेड में दिखाना
{
  "code": enum (Plant),
  "displayName": string,
  "indexInfo": {
    object (IndexInfo)
  },
  "plantDescription": {
    object (PlantDescription)
  },
  "inSeason": boolean
}
फ़ील्ड
code

enum (Plant)

प्लांट कोड नाम. उदाहरण के लिए: "COTTONWOOD". सभी उपलब्ध कोड की सूची यहां मिल सकती है.

displayName

string

इस इमेज में पौधे के नाम को ऐसे फ़ॉर्मैट में लिखा गया है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. उदाहरण: “कॉटनवुड".

indexInfo

object (IndexInfo)

इस ऑब्जेक्ट में खास पॉलेन इंडेक्स वैल्यू, कैटगरी, और जानकारी दिखाने वाला डेटा है.

plantDescription

object (PlantDescription)

इसमें पौधों के बारे में सामान्य जानकारी होती है. जैसे, मौसम के बारे में जानकारी, खास आकार और रंग, एलर्जी के संपर्क में आए लोगों की जानकारी, और पौधों की फ़ोटो.

inSeason

boolean

इससे यह पता चलता है कि पौधा इस समय चल रहा है या नहीं.

पौधा

सभी जगहों पर अलग-अलग पौधों की उपलब्धता की सूची दी गई है.

Enums
PLANT_UNSPECIFIED प्लांट कोड की जानकारी नहीं है.
ALDER ऑल्डर को पेड़ के पराग कणों की कैटगरी में रखा जाता है.
ASH राख को पेड़ के पराग कणों की कैटगरी में रखा जाता है.
BIRCH बर्च को पेड़ के पराग कणों की कैटगरी में रखा जाता है.
COTTONWOOD कॉटनवुड को पेड़ के पराग कणों की कैटगरी में रखा जाता है.
ELM एल्म को पेड़ के पराग कणों की कैटगरी में रखा जाता है.
MAPLE मेपल को पेड़ के पराग कणों की कैटगरी में रखा जाता है.
OLIVE ज़ैतून को पेड़ के पराग कणों की कैटगरी में रखा जाता है.
JUNIPER ज्यूनिपर को पेड़ के पराग कणों की कैटगरी में रखा जाता है.
OAK ओक को पेड़ के पराग कणों की कैटगरी में रखा जाता है.
PINE देवदार को पेड़ के पराग कणों की कैटगरी में रखा जाता है.
CYPRESS_PINE साइप्रस पाइन को पेड़ के पराग कणों की कैटगरी में रखा जाता है.
HAZEL हेज़ल को पेड़ के पराग कणों की कैटगरी में रखा जाता है.
GRAMINALES ग्रेमेनेलीज़ को घास के पराग कणों की कैटगरी में रखा जाता है.
RAGWEED रैगवीड को खरपतवार के पराग कण की कैटगरी में रखा जाता है.
MUGWORT मगवर्ट को खरपतवार के पराग कणों की कैटगरी में रखा जाता है.

PlantDescription

इसमें पौधों के बारे में सामान्य जानकारी होती है. जैसे, मौसम के बारे में जानकारी, खास आकार और रंग, एलर्जी के संपर्क में आए लोगों की जानकारी, और पौधों की फ़ोटो.

JSON के काेड में दिखाना
{
  "type": enum (PollenType),
  "family": string,
  "season": string,
  "specialColors": string,
  "specialShapes": string,
  "crossReaction": string,
  "picture": string,
  "pictureCloseup": string
}
फ़ील्ड
type

enum (PollenType)

पौधे का पराग कण. उदाहरण के लिए: "GRASS". सभी उपलब्ध कोड की सूची यहां मिल सकती है.

family

string

इस इमेज में पौधों के परिवार के नाम की ऐसी जानकारी दी गई है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. उदाहरण: "बेटुलेसी (बर्च की प्रजाति)".

season

string

उन मौसमों के ब्यौरे की टेक्स्ट के तौर पर सूची जहां पराग कण सक्रिय होते हैं. उदाहरण: "पतझड़ के आखिर में, वसंत में".

specialColors

string

पौधों के बारे में टेक्स्ट के तौर पर जानकारी पत्तियों, छाल, फूलों या बीजों के रंग से, पौधे को पहचानने में मदद मिलती है.

specialShapes

string

पौधों के बारे में टेक्स्ट के तौर पर जानकारी पत्तियों, छाल, फूल या बीज के आकार से पौधे को पहचानने में मदद मिलती है.

crossReaction

string

पराग कणों वाली प्रतिक्रिया वाले पौधों के बारे में टेक्स्ट के तौर पर जानकारी. उदाहरण: एल्डर, हेज़ल, हॉर्नबीम, बीच, विलो, और ओक का पराग.

picture

string

पौधे की तस्वीर का लिंक.

pictureCloseup

string

पौधे की क्लोज़-अप तस्वीर का लिंक.