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

ज़रूरी नहीं. इस कुकी की मदद से क्लाइंट, जवाब के लिए भाषा चुन सकता है. अगर उस भाषा के लिए डेटा उपलब्ध नहीं है, तो एपीआई सबसे मिलते-जुलते डेटा का इस्तेमाल करता है. अनुमति वाली वैल्यू, IETF BCP-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)
  }
}
फ़ील्ड
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)

चांद से जुड़े इवेंट (जैसे, चांद का उगना, चांद का अस्त होना).

तारीख

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

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

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

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)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
फ़ील्ड
interval

object (Interval)

यूटीसी के हिसाब से, दिन के इस हिस्से के शुरू होने (शामिल) और खत्म होने (शामिल नहीं) की तारीख और समय. ध्यान दें: दिन का एक हिस्सा, स्थानीय समय के हिसाब से सुबह 7 बजे से शुरू होकर शाम 7 बजे खत्म होता है. उदाहरण के लिए: अगर स्थानीय टाइम ज़ोन UTC-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)

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

object (IceThickness)

दिन के किसी हिस्से में बर्फ़बारी की कुल मात्रा.
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% तक रोशनी होती है 🌒.