Method: forecast.days.lookup

यह फ़ंक्शन, किसी जगह के लिए मौजूदा दिन से लेकर 10 दिनों तक के रोज़ के पूर्वानुमान दिखाता है.

एचटीटीपी अनुरोध

GET https://weather.googleapis.com/v1/forecast/days:lookup

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.

क्वेरी पैरामीटर

पैरामीटर
location

object (LatLng)

ज़रूरी है. वह जगह जहां के लिए रोज़ का मौसम का पूर्वानुमान चाहिए.
unitsSystem

enum (UnitsSystem)

ज़रूरी नहीं. मौसम की जानकारी दिखाने के लिए, यूनिट का सिस्टम. अगर यह पैरामीटर नहीं दिया जाता है, तो मौसम की जानकारी, मेट्रिक सिस्टम में दी जाएगी (डिफ़ॉल्ट = METRIC).
pageSize

integer

ज़रूरी नहीं. हर पेज पर, रोज़ाना के पूर्वानुमान के ज़्यादा से ज़्यादा रिकॉर्ड दिखाने के लिए - यह वैल्यू 1 से 10 के बीच होनी चाहिए. डिफ़ॉल्ट वैल्यू 5 है.
pageToken

string

ज़रूरी नहीं. पिछले अनुरोध से मिला पेज टोकन. इसका इस्तेमाल, अगले पेज को वापस पाने के लिए किया जाता है.
days

integer

ज़रूरी नहीं. मौजूदा दिन से फ़ेच किए जाने वाले कुल दिनों की संख्या को सीमित करता है. यह वैल्यू 1 से 10 के बीच हो सकती है. डिफ़ॉल्ट वैल्यू, ज़्यादा से ज़्यादा 10 है.
languageCode

string

ज़रूरी नहीं. क्लाइंट को जवाब के लिए भाषा चुनने की अनुमति देता है. अगर उस भाषा के लिए डेटा उपलब्ध नहीं कराया जा सकता, तो एपीआई सबसे मिलती-जुलती भाषा का इस्तेमाल करता है. इस्तेमाल की जा सकने वाली वैल्यू, आईईटीएफ़ बीसीपी-47 स्टैंडर्ड पर निर्भर करती हैं. डिफ़ॉल्ट वैल्यू "en" है.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

days.lookup आरपीसी का जवाब.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "forecastDays": [
    {
      object (ForecastDay)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
फ़ील्ड
forecastDays[]

object (ForecastDay)

अनुरोध में बताए गए दिनों की संख्या और पेज के साइज़ के हिसाब से, हर दिन के पूर्वानुमान के रिकॉर्ड.
timeZone

object (TimeZone)

जिस जगह के लिए अनुरोध किया गया है उसका टाइम ज़ोन.
nextPageToken

string

अगला पेज वापस पाने के लिए टोकन.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/cloud-platform

ForecastDay

किसी जगह के लिए, हर दिन के पूर्वानुमान का रिकॉर्ड दिखाता है.

JSON के काेड में दिखाना 
{
  "interval": {
    object (Interval)
  },
  "displayDate": {
    object (Date)
  },
  "daytimeForecast": {
    object (ForecastDayPart)
  },
  "nighttimeForecast": {
    object (ForecastDayPart)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "feelsLikeMaxTemperature": {
    object (Temperature)
  },
  "feelsLikeMinTemperature": {
    object (Temperature)
  },
  "maxHeatIndex": {
    object (Temperature)
  },
  "sunEvents": {
    object (SunEvents)
  },
  "moonEvents": {
    object (MoonEvents)
  },
  "iceThickness": {
    object (IceThickness)
  }
}
फ़ील्ड
interval

object (Interval)

यूटीसी टाइम इंटरवल, जब अनुमानित दिन शुरू होता है (इसमें शामिल) और खत्म होता है (इसमें शामिल नहीं). ध्यान दें: स्थानीय समय के हिसाब से, एक दिन सुबह 7 बजे शुरू होता है और अगले दिन सुबह 7 बजे खत्म होता है. उदाहरण के लिए: अगर लोकल टाइम ज़ोन UTC-7 है, तो इंटरवल 14:00:00.000Z समय पर शुरू होगा और अगले दिन उसी समय खत्म होगा.
displayDate

object (Date)

उस जगह के टाइम ज़ोन (सिविल टाइम) में स्थानीय तारीख, जिसके लिए इस दैनिक पूर्वानुमान का हिसाब लगाया गया है. इस फ़ील्ड का इस्तेमाल, क्लाइंट पर डिसप्ले के लिए किया जा सकता है.
daytimeForecast

object (ForecastDayPart)

दिन के समय (स्थानीय समय के मुताबिक सुबह 7 बजे से शाम 7 बजे तक) के लिए, मौसम की अनुमानित स्थितियां.
nighttimeForecast

object (ForecastDayPart)

रात के समय (स्थानीय समय के मुताबिक, शाम 7 बजे से अगले दिन सुबह 7 बजे तक) के लिए मौसम की अनुमानित स्थितियां.
maxTemperature

object (Temperature)

पूरे दिन का सबसे ज़्यादा (उच्च) तापमान.
minTemperature

object (Temperature)

पूरे दिन का सबसे कम (कम) तापमान.
feelsLikeMaxTemperature

object (Temperature)

दिन भर में, इतना तापमान महसूस हो रहा है.
feelsLikeMinTemperature

object (Temperature)

पूरे दिन के लिए, ऐसा तापमान जो असल तापमान से कम महसूस होता है.
maxHeatIndex

object (Temperature)

पूरे दिन का हीट इंडेक्स का सबसे ज़्यादा तापमान.
sunEvents

object (SunEvents)

सूरज से जुड़े इवेंट (जैसे, सूरज निकलना, सूरज डूबना).
moonEvents

object (MoonEvents)

चंद्रमा से जुड़े इवेंट (जैसे, चांद का निकलना, चांद का डूबना).
iceThickness

object (IceThickness)

दिन भर में जमी हुई बर्फ़ की कुल मात्रा.

तारीख

कैलेंडर की पूरी या कुछ तारीख दिखाता है, जैसे कि जन्मदिन. दिन का समय और टाइम ज़ोन, कहीं और बताया गया है या यह जानकारी ज़रूरी नहीं है. तारीख, ग्रेगोरियन कैलेंडर के हिसाब से होती है. यह इनमें से किसी एक को दिखा सकता है:

  • साल, महीने, और दिन की वैल्यू शून्य से ज़्यादा होनी चाहिए.
  • साल के तौर पर शून्य के साथ महीना और दिन (उदाहरण के लिए, सालगिरह).
  • साल, जिसमें महीना और दिन शून्य है.
  • साल और महीना, जिसमें दिन की वैल्यू शून्य हो. उदाहरण के लिए, क्रेडिट कार्ड के खत्म होने की तारीख.

मिलते-जुलते टाइप:

JSON के काेड में दिखाना 
{
  "year": integer,
  "month": integer,
  "day": integer
}
फ़ील्ड
year

integer

तारीख का साल. यह संख्या 1 से 9999 के बीच होनी चाहिए. अगर साल के बिना तारीख बतानी है, तो 0 डालें.
month

integer

साल का महीना. यह 1 से 12 के बीच की कोई संख्या होनी चाहिए. अगर महीने और दिन के बिना साल की जानकारी देनी है, तो 0 डालें.
day

integer

महीने का दिन. यह वैल्यू 1 से 31 के बीच की होनी चाहिए. साथ ही, यह साल और महीने के लिए मान्य होनी चाहिए. इसके अलावा, साल या साल और महीने के लिए 0 भी डाला जा सकता है, जहां दिन की वैल्यू का कोई मतलब नहीं है.

ForecastDayPart

दिन के किसी हिस्से के लिए, मौसम के पूर्वानुमान का रिकॉर्ड दिखाता है.

JSON के काेड में दिखाना 
{
  "interval": {
    object (Interval)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
फ़ील्ड
interval

object (Interval)

यूटीसी की वह तारीख और समय जब दिन का यह हिस्सा शुरू होता है (इसमें शामिल) और खत्म होता है (इसमें शामिल नहीं). ध्यान दें: किसी दिन का कोई हिस्सा, स्थानीय समय के हिसाब से सुबह 7 बजे शुरू होता है और उसी दिन शाम 7 बजे खत्म होता है. उदाहरण के लिए: अगर स्थानीय टाइम ज़ोन यूटीसी-7 है, तो दिन का इंटरवल 14:00:00.000Z बजे से शुरू होगा और अगले दिन 02:00:00.000Z बजे खत्म होगा. साथ ही, रात का इंटरवल अगले दिन 02:00:00.000Z बजे से शुरू होगा और उसी दिन 14:00:00.000Z बजे खत्म होगा.
weatherCondition

object (WeatherCondition)

मौसम की अनुमानित स्थिति.
precipitation

object (Precipitation)

बारिश या बर्फ़बारी की संभावना का अनुमान.
wind

object (Wind)

हवा की औसत दिशा, सबसे ज़्यादा रफ़्तार, और झोंके की रफ़्तार.
relativeHumidity

integer

अनुमानित सापेक्ष आर्द्रता का प्रतिशत (वैल्यू 0 से 100 के बीच).
uvIndex

integer

अनुमानित ज़्यादा से ज़्यादा पराबैंगनी (यूवी) इंडेक्स.
thunderstormProbability

integer

गरज-चमक के साथ बारिश होने की औसत संभावना.
cloudCover

integer

बादल के ढकने का औसत प्रतिशत.

SunEvents

इससे सूरज से जुड़े इवेंट की जानकारी मिलती है. जैसे, सूरज का निकलना और डूबना.

JSON के काेड में दिखाना 
{
  "sunriseTime": string,
  "sunsetTime": string
}
फ़ील्ड
sunriseTime

string (Timestamp format)

सूरज निकलने का समय.

ध्यान दें: कुछ खास मामलों में (जैसे, आर्कटिक सर्कल के उत्तर में) हो सकता है कि किसी दिन सूरज निकलने का समय न हो. ऐसे मामलों में, यह फ़ील्ड अनसेट कर दिया जाएगा.

आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
sunsetTime

string (Timestamp format)

सूरज डूबने का समय.

ध्यान दें: कुछ खास मामलों में, जैसे कि आर्कटिक सर्कल के उत्तर में, ऐसा हो सकता है कि किसी दिन सूर्यास्त का समय न हो. ऐसे मामलों में, यह फ़ील्ड अनसेट कर दिया जाएगा.

आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

MoonEvents

चंद्रमा से जुड़े इवेंट दिखाता है. जैसे, चांद का निकलना, चांद का डूबना.

JSON के काेड में दिखाना 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
फ़ील्ड
moonriseTimes[]

string (Timestamp format)

वह समय जब चांद का ऊपरी हिस्सा क्षितिज के ऊपर दिखता है (https://en.wikipedia.org/wiki/Moonrise_and_moonset) देखें.

ध्यान दें: ज़्यादातर मामलों में, हर दिन चांद के निकलने का एक ही समय होगा. अन्य मामलों में, सूची खाली हो सकती है. उदाहरण के लिए, जब चंद्रमा अगले दिन आधी रात के बाद निकलता है. हालांकि, खास मामलों में (उदाहरण के लिए, ध्रुवीय इलाकों में) सूची में एक से ज़्यादा वैल्यू हो सकती हैं. इन मामलों में, वैल्यू को बढ़ते क्रम में लगाया जाता है.

आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
moonsetTimes[]

string (Timestamp format)

वह समय जब चांद का ऊपरी हिस्सा, क्षितिज के नीचे गायब हो जाता है (https://en.wikipedia.org/wiki/Moonrise_and_moonset) देखें.

ध्यान दें: ज़्यादातर मामलों में, हर दिन चांद के डूबने का एक ही समय होगा. अन्य मामलों में, सूची खाली हो सकती है. उदाहरण के लिए, जब चंद्रमा अगले दिन आधी रात के बाद डूबता है. हालांकि, खास मामलों में (उदाहरण के लिए, ध्रुवीय इलाकों में) सूची में एक से ज़्यादा वैल्यू हो सकती हैं. इन मामलों में, वैल्यू को बढ़ते क्रम में लगाया जाता है.

आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
moonPhase

enum (MoonPhase)

चांद की स्थिति (इसे लूनर फ़ेज़ भी कहा जाता है).

MoonPhase

चांद की स्थिति (इसे लूनर फ़ेज़ भी कहा जाता है) दिखाता है.

Enums
MOON_PHASE_UNSPECIFIED चांद की कलाओं के बारे में जानकारी नहीं दी गई है.
NEW_MOON चांद पर सूरज की रोशनी न हो.
WAXING_CRESCENT उत्तरी गोलार्ध 🌒 में चंद्रमा की दाईं ओर 0% से 50% तक और दक्षिणी गोलार्ध 🌘 में उसकी बाईं ओर 0% से 50% तक रोशनी होती है.
FIRST_QUARTER उत्तरी गोलार्ध 🌓 में, चंद्रमा की दाईं ओर 50.1% और दक्षिणी गोलार्ध 🌗 में, चंद्रमा की बाईं ओर 50.1% रोशनी है.
WAXING_GIBBOUS उत्तरी गोलार्ध 🌔 में, चांद की दाईं ओर 50% से 100% तक रोशनी होती है. वहीं, दक्षिणी गोलार्ध 🌖 में, चांद की बाईं ओर 50% से 100% तक रोशनी होती है.
FULL_MOON चांद पूरी तरह से रोशन हो.
WANING_GIBBOUS उत्तरी गोलार्ध 🌖 में चंद्रमा की बाईं ओर 50% से 100% तक और दक्षिणी गोलार्ध 🌔 में उसकी दाईं ओर 50% से 100% तक रोशनी होती है.
LAST_QUARTER उत्तरी गोलार्ध 🌗 में, चंद्रमा की बाईं ओर 50.1% और दक्षिणी गोलार्ध 🌓 में, चंद्रमा की दाईं ओर 50.1% रोशनी है.
WANING_CRESCENT उत्तरी गोलार्ध 🌘 में चंद्रमा की बाईं ओर 0% से 50% तक और दक्षिणी गोलार्ध 🌒 में उसकी दाईं ओर 0% से 50% तक रोशनी होती है.