lookup_weather टूल की मदद से, एलएलएम किसी जगह के मौसम, एयर क्वालिटी, और पराग की जानकारी हासिल कर सकता है. एक अनुरोध में, किसी जगह के आईडी, पते या अक्षांश/देशांतर के निर्देशांकों के लिए, पर्यावरण से जुड़ी एक, दो या तीनों सुविधाओं के बारे में क्वेरी की जा सकती है.
सिर्फ़ मौसम या मौजूदा और अनुमानित एयर क्वालिटी के बारे में क्वेरी करने वाले अनुरोधों के लिए, Maps Grounding Essentials SKU के तहत बिल भेजा जाता है. Pro प्लान में, हर दिन पराग कणों के पूर्वानुमान और पिछले 30 दिनों तक की एयर क्वालिटी का डेटा मिलता है.
lookup_weather को एमसीपी सर्वर या lookupWeather REST तरीके से कॉल किया जा सकता है. इस पेज पर, एनवायरमेंट की सुविधाओं, अनुरोध के विकल्पों, Pro वर्शन के विकल्पों, जवाब के स्ट्रक्चर, और बिलिंग के नियमों के बारे में बताया गया है. पूरे स्कीमा के लिए, lookup_weather एमसीपी रेफ़रंस और lookupWeather REST रेफ़रंस देखें.
सुविधाएं और समयसीमाएं
capabilities कलेक्शन का इस्तेमाल करके, यह चुनें कि कौनसे एनवायरमेंटल डोमेन (WEATHER, AIR_QUALITY, POLLEN) दिखाने हैं. weather_options, air_quality_options या language_code सेट करने पर, capabilities ज़रूरी है. capabilities, weather_options, air_quality_options, और language_code को शामिल न करने पर, lookup_weather लेगसी वेदर मोड में चलता है और टॉप-लेवल के फ़्लैट वेदर फ़ील्ड दिखाता है.
date और hour की सभी वैल्यू का आकलन, अनुरोध की गई जगह के स्थानीय टाइम ज़ोन के हिसाब से किया जाता है. नीचे दी गई टेबल में, हर सुविधा के लिए इस्तेमाल की जा सकने वाली समयसीमा और एसकेयू की खास जानकारी दी गई है:
| अनुमति | मौजूदा स्थितियां (date और hour को शामिल नहीं किया गया है) |
पिछली बीमारियां | पूर्वानुमान की शर्तें | SKU |
|---|---|---|---|---|
WEATHER |
वर्तमान मौसम | पिछले 24 घंटों तक (इसके लिए, date और hour, दोनों की ज़रूरत होती है; hour के बिना पिछले date का इस्तेमाल नहीं किया जा सकता) |
hour सेट होने पर, 240 घंटे (10 दिन) तक का हर घंटे का पूर्वानुमान या सिर्फ़ date सेट होने पर, 10 दिन तक का रोज़ का पूर्वानुमान |
Essentials |
AIR_QUALITY |
हर घंटे की मौजूदा एयर क्वालिटी | date और hour सेट होने पर, पिछले 720 घंटों (30 दिन) में से किसी एक घंटे के लिए. इसके अलावा, सिर्फ़ date सेट होने पर, आज से 29 दिन पहले तक (हर घंटे की 24 एंट्री तक) |
अगर date और hour सेट हैं, तो आने वाले समय में 96 घंटे (चार दिन) तक के लिए, एक घंटे की एंट्री की जा सकती है. अगर सिर्फ़ date सेट है, तो आज से लेकर अगले तीन दिनों तक के लिए, हर घंटे के हिसाब से 24 एंट्री की जा सकती हैं |
मौसम की मौजूदा स्थिति, आज के पूरे दिन के मौसम की जानकारी, और पूर्वानुमान के लिए ज़रूरी जानकारी. अगर जवाब में आज से पहले की date या पिछली hour की जानकारी दी गई है, तो Pro |
POLLEN |
आज के लिए, हवा में पराग की मात्रा का पूर्वानुमान | इस्तेमाल नहीं किया जा सकता (INVALID_ARGUMENT गड़बड़ी दिखाता है) |
आज से लेकर अगले चार दिनों तक, पराग के स्तर का रोज़ का पूर्वानुमान. इसमें आज का दिन भी शामिल है. पराग के स्तर के लिए, hour को अनदेखा किया जाता है |
जवाब में Pro दिखने पर |
AIR_QUALITY के लिए, पिछले 720 घंटों से लेकर अगले 96 घंटों के पूर्वानुमान की विंडो, मौजूदा घंटे के हिसाब से तय की जाती है. पूरे दिन के अनुरोधों (hour के बिना date) में, स्थानीय समय के हिसाब से 00:00 से 23:00 तक का समय शामिल होता है. साथ ही, ये अनुरोध इस समयावधि के अंदर होने चाहिए. असल में, आज से 29 दिन पहले से लेकर आज के तीन दिन बाद तक.
जब किसी अनुरोध में एक से ज़्यादा क्षमताएं शामिल होती हैं, तो हर क्षमता के लिए समयसीमा का आकलन अलग-अलग किया जाता है. अगर अनुरोध किया गया date और hour, अनुरोध की गई कम से कम एक सुविधा की रेंज में है, तो जवाब में उन सुविधाओं के कंटेनर दिखाए जाते हैं जो काम करते हैं. साथ ही, उन सुविधाओं को हटा दिया जाता है जिनकी समयसीमा काम नहीं करती. उदाहरण के लिए, पिछले 30 दिनों में किसी तारीख के लिए AIR_QUALITY और POLLEN का अनुरोध करने पर, airQuality दिखता है और pollen को हटा दिया जाता है. अगर date या hour, अनुरोध की गई हर सुविधा के लिए तय की गई रेंज से बाहर है, तो अनुरोध करने पर INVALID_ARGUMENT गड़बड़ी का मैसेज दिखता है.
अनुरोध करने के विकल्प
एलएलएम, टूल को कॉल करते समय इन विकल्पों को सेट करता है. यह उपयोगकर्ता के अनुरोध और टूल के ब्यौरे के आधार पर किया जाता है. अपने निर्देशों की मदद से, यह तय किया जा सकता है कि मॉडल किन विकल्पों का इस्तेमाल करे. इसके लिए, Pro वर्शन के इस्तेमाल को कंट्रोल करना लेख पढ़ें.
यहां दी गई टेबल में, lookup_weather के लिए अनुरोध के विकल्पों के बारे में बताया गया है:
| विकल्प | ब्यौरा |
|---|---|
location |
ज़रूरी है. क्वेरी की जाने वाली जगह, जिसे address (किसी व्यक्ति के लिए आसानी से पढ़ा जा सकने वाला पता, शहर या लैंडमार्क का नाम), place_id या lat_lng (latitude और longitude) के तौर पर बताया गया हो. |
capabilities |
ज़रूरी नहीं. WEATHER, AIR_QUALITY, और POLLEN में से एक या उससे ज़्यादा वैल्यू. डुप्लीकेट वैल्यू हटा दी जाती हैं. weather_options, air_quality_options या language_code सेट करते समय ज़रूरी है. capabilities और उन सभी विकल्पों को हटाने पर, मौसम की जानकारी देने वाला लेगसी फ़्लैट-फ़ील्ड रिस्पॉन्स दिखता है. |
date |
ज़रूरी नहीं. अनुरोध की गई जगह की स्थानीय सिविल तारीख (year, month, day). मौजूदा स्थितियों के लिए, date और hour को शामिल न करें. |
hour |
ज़रूरी नहीं. अनुरोध की गई जगह का स्थानीय समय (0 से 23). इसके लिए, date को सेट करना ज़रूरी है. date के बिना hour सेट करने पर, INVALID_ARGUMENT गड़बड़ी का मैसेज दिखता है. |
language_code |
ज़रूरी नहीं. जवाब में स्थानीय भाषा में लिखे गए टेक्स्ट के लिए BCP-47 भाषा कोड, जैसे कि en, ja या fr-CA. डिफ़ॉल्ट रूप से, यह en पर सेट होता है. |
weather_options.units_system |
ज़रूरी नहीं. मौसम की वैल्यू के लिए यूनिट सिस्टम: METRIC (डिफ़ॉल्ट; सेल्सियस, किलोमीटर प्रति घंटा, मिलीमीटर) या IMPERIAL (फ़ैरनहाइट, मील प्रति घंटा, इंच). अगर WEATHER का अनुरोध नहीं किया गया है, तो इसे अनदेखा कर दिया जाता है. |
air_quality_options.include_pollutant_concentration |
ज़रूरी नहीं. true के मुताबिक, airQuality.hourlyResults[].pollutants[] में प्रदूषण फैलाने वाले कारकों की मात्रा, उत्सर्जन के स्रोत, और स्वास्थ्य पर पड़ने वाले असर शामिल हैं. डिफ़ॉल्ट रूप से, यह false पर सेट होता है. अगर AIR_QUALITY का अनुरोध नहीं किया गया है, तो इसे अनदेखा कर दिया जाता है. |
air_quality_options.index_region_code |
ज़रूरी नहीं. दो अक्षर वाला ISO 3166-1 alpha-2 देश या इलाके का कोड. उदाहरण के लिए, US, FR या CN. इसका इस्तेमाल, यूनिवर्सल एक्यूआई (यूएक्यूआई) के साथ-साथ स्थानीय एयर क्वालिटी इंडेक्स (एक्यूआई) स्केल चुनने के लिए किया जाता है. डिफ़ॉल्ट रूप से, अनुरोध की गई जगह के इलाके पर सेट होता है. अगर AIR_QUALITY का अनुरोध नहीं किया गया है, तो इसे अनदेखा कर दिया जाता है. |
Pro वर्शन के विकल्प
इन दोनों विकल्पों में से, Maps Grounding Pro SKU को चुनें. जब जवाब में इनमें से कोई भी विकल्प दिखता है, तो अनुरोध के लिए Pro SKU के तहत शुल्क लिया जाता है. एक से ज़्यादा सुविधाओं के लिए बिलिंग के नियमों के बारे में जानने के लिए, बिलिंग और कोटा देखें. यहां दी गई टेबल में, Pro के विकल्पों के बारे में बताया गया है:
| Pro वर्शन | इसका इस्तेमाल कब करें |
|---|---|
capabilities में POLLEN |
उपयोगकर्ता ने पराग के लेवल, मौसम के हिसाब से होने वाली एलर्जी, पेड़, घास या खरपतवार के पराग या एलर्जी पैदा करने वाले पौधों की खास प्रजातियों के बारे में पूछा हो. |
capabilities में AIR_QUALITY, जिसमें आज से पहले की date या पिछली hour हो |
उपयोगकर्ता, जगह के टाइम ज़ोन के हिसाब से पिछले 30 दिनों में एयर क्वालिटी, धुएं या प्रदूषण के बारे में पूछता है. |
lookup_weather के अन्य सभी अनुरोधों के लिए, Essentials एसकेयू के तहत बिलिंग की जाती है. इनमें ये शामिल हैं:
- मौसम से जुड़े सभी
WEATHERअनुरोध (मौजूदा, पिछले 24 घंटों का इतिहास, और 10 दिनों के लिए हर घंटे या रोज़ाना का पूर्वानुमान). - मौजूदा, आज के पूरे दिन (
dateकोhourके बिना आज पर सेट किया गया है), और अनुमानितAIR_QUALITYअनुरोध. इनमें वे अनुरोध भी शामिल हैं जोinclude_pollutant_concentrationकोtrueपर सेट करते हैं याindex_region_codeतय करते हैं.
उदाहरण
एमसीपी के इस अनुरोध में, टोक्यो में मौजूदा मौसम, एयर क्वालिटी (प्रदूषण फैलाने वाले कारकों की मात्रा के साथ), और आज के पराग के पूर्वानुमान के बारे में पूछा गया है. capabilities में POLLEN शामिल है, इसलिए अनुरोध के लिए Pro एसकेयू के तहत बिल भेजा जाता है:
{
"method": "tools/call",
"params": {
"name": "lookup_weather",
"arguments": {
"location": {"address": "Tokyo, Japan"},
"capabilities": ["WEATHER", "AIR_QUALITY", "POLLEN"],
"weather_options": {
"units_system": "METRIC"
},
"air_quality_options": {
"include_pollutant_concentration": true
},
"language_code": "en"
}
},
"jsonrpc": "2.0",
"id": 1
}
नीचे दिया गया उदाहरण, lookupWeather REST तरीके को वही अनुरोध भेजता है:
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-d '{
"location": {"address": "Tokyo, Japan"},
"capabilities": ["WEATHER", "AIR_QUALITY", "POLLEN"],
"weatherOptions": {"unitsSystem": "METRIC"},
"airQualityOptions": {"includePollutantConcentration": true},
"languageCode": "en"
}' \
"https://mapstools.googleapis.com/v1:lookupWeather"
API_KEY को अपने एपीआई पासकोड से बदलें.
जवाब
जब किसी अनुरोध में capabilities की जानकारी दी जाती है, तो जवाब में जगह की जानकारी के मेटाडेटा के साथ-साथ, अनुरोध की गई हर सुविधा के लिए डोमेन के हिसाब से कंटेनर भर जाते हैं:
returnedLocation: एनवायरमेंटल डेटा के लिए, जगह की जानकारी (address,placeIdयाlatLng, जो इनपुटlocationटाइप से मैच करती हो).timeZone: जगह की जानकारी के लिए, आईएएनए टाइम ज़ोन का आइडेंटिफ़ायर. जैसे,"America/Los_Angeles"या"Asia/Tokyo".weather:WEATHERका अनुरोध किए जाने पर, यह जानकारी अपने-आप भर जाती है:dateTime(मौजूदा और हर घंटे की क्वेरी के लिए), यूटीसी टाइमस्टैंप के तौर पर याdate(मौसम के रोज़ाना के पूर्वानुमान की क्वेरी के लिए). स्थानीय समय दिखाने के लिए,timeZoneफ़ील्ड का इस्तेमाल करकेdateTimeको कन्वर्ट करें.- तापमान (
temperature,feelsLikeTemperature,heatIndexया हर दिनmaxTemperature,minTemperature,feelsLikeMaxTemperature,feelsLikeMinTemperature,maxHeatIndex). weatherCondition,precipitation,wind,airPressure,relativeHumidity,uvIndex,thunderstormProbability,cloudCover, और हर दिनsunEventsऔरmoonEvents. सूर्योदय, सूर्यास्त, चंद्रोदय, और चंद्रास्त के समय, यूटीसी टाइमस्टैंप होते हैं.attribution: वह एट्रिब्यूशन जो आपको मौसम के डेटा के साथ दिखाना होगा.
airQuality:AIR_QUALITYका अनुरोध किए जाने पर, यह जानकारी अपने-आप भर जाती है:hourlyResults[]: इसमें मौजूदा या एक घंटे की क्वेरी के लिए एक एंट्री होती है. इसके अलावा, इसमें 24 एंट्री तक हो सकती हैं, जो पूरे स्थानीय दिन (00:00से23:00) को कवर करती हैं. ऐसा तब होता है, जब सिर्फ़dateसेट हो. जबdateआज की तारीख हो औरhourको शामिल न किया गया हो, तो एंट्री में आज के पिछले घंटे, मौजूदा घंटा, और पूर्वानुमान के बचे हुए घंटे शामिल होते हैं. हर एंट्री में ये चीज़ें शामिल होती हैं:dateTime: जगह के टाइम ज़ोन के हिसाब से, स्थानीय तारीख और समय (year,month,day,hours,minutes,seconds, औरutcOffset).indexes[]: यूनिवर्सल एक्यूआई और उपलब्ध होने पर, स्थानीय एक्यूआई (displayName,value,valueDisplay,category, औरdominantPollutant).pollutants[]: यह फ़ील्ड तब भरा जाता है, जबinclude_pollutant_concentrationकी वैल्यूtrue(ppbयाµg/m³मेंdisplayName,fullName,concentrationऔर उत्सर्जनsourcesऔर स्वास्थ्यeffectsके साथadditionalInfo) हो.healthRecommendations:generalPopulation,elderly,lungDiseasePopulation,heartDiseasePopulation,athletes,pregnantWomen, औरchildrenके लिए सलाह.
attribution: वह एट्रिब्यूशन जिसे आपको एयर क्वालिटी के डेटा के साथ दिखाना होगा.
pollen:POLLENका अनुरोध किए जाने पर, यह जानकारी अपने-आप भर जाती है:dailyForecast: अनुरोध किए गएdateके लिए पराग का पूर्वानुमान:date: पूर्वानुमान की तारीख.categories[]: एलर्जी पैदा करने वाले कणों की मुख्य कैटगरी (Tree,Grass, औरWeed). हर कैटगरी मेंdisplayName,inSeason, यूनिवर्सल पोलन इंडेक्सindex(0से5स्केल,category, औरdescription), औरhealthRecommendations[]शामिल हैं.plantSpecies[]: एलर्जी पैदा करने वाले पौधों की खास प्रजातियां (जैसे, बर्च, रैगवीड या जैपनीज़ सीडर). इनमें से हर प्रजाति के लिए,code,displayName, वनस्पति विज्ञान से जुड़ाfamily,inSeason, यूनिवर्सल पोलन इंडेक्सindex, फूल खिलने का सामान्यseason, औरcrossReactionsकी जानकारी दी जाती है.
attribution: वह एट्रिब्यूशन जिसे आपको पराग के डेटा के साथ दिखाना होगा.
अलग-अलग सुविधाओं के लिए, कुछ ही देशों में उपलब्ध है
जब किसी अनुरोध में एक से ज़्यादा सुविधाएं शामिल होती हैं, तो हर सुविधा का आकलन और फ़ेच अलग-अलग किया जाता है. अगर अनुरोध की गई जगह के लिए कोई सुविधा उपलब्ध नहीं है, वह तय समयसीमा से बाहर है या कुछ समय के लिए काम नहीं कर रही है, लेकिन कम से कम एक अन्य सुविधा काम कर रही है, तो जवाब में उपलब्ध सुविधा के कंटेनर दिखाए जाते हैं. साथ ही, अनुपलब्ध या काम न करने वाले कंटेनर को हटा दिया जाता है. अनुरोध में गड़बड़ी सिर्फ़ तब होती है, जब अनुरोध की गई हर सुविधा काम न करे.
फ़ील्ड की पूरी जानकारी के लिए,
lookup_weather रेफ़रंस देखें.
बिलिंग और कोटा
हर lookup_weather अनुरोध, बिल किए जा सकने वाला एक इवेंट होता है. भले ही, capabilities एक ही कॉल में दो या तीन एनवायरमेंटल डोमेन का अनुरोध करे:
- किसी अनुरोध के लिए, उन सुविधाओं के बीच सबसे ज़्यादा एसकेयू टियर के तहत बिल भेजा जाता है जो सफल होती हैं और जवाब में दिखती हैं:
- अगर जवाब में
pollenया पुरानीairQuality(जगह के टाइम ज़ोन में आज से पहले कीdateया पिछलीhour) शामिल है, तो अनुरोध के लिए, Maps Grounding Pro SKU के तहत बिल भेजा जाता है. एक ही कॉल मेंPOLLENऔर पुरानेAIR_QUALITYका अनुरोध करने पर भी, इसे Pro के लिए बिल किए जाने वाले एक इवेंट के तौर पर गिना जाता है. - अगर ऐसा नहीं है, तो अनुरोध के लिए Maps Grounding Essentials SKU के तहत बिल भेजा जाता है.
- अगर जवाब में
- अगर एक से ज़्यादा सुविधाओं के अनुरोध में Pro की कोई सुविधा शामिल नहीं की जाती है, तो जवाब में सिर्फ़ Essentials की सुविधाएं दिखती हैं. ऐसा इसलिए होता है, क्योंकि वह सुविधा जगह के लिए उपलब्ध नहीं होती, तय की गई समयसीमा से बाहर होती है या कुछ समय के लिए काम नहीं करती. ऐसे में, अनुरोध के लिए Essentials SKU के तहत बिल भेजा जाता है.
lookup_weather के लिए, हर प्रोजेक्ट के लिए हर मिनट 300 क्वेरी का कोटा होता है. इसे दोनों SKU शेयर करते हैं. कीमत जानने के लिए,
कीमत की मुख्य टेबल और
भारत के लिए कीमत की टेबल देखें.