- एचटीटीपी अनुरोध
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- ForecastHour
यह फ़ंक्शन, किसी जगह के लिए अगले 240 घंटों तक के हर घंटे के पूर्वानुमान की जानकारी देता है. यह जानकारी, मौजूदा घंटे से शुरू होती है.
एचटीटीपी अनुरोध
GET https://weather.googleapis.com/v1/forecast/hours:lookup
यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
क्वेरी पैरामीटर
| पैरामीटर | |
|---|---|
location |
ज़रूरी है. वह जगह जिसके लिए हर घंटे के हिसाब से मौसम का पूर्वानुमान पाना है. |
unitsSystem |
ज़रूरी नहीं. मौसम की जानकारी के लिए इस्तेमाल किया जाने वाला यूनिट सिस्टम. अगर यह जानकारी नहीं दी जाती है, तो मौसम की जानकारी मेट्रिक सिस्टम में दिखाई जाएगी (डिफ़ॉल्ट = METRIC). |
pageSize |
ज़रूरी नहीं. हर पेज पर, हर घंटे के हिसाब से मौसम के पूर्वानुमान के ज़्यादा से ज़्यादा रिकॉर्ड दिखाने की संख्या. इसकी वैल्यू 1 से 24 के बीच होनी चाहिए. डिफ़ॉल्ट रूप से, यह वैल्यू 24 होती है. |
pageToken |
ज़रूरी नहीं. यह पिछले अनुरोध से मिला पेज टोकन है. इसका इस्तेमाल, अगले पेज को वापस पाने के लिए किया जाता है. |
hours |
ज़रूरी नहीं. इस पैरामीटर की मदद से, मौजूदा समय से लेकर कुल घंटों की संख्या को सीमित किया जाता है. इसकी वैल्यू 1 से 240 (दोनों शामिल हैं) के बीच होती है. डिफ़ॉल्ट रूप से, यह वैल्यू 240 होती है. |
languageCode |
ज़रूरी नहीं. इस कुकी की मदद से क्लाइंट, जवाब के लिए भाषा चुन सकता है. अगर उस भाषा के लिए डेटा उपलब्ध नहीं है, तो एपीआई सबसे मिलते-जुलते डेटा का इस्तेमाल करता है. अनुमति वाली वैल्यू, IETF BCP-47 स्टैंडर्ड पर आधारित होती हैं. डिफ़ॉल्ट वैल्यू "en" होती है. |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
hours.lookup RPC के लिए जवाब.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
| JSON के काेड में दिखाना |
|---|
{ "forecastHours": [ { object ( |
| फ़ील्ड | |
|---|---|
forecastHours[] |
अनुरोध में बताए गए घंटों की संख्या और पेज के साइज़ के हिसाब से, हर घंटे के पूर्वानुमान के रिकॉर्ड. |
timeZone |
अनुरोध की गई जगह का टाइम ज़ोन. |
nextPageToken |
अगला पेज वापस पाने के लिए टोकन. |
अनुमति पाने के लिंक
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/cloud-platform
ForecastHour
यह किसी जगह के लिए, हर घंटे के हिसाब से मौसम के पूर्वानुमान का रिकॉर्ड दिखाता है.
| JSON के काेड में दिखाना |
|---|
{ "interval": { object ( |
| फ़ील्ड | |
|---|---|
interval |
यह पूर्वानुमान डेटा, एक घंटे के अंतराल (यूटीसी समय में) के लिए मान्य होता है. टाइमस्टैंप को सबसे नज़दीकी घंटे के हिसाब से राउंड डाउन किया जाता है. |
displayDateTime |
यह उस जगह के टाइम ज़ोन के हिसाब से स्थानीय तारीख और समय (सिविल टाइम) होता है जिसके लिए हर घंटे के हिसाब से मौसम का पूर्वानुमान लगाया जाता है. इस फ़ील्ड का इस्तेमाल, क्लाइंट पर दिखाने के लिए किया जा सकता है. ध्यान दें: इस तारीख में साल, महीना, दिन, घंटा, और यूटीसी से ऑफ़सेट शामिल होगा. |
weatherCondition |
मौसम के पूर्वानुमान की जानकारी. |
temperature |
अनुमानित तापमान. |
feelsLikeTemperature |
इससे पता चलता है कि अनुरोध की गई जगह पर तापमान कैसा महसूस होगा. |
dewPoint |
ओस बनने के लिए ज़रूरी तापमान का पूर्वानुमान. |
heatIndex |
पूर्वानुमानित हीट इंडेक्स का तापमान. |
windChill |
हवा की वजह से महसूस होने वाली ठंड और त्वचा के संपर्क में आने वाली हवा का तापमान. |
wetBulbTemperature |
वेट बल्ब से लिए गए तापमान का अनुमान, पानी के वाष्पीकरण से मिलने वाला सबसे कम तापमान. |
precipitation |
बारिश होने की संभावना और पिछले एक घंटे में हुई बारिश की मात्रा का अनुमान. |
airPressure |
हवा के दबाव की अनुमानित स्थितियां. |
wind |
हवा की स्थिति का पूर्वानुमान. |
visibility |
विज्ञापन दिखने से जुड़े अनुमानित आंकड़े. |
iceThickness |
बर्फ़ की अनुमानित मोटाई. |
isDaytime |
अगर यह समय, स्थानीय सूर्योदय (शामिल) और सूर्यास्त (शामिल नहीं) के बीच है, तो वैल्यू को 'सही है' पर सेट करें. इसके अलावा, यह रात का समय होता है (सूरज ढलने और अगली सुबह सूरज निकलने के बीच का समय). ध्यान दें: अगर इंटरवल, स्थानीय सूर्योदय और सूर्यास्त के समय के साथ इंटरसेक्ट करता है, तो इस घंटे को दिन या रात माना जाएगा. उदाहरण के लिए: अगर इंटरवल सुबह 5 बजे से सुबह 6 बजे तक है और सूर्योदय सुबह 5:59 बजे होता है, तो isDaytime की वैल्यू सही होगी. |
relativeHumidity |
अनुमानित रिलेटिव ह्युमिडिटी का प्रतिशत (वैल्यू 0 से 100 के बीच). |
uvIndex |
पूर्वानुमानित अल्ट्रावायलेट (यूवी) इंडेक्स. |
thunderstormProbability |
आंधी-तूफ़ान की आशंका (वैल्यू 0 से 100 के बीच). |
cloudCover |
आकाश में बादलों के छाए रहने का अनुमानित प्रतिशत. इसकी वैल्यू 0 से 100 के बीच होती है. |