- एचटीटीपी अनुरोध
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- LatLng
- DayInfo
- तारीख
- PollenTypeInfo
- PollenType
- IndexInfo
- इंडेक्स
- रंग
- PlantInfo
- पौधा
- PlantDescription
- इसे आज़माएं!
65 से ज़्यादा देशों में हर दिन के पराग कणों की जानकारी के साथ, 5 दिनों तक दिखाई जाती है. इस जानकारी का रिज़ॉल्यूशन 1 कि॰मी॰ तक हो सकता है.
एचटीटीपी अनुरोध
GET https://pollen.googleapis.com/v1/forecast:lookup
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
location |
ज़रूरी है. वह देशांतर और अक्षांश जिससे एपीआई, पराग कणों के अनुमान का डेटा खोजता है. |
days |
ज़रूरी है. वह संख्या जो बताती है कि पूर्वानुमान के लिए कितने दिनों का अनुरोध करना है (कम से कम वैल्यू 1 और ज़्यादा से ज़्यादा वैल्यू 5 है). |
pageSize |
ज़रूरी नहीं. हर पेज पर रोज़ाना मिलने वाली जानकारी के रिकॉर्ड की ज़्यादा से ज़्यादा संख्या. डिफ़ॉल्ट और ज़्यादा से ज़्यादा पांच वैल्यू है, जो पांच दिनों का डेटा है. |
pageToken |
ज़रूरी नहीं. रोज़ के पिछले कॉल से मिला पेज टोकन. इसका इस्तेमाल, अगले पेज को वापस पाने के लिए किया जाता है. ध्यान दें कि पेज टोकन के लिए वैल्यू देते समय, दिए गए अन्य सभी अनुरोध पैरामीटर, पेज टोकन देने वाले पिछले कॉल से मैच होने चाहिए. |
languageCode |
ज़रूरी नहीं. इससे क्लाइंट को जवाब के लिए भाषा चुनने की अनुमति मिलती है. अगर उस भाषा के लिए डेटा नहीं दिया जा सकता, तो एपीआई सबसे नज़दीकी मिलान का इस्तेमाल करता है. अनुमति वाली वैल्यू, IETF BCP-47 स्टैंडर्ड पर आधारित होती हैं. इसकी डिफ़ॉल्ट वैल्यू "en" है. |
plantsDescription |
ज़रूरी नहीं. इसमें पौधों के बारे में सामान्य जानकारी होती है. इसमें मौसम की जानकारी, खास आकार और रंग, एलर्जी के संपर्क में आए लोगों की जानकारी, और पौधों की फ़ोटो शामिल होती हैं. डिफ़ॉल्ट वैल्यू "सही" है. |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{
"regionCode": string,
"dailyInfo": [
{
object ( |
फ़ील्ड | |
---|---|
regionCode |
अनुरोध में दी गई जगह से जुड़े देश/इलाके का ISO_3166-1 alpha-2 कोड. अगर अनुरोध में दी गई जगह किसी विवादित देश/इलाके में है, तो इस फ़ील्ड को जवाब में शामिल नहीं किया जा सकता. |
dailyInfo[] |
ज़रूरी है. इस ऑब्जेक्ट में, अनुरोध किए गए हर दिन के मौसम के पूर्वानुमान की जानकारी होती है. |
nextPageToken |
ज़रूरी नहीं. अगला पेज वापस पाने के लिए टोकन. |
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/cloud-platform
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
LatLng
ऐसा ऑब्जेक्ट जो अक्षांश/देशांतर की जोड़ी को दिखाता है. डिग्री अक्षांश और डिग्री देशांतर को दिखाने के लिए, इसे डबल के जोड़े के तौर पर दिखाया जाता है. जब तक अलग से न बताया गया हो, यह ऑब्जेक्ट WGS84 मानक के मुताबिक होना चाहिए. वैल्यू, नॉर्मलाइज़ की जा सकने वाली रेंज के अंदर होनी चाहिए.
JSON के काेड में दिखाना |
---|
{ "latitude": number, "longitude": number } |
फ़ील्ड | |
---|---|
latitude |
डिग्री में अक्षांश. यह [-90.0, +90.0] की रेंज में होना चाहिए. |
longitude |
डिग्री में देशांतर. यह [-180.0, +180.0] की रेंज में होना चाहिए. |
DayInfo
इस ऑब्जेक्ट में, अनुरोध किए गए हर दिन के मौसम के पूर्वानुमान की जानकारी होती है.
JSON के काेड में दिखाना |
---|
{ "date": { object ( |
फ़ील्ड | |
---|---|
date |
यूटीसी फ़ॉर्मैट में वह तारीख जब पराग कणों के अनुमान का डेटा दिखाया जाता है. |
pollenTypeInfo[] |
इस सूची में, अनुरोध में बताई गई जगह पर असर डालने वाले ज़्यादा से ज़्यादा तीन तरह के पराग कणों (जीआरएसएस, डब्ल्यूईईडी, टीआरईई) शामिल होंगे. |
plantInfo[] |
इस सूची में, पराग कणों की ज़्यादा से ज़्यादा 15 प्रजातियों को शामिल किया जाएगा. ये प्रजातियों के पराग कण, अनुरोध में बताई गई जगह पर असर डालते हैं. |
तारीख
पूरी या आंशिक तारीख को दिखाता है, जैसे कि जन्मदिन. दिन का समय और टाइम ज़ोन कहीं और बताए गए हैं या अहम नहीं हैं. यह तारीख, ग्रेगोरियन कैलेंडर के हिसाब से है. यह इनमें से कोई एक चीज़ हो सकती है:
- पूरी तारीख, जिसमें साल, महीने, और दिन की वैल्यू शून्य के अलावा किसी अन्य वैल्यू के तौर पर शामिल हों.
- कोई महीना और दिन, जिसमें शून्य साल लिखा हो. जैसे, सालगिरह.
- अपने आप में एक वर्ष, एक शून्य महीना और एक शून्य दिन.
- साल और महीने, जिनमें दिन और समय शून्य हो. उदाहरण के लिए, क्रेडिट कार्ड की समयसीमा खत्म होने की तारीख.
मिलते-जुलते टाइप:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON के काेड में दिखाना |
---|
{ "year": integer, "month": integer, "day": integer } |
फ़ील्ड | |
---|---|
year |
तारीख का साल. 1 से 9999 के बीच की संख्या होनी चाहिए, या बिना साल वाली तारीख को बताने के लिए 0 होना चाहिए. |
month |
साल का महीना. यह वैल्यू 1 से 12 के बीच होनी चाहिए. अगर किसी साल में महीना और दिन नहीं है, तो उस साल की जानकारी देने के लिए यह संख्या 0 होनी चाहिए. |
day |
महीने का दिन. इसमें 1 से 31 तक का अंतर हो सकता है. साथ ही, साल और महीने के लिए मान्य होना चाहिए. इसके अलावा, किसी साल के बारे में बताने के लिए, वैल्यू 0 होनी चाहिए. इसके अलावा, साल और महीने की कोई खास जानकारी भी नहीं होनी चाहिए. |
PollenTypeInfo
इस ऑब्जेक्ट में, पराग के टाइप इंडेक्स और किसी खास तरह के पराग कणों के बारे में स्वास्थ्य से जुड़े सुझाव की जानकारी शामिल है.
JSON के काेड में दिखाना |
---|
{ "code": enum ( |
फ़ील्ड | |
---|---|
code |
पराग के प्रकार का कोड नाम. उदाहरण के लिए: "GRASS" |
displayName |
पराग के टाइप के नाम को इंसान आसानी से पढ़ सकते हैं. उदाहरण: "घास" |
indexInfo |
इसमें पराग के प्रकार के लिए यूनिवर्सल पॉलेन इंडेक्स (UPI) डेटा शामिल होता है. |
healthRecommendations[] |
पराग के मौजूदा लेवल के आधार पर स्वास्थ्य से जुड़ी अहम जानकारी के बारे में जानकारी की टेक्स्ट वाली सूची. |
inSeason |
इस बात की जानकारी देना कि पौधा किसी सीज़न में है या नहीं. |
PollenType
पराग प्रकार कोड
Enums | |
---|---|
POLLEN_TYPE_UNSPECIFIED |
यह जानकारी नहीं है कि पौधे किस तरह का है. |
GRASS |
घास के पराग कणों का प्रकार. |
TREE |
पेड़ के पराग कणों का टाइप. |
WEED |
खरपतवार के पराग कणों का प्रकार. |
IndexInfo
इस ऑब्जेक्ट में खास पॉलेन इंडेक्स वैल्यू, कैटगरी, और जानकारी दिखाने वाला डेटा है.
JSON के काेड में दिखाना |
---|
{ "code": enum ( |
फ़ील्ड | |
---|---|
code |
इंडेक्स का कोड. यह फ़ील्ड प्रोग्रामिंग के लिए इंडेक्स को दिखाता है. इसके लिए, स्पेस के बजाय सांप के केस का इस्तेमाल किया जाता है. उदाहरण के लिए: "UPI". |
displayName |
इंडेक्स के नाम की ऐसी जानकारी जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. उदाहरण: "यूनिवर्सल पॉलन इंडेक्स". |
category |
इंडेक्स न्यूमेरिक स्कोर की परिभाषा का टेक्स्ट क्लासिफ़िकेशन. इंडेक्स में छह कैटगरी होती हैं:
|
indexDescription |
मौजूदा इंडेक्स लेवल की टेक्स्ट के तौर पर जानकारी. |
color |
पराग इंडेक्स संख्या वाले स्कोर को दिखाने के लिए इस्तेमाल किया गया रंग. |
value |
इंडेक्स का अंकों में स्कोर. अंकों वाली रेंज 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 |
इंटरवल [0, 1] में वैल्यू के तौर पर रंग में लाल रंग. |
green |
इंटरवल [0, 1] में वैल्यू के तौर पर रंग में हरे रंग की मात्रा. |
blue |
इंटरवल [0, 1] में वैल्यू के तौर पर रंग में नीले रंग की मात्रा. |
alpha |
इस रंग का वह हिस्सा, जिसे पिक्सल पर लागू किया जाना चाहिए. इसका मतलब है कि आखिरी पिक्सल का रंग समीकरण से तय होता है:
इसका मतलब है कि 1.0 वैल्यू किसी ठोस रंग से मेल खाती है, जबकि 0.0 वैल्यू पूरी तरह से पारदर्शी रंग से मेल खाती है. यह किसी सामान्य फ़्लोट स्केलर के बजाय रैपर मैसेज का इस्तेमाल करता है, ताकि डिफ़ॉल्ट वैल्यू और सेट न की जा रही वैल्यू के बीच अंतर किया जा सके. अगर छोड़ दिया जाता है, तो इस रंग ऑब्जेक्ट को एक ठोस रंग के रूप में रेंडर किया जाता है (जैसे कि ऐल्फ़ा वैल्यू को साफ़ तौर पर 1.0 का मान दिया गया था). |
PlantInfo
इस ऑब्जेक्ट में किसी खास पौधे के बारे में हर दिन की जानकारी होती है.
JSON के काेड में दिखाना |
---|
{ "code": enum ( |
फ़ील्ड | |
---|---|
code |
प्लांट कोड का नाम. उदाहरण के लिए: "COTTONWOOD". सभी उपलब्ध कोड की सूची यहां मिल सकती है. |
displayName |
इस इमेज में पौधे के नाम को ऐसे फ़ॉर्मैट में लिखा गया है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. उदाहरण: “कॉटनवुड". |
indexInfo |
इस ऑब्जेक्ट में खास पॉलेन इंडेक्स वैल्यू, कैटगरी, और जानकारी दिखाने वाला डेटा है. |
plantDescription |
इसमें पौधों के बारे में सामान्य जानकारी होती है. जैसे, मौसम के हिसाब से जानकारी, खास आकार और रंग, एलर्जी के क्रॉस रिऐक्शन की जानकारी, और पौधों की फ़ोटो. |
inSeason |
इससे यह पता चलता है कि पौधा इस समय चल रहा है या नहीं. |
पौधा
सभी जगहों पर अलग-अलग पौधों की उपलब्धता की सूची दी गई है.
Enums | |
---|---|
PLANT_UNSPECIFIED |
प्लांट कोड की जानकारी नहीं है. |
ALDER |
ऑल्डर को पेड़ के पराग कणों की कैटगरी में रखा जाता है. |
ASH |
राख को पेड़ के पराग कणों की कैटगरी में रखा जाता है. |
BIRCH |
बर्च को पेड़ के पराग कणों की कैटगरी में रखा जाता है. |
COTTONWOOD |
कॉटनवुड को पेड़ के पराग कणों की कैटगरी में रखा जाता है. |
ELM |
एल्म को पेड़ के पराग कणों की कैटगरी में रखा जाता है. |
MAPLE |
मेपल को पेड़ के पराग कणों की कैटगरी में रखा जाता है. |
OLIVE |
ज़ैतून को पेड़ के पराग कणों की कैटगरी में रखा जाता है. |
JUNIPER |
ज्यूनिपर को पेड़ के पराग कणों की कैटगरी में रखा जाता है. |
OAK |
ओक को पेड़ के पराग कणों की कैटगरी में रखा जाता है. |
PINE |
देवदार को पेड़ के पराग कणों की कैटगरी में रखा जाता है. |
CYPRESS_PINE |
साइप्रस पाइन को पेड़ के पराग कणों की कैटगरी में रखा जाता है. |
HAZEL |
हेज़ल को पेड़ के पराग कणों की कैटगरी में रखा जाता है. |
GRAMINALES |
ग्रेमेनेलीज़ को घास के पराग कणों की कैटगरी में रखा जाता है. |
RAGWEED |
रैगवीड को खरपतवार के पराग कण की कैटगरी में रखा जाता है. |
MUGWORT |
मगवर्ट को खरपतवार के पराग कणों की कैटगरी में रखा जाता है. |
PlantDescription
इसमें पौधों के बारे में सामान्य जानकारी होती है. जैसे, मौसम के बारे में जानकारी, खास आकार और रंग, एलर्जी के संपर्क में आए लोगों की जानकारी, और पौधों की फ़ोटो.
JSON के काेड में दिखाना |
---|
{
"type": enum ( |
फ़ील्ड | |
---|---|
type |
पौधे का पराग कण. उदाहरण के लिए: "GRASS". सभी उपलब्ध कोड की सूची यहां मिल सकती है. |
family |
इस इमेज में पौधों के परिवार के नाम की ऐसी जानकारी दी गई है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. उदाहरण: "बेटुलेसी (बर्च की प्रजाति)". |
season |
उन मौसमों के ब्यौरे की टेक्स्ट के तौर पर सूची जहां पराग कण सक्रिय होते हैं. उदाहरण: "पतझड़ के आखिर में, वसंत में". |
specialColors |
पौधों के बारे में टेक्स्ट के तौर पर जानकारी पत्तियों, छाल, फूलों या बीजों के रंग से, पौधे को पहचानने में मदद मिलती है. |
specialShapes |
पौधों के बारे में टेक्स्ट के तौर पर जानकारी पत्तियों, छाल, फूल या बीज के आकार से पौधे को पहचानने में मदद मिलती है. |
crossReaction |
पराग कणों वाली प्रतिक्रिया वाले पौधों के बारे में टेक्स्ट के तौर पर जानकारी. उदाहरण: एल्डर, हेज़ल, हॉर्नबीम, बीच, विलो, और ओक का पराग. |
picture |
पौधे की तस्वीर का लिंक. |
pictureCloseup |
पौधे की क्लोज़-अप फ़ोटो का लिंक. |