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