- एचटीटीपी अनुरोध
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- HistoryHour
यह फ़ंक्शन, किसी जगह के लिए पिछले 24 घंटों का हर घंटे का पुराना मौसम डेटा दिखाता है. यह डेटा, पिछले घंटे से शुरू होता है.
एचटीटीपी अनुरोध
GET https://weather.googleapis.com/v1/history/hours:lookup
यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
क्वेरी पैरामीटर
| पैरामीटर | |
|---|---|
location |
ज़रूरी है. वह जगह जिसके लिए हर घंटे का पुराना डेटा पाना है. |
unitsSystem |
ज़रूरी नहीं. मौसम की जानकारी के लिए इस्तेमाल किया जाने वाला यूनिट सिस्टम. अगर यह जानकारी नहीं दी जाती है, तो मौसम की जानकारी मेट्रिक सिस्टम में दिखाई जाएगी (डिफ़ॉल्ट = METRIC). |
pageSize |
ज़रूरी नहीं. हर पेज पर, हर घंटे के हिसाब से ज़्यादा से ज़्यादा कितने पुराने रिकॉर्ड दिखाए जाएं. इसकी वैल्यू 1 से 24 के बीच होनी चाहिए. डिफ़ॉल्ट रूप से, यह वैल्यू 24 होती है. |
pageToken |
ज़रूरी नहीं. यह पिछले अनुरोध से मिला पेज टोकन है. इसका इस्तेमाल, अगले पेज को वापस पाने के लिए किया जाता है. |
hours |
ज़रूरी नहीं. यह पैरामीटर, पिछले घंटे से शुरू होने वाले कुल घंटों की संख्या को सीमित करता है. इसकी वैल्यू 1 से 24 (शामिल) के बीच होती है. डिफ़ॉल्ट रूप से, यह वैल्यू 24 होती है. |
languageCode |
ज़रूरी नहीं. इस कुकी की मदद से क्लाइंट, जवाब के लिए भाषा चुन सकता है. अगर उस भाषा के लिए डेटा उपलब्ध नहीं है, तो एपीआई सबसे मिलते-जुलते डेटा का इस्तेमाल करता है. अनुमति वाली वैल्यू, IETF BCP-47 स्टैंडर्ड पर आधारित होती हैं. डिफ़ॉल्ट वैल्यू "en" होती है. |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
hours.lookup RPC के लिए जवाब.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
| JSON के काेड में दिखाना |
|---|
{ "historyHours": [ { object ( |
| फ़ील्ड | |
|---|---|
historyHours[] |
अनुरोध में बताए गए घंटों की संख्या और पेज के साइज़ के हिसाब से, हर घंटे के पुराने रिकॉर्ड. |
timeZone |
अनुरोध की गई जगह का टाइम ज़ोन. |
nextPageToken |
अगला पेज वापस पाने के लिए टोकन. |
अनुमति पाने के लिंक
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/cloud-platform
HistoryHour
यह किसी जगह की जानकारी के इतिहास के हर घंटे के रिकॉर्ड को दिखाता है.
| 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 के बीच). |