Method: lookupWeather

किसी जगह के मौसम की जानकारी खोजना.

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

POST https://mapstools.googleapis.com/v1:lookupWeather

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

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

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },
  "capabilities": [
    enum (Capability)
  ],
  "date": {
    object (Date)
  },
  "hour": integer,
  "languageCode": string,
  "weatherOptions": {
    object (WeatherOptions)
  },
  "airQualityOptions": {
    object (AirQualityOptions)
  }
}
फ़ील्ड
unitsSystem

enum (UnitsSystem)

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

object (Location)

ज़रूरी है. वह जगह जिसके मौसम की जानकारी चाहिए.
capabilities[]

enum (Capability)

ज़रूरी नहीं. जवाब में शामिल करने के लिए, एनवायरमेंट से जुड़ी सुविधाएं.
date

object (Date)

ज़रूरी नहीं. इससे, अनुरोध की गई पर्यावरण की जानकारी की तारीख का पता चलता है. यह तारीख, location फ़ील्ड में बताई गई जगह के स्थानीय टाइमज़ोन के हिसाब से होती है. तारीख की सीमाएं, अनुरोध की गई सुविधाओं के हिसाब से तय होती हैं: - WEATHER: पिछले 24 घंटों तक (जब hour भी सेट हो) और आने वाले 10 दिनों (240 घंटे) तक (हर दिन के पूर्वानुमान के लिए, आज से लेकर +9 दिनों तक). - AIR_QUALITY: पिछले 30 दिनों (720 घंटे) और आने वाले चार दिनों (96 घंटे) तक का डेटा. - POLLEN: आज से लेकर अगले चार दिनों तक (आज को मिलाकर पांच दिनों तक; पुरानी तारीखें इस्तेमाल नहीं की जा सकतीं).
hour

integer

ज़रूरी नहीं. इससे, अनुरोध की गई पर्यावरण की जानकारी के घंटे का पता चलता है. यह जानकारी, 24 घंटे के फ़ॉर्मैट (0-23) में होती है. यह जानकारी, location फ़ील्ड में बताई गई जगह के स्थानीय टाइमज़ोन के हिसाब से होती है. date की जानकारी देना ज़रूरी है. घंटे के हिसाब से रेंज, अनुरोध की गई सुविधाओं पर निर्भर करती हैं: - WEATHER: पिछले 24 घंटों तक और आने वाले 240 घंटों (10 दिन) तक. - AIR_QUALITY: पिछले 30 दिनों (720 घंटे) और आने वाले चार दिनों (96 घंटे) तक का डेटा. - POLLEN: इससे सिर्फ़ रोज़ाना के पूर्वानुमान मिलते हैं; पराग के लिए hour को अनदेखा किया जाता है.
languageCode

string

ज़रूरी नहीं. जवाब में स्थानीय भाषा में लिखे गए टेक्स्ट के लिए BCP-47 भाषा कोड (जैसे, "en", "ja", "fr-CA"). अगर कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से इसकी वैल्यू "en" होती है.
weatherOptions

object (WeatherOptions)

ज़रूरी नहीं. मौसम से जुड़े अनुरोधों के लिए विकल्प. weatherOptions.units_system को टॉप-लेवल unitsSystem (टैग 4) के साथ इस्तेमाल किया जा सकता है, ताकि कॉल करने वाले मौजूदा लोगों के लिए पुराने सिस्टम के साथ काम करने की सुविधा बनी रहे. अगर दोनों में अलग-अलग यूनिट सिस्टम की जानकारी दी जाती है, तो INVALID_ARGUMENT दिखता है. अगर capabilities में WEATHER का अनुरोध नहीं किया गया है, तो इसे अनदेखा कर दिया जाता है.
airQualityOptions

object (AirQualityOptions)

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

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

कामयाब रहने पर, जवाब के मुख्य हिस्से में LookupWeatherResponse का एक इंस्टेंस शामिल किया जाता है.

अनुमति पाने के लिंक

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

  • https://www.googleapis.com/auth/maps-platform.mapstools