Method: forecast.lookup

यह 65 से ज़्यादा देशों में, पराग कणों की रोज़ाना पांच दिन तक की जानकारी दिखाता है. यह जानकारी एक कि॰मी॰ तक मिलती है.

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

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

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

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

पैरामीटर
location

object (LatLng)

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

integer

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

integer

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

string

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

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

string

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

boolean

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

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

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

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

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

जेएसओएन के काेड में दिखाना 
{
  "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 स्टैंडर्ड के मुताबिक होना चाहिए. वैल्यू, सामान्य रेंज के अंदर होनी चाहिए.

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

number

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

number

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

DayInfo

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

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

object (Date)

यूटीसी में वह तारीख जब पराग कणों का डेटा दिखाया जाता है.
pollenTypeInfo[]

object (PollenTypeInfo)

इस सूची में, अनुरोध में बताई गई जगह पर असर डालने वाले तीन तरह के पराग (घास, खरपतवार, पेड़) की जानकारी शामिल होगी.
plantInfo[]

object (PlantInfo)

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

तारीख

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

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

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

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

integer

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

integer

साल का महीना. बिना महीना और दिन के किसी साल के बारे में बताने के लिए, यह 1 से 12 के बीच होना चाहिए या 0 होना चाहिए.
day

integer

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

PollenTypeInfo

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

जेएसओएन के काेड में दिखाना 
{
  "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

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

जेएसओएन के काेड में दिखाना 
{
  "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 यूनिवर्सल पराग इंडेक्स.

रंग

आरजीबीए कलर स्पेस में कलर को दिखाता है. इस प्रज़ेंटेशन को इस तरह डिज़ाइन किया गया है कि अलग-अलग भाषाओं में, रंगों का इस्तेमाल करके उन्हें आसानी से समझा जा सके. उदाहरण के लिए, इस प्रज़ेंटेशन के फ़ील्ड, 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('');
};

// ...
जेएसओएन के काेड में दिखाना 
{
  "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

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

जेएसओएन के काेड में दिखाना 
{
  "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

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

जेएसओएन के काेड में दिखाना 
{
  "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

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