MCP Tools Reference: mapstools.googleapis.com

टूल: lookup_weather

मौसम की पूरी जानकारी हासिल करता है. इसमें मौजूदा स्थिति, हर घंटे, और रोज़ाना के पूर्वानुमान शामिल हैं.

उपलब्ध डेटा: तापमान (मौजूदा, महसूस होने वाला, ज़्यादा से ज़्यादा/कम से कम, हीट इंडेक्स), हवा (रफ़्तार, तेज़ हवाएं, दिशा), खगोलीय घटनाएं (सूर्योदय/सूर्यास्त, चांद की कलाएं), बारिश (किस तरह की, संभावना, मात्रा/क्यूपीएफ़), वायुमंडलीय स्थितियां (यूवी इंडेक्स, नमी, बादलों की स्थिति, आंधी-तूफ़ान की संभावना), और जियोकोड की गई जगह का पता.

जगह और जगह से जुड़े नियम (ज़रूरी):

जिस जगह के मौसम का डेटा चाहिए उसे location फ़ील्ड का इस्तेमाल करके बताया जाता है. यह फ़ील्ड 'oneof' स्ट्रक्चर है. इसका मतलब है कि मौसम के डेटा को सटीक तरीके से देखने के लिए, आपको यहां दिए गए तीन लोकेशन सब-फ़ील्ड में से सिर्फ़ एक के लिए वैल्यू देनी होगी.

  1. भौगोलिक निर्देशांक (lat_lng)

    • इसका इस्तेमाल तब करें, जब आपको सटीक अक्षांश/देशांतर निर्देशांक दिए गए हों.
    • उदाहरण: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // लॉस एंजेलिस
  2. जगह का आईडी (place_id)

    • एक यूनीक स्ट्रिंग आइडेंटिफ़ायर (Google Maps पर जगह का आईडी).
    • place_id को search_places टूल से फ़ेच किया जा सकता है.
    • उदाहरण: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // एफ़िल टावर
  3. पते की स्ट्रिंग (address)

    • यह फ़्री-फ़ॉर्म स्ट्रिंग है. इसमें जियोकोडिंग के लिए, सटीक जानकारी की ज़रूरत होती है.
    • शहर और इलाका: हमेशा इलाका/देश शामिल करें. उदाहरण के लिए, "लंदन" के बजाय "लंदन, यूके" लिखें.
    • मोहल्ले का पता: पूरा पता दें. जैसे, "1600 Pennsylvania Ave NW, Washington, DC".
    • पिन कोड: इसके साथ देश का नाम ज़रूर होना चाहिए. उदाहरण के लिए, "90210, USA", न कि "90210".
    • उदाहरण: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

इस्तेमाल करने के मोड:

  • मौजूदा मौसम: सिर्फ़ location की जानकारी दें. date और hour की वैल्यू न दें.

  • हर घंटे का पूर्वानुमान: location, date, और hour (0-23) की जानकारी दें. इसका इस्तेमाल किसी खास समय (जैसे, "शाम 5 बजे") या "अगले कुछ घंटे" या "आज बाद में" जैसे शब्दों के लिए करें. अगर उपयोगकर्ता मिनट बताता है, तो उसे सबसे हाल ही के घंटे के हिसाब से बदल दिया जाता है. फ़िलहाल, अगले 120 घंटों के बाद के लिए, हर घंटे के हिसाब से पूर्वानुमान नहीं लगाया जा सकता. पिछले 24 घंटों तक के मौसम की जानकारी, हर घंटे के हिसाब से देखी जा सकती है.

  • रोज़ाना का पूर्वानुमान: location और date की जानकारी दें. hour की वैल्यू न दें. इसका इस्तेमाल, किसी सामान्य दिन के मौसम की जानकारी पाने के लिए करें. जैसे, "कल का मौसम", "शुक्रवार का मौसम", "25 दिसंबर का मौसम". अगर आज की तारीख कॉन्टेक्स्ट में नहीं है, तो आपको उपयोगकर्ता को इसके बारे में साफ़ तौर पर बताना चाहिए. आज की तारीख को मिलाकर, 10 दिनों से ज़्यादा के लिए रोज़ाना का पूर्वानुमान नहीं दिखाया जा सकता. मौसम की पुरानी जानकारी उपलब्ध नहीं है.

पैरामीटर की सीमाएं:

  • टाइम ज़ोन: date और hour के सभी इनपुट, जगह के स्थानीय टाइम ज़ोन के हिसाब से होने चाहिए, न कि उपयोगकर्ता के टाइम ज़ोन के हिसाब से.
  • तारीख का फ़ॉर्मैट: इनपुट को {year, month, day} पूर्णांकों में अलग-अलग किया जाना चाहिए.
  • इकाइयां: डिफ़ॉल्ट रूप से METRIC पर सेट होती हैं. अगर उपयोगकर्ता अमेरिका के स्टैंडर्ड के हिसाब से जानकारी मांगता है या साफ़ तौर पर अनुरोध करता है, तो फ़ैरनहाइट/मील के लिए units_system को IMPERIAL पर सेट करें.
  • उपलब्ध होने पर, attribution फ़ील्ड की जानकारी का इस्तेमाल करके, ग्राउंडेड आउटपुट को सोर्स के साथ एट्रिब्यूट किया जाना चाहिए.

यहां दिए गए कोड सैंपल में, curl का इस्तेमाल करके lookup_weather एमसीपी टूल को कॉल करने का तरीका बताया गया है.

Curl अनुरोध
curl --location 'https://mapstools.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "lookup_weather",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

इनपुट स्कीमा

LookupWeather तरीके के लिए अनुरोध - अनुरोध की गई जगह के मौसम की जानकारी दिखाता है.

LookupWeatherRequest

JSON के काेड में दिखाना
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },

  // Union field _date can be only one of the following:
  "date": {
    object (Date)
  }
  // End of list of possible types for union field _date.

  // Union field _hour can be only one of the following:
  "hour": integer
  // End of list of possible types for union field _hour.
}
फ़ील्ड
unitsSystem

enum (UnitsSystem)

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

location

object (Location)

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

यूनियन फ़ील्ड _date.

_date इनमें से सिर्फ़ एक हो सकता है:

date

object (Date)

ज़रूरी नहीं. मौसम की जानकारी के लिए ज़रूरी तारीख. ध्यान दें: यह तारीख, जगह वाले फ़ील्ड में बताई गई जगह के स्थानीय टाइमज़ोन के हिसाब से होती है. तारीख, पिछले 24 घंटों और अगले 10 दिनों के बीच की होनी चाहिए.

यूनियन फ़ील्ड _hour.

_hour इनमें से सिर्फ़ एक हो सकता है:

hour

integer

ज़रूरी नहीं. मौसम की जानकारी का घंटा, 24 घंटे वाले फ़ॉर्मैट (0-23) में. यह वैल्यू, जगह वाले फ़ील्ड में बताई गई जगह के स्थानीय टाइमज़ोन के हिसाब से होती है. फ़िलहाल, अगले 120 घंटों के बाद के लिए, हर घंटे के हिसाब से पूर्वानुमान नहीं लगाया जा सकता. मौसम की जानकारी देने वाले हर घंटे के पुराने डेटा को पिछले 24 घंटों तक ऐक्सेस किया जा सकता है.

तारीख

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

integer

तारीख का साल. यह 1 से 9999 के बीच होना चाहिए. इसके अलावा, साल के बिना तारीख बताने के लिए 0 होना चाहिए.

month

integer

साल का महीना. यह 1 से 12 के बीच होना चाहिए. इसके अलावा, महीने और दिन के बिना साल की जानकारी देने के लिए, 0 डालें.

day

integer

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

जगह

JSON के काेड में दिखाना
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
फ़ील्ड
यूनियन फ़ील्ड location_type. किसी जगह को दिखाने के अलग-अलग तरीके. location_type इनमें से सिर्फ़ एक हो सकता है:
latLng

object (LatLng)

भौगोलिक निर्देशांकों का इस्तेमाल करके तय किया गया पॉइंट.

placeId

string

जगह से जुड़ा जगह का आईडी .

address

string

किसी व्यक्ति के लिए आसानी से पढ़ा जा सकने वाला पता या Plus Code. ज़्यादा जानकारी के लिए, https://plus.codes पर जाएं.

LatLng

JSON के काेड में दिखाना
{
  "latitude": number,
  "longitude": number
}
फ़ील्ड
latitude

number

डिग्री में अक्षांश. यह [-90.0, +90.0] की रेंज में होना चाहिए.

longitude

number

डिग्री में देशांतर. यह [-180.0, +180.0] की रेंज में होना चाहिए.

UnitsSystem

इससे वैल्यू को मापने के लिए इस्तेमाल किए जाने वाले यूनिट सिस्टम की जानकारी मिलती है.

Enums
UNITS_SYSTEM_UNSPECIFIED इकाइयों का सिस्टम नहीं बताया गया है.
IMPERIAL इंपीरियल यूनिट सिस्टम (जैसे, फ़ैरनहाइट, मील वगैरह).
METRIC मेट्रिक यूनिट सिस्टम (जैसे, सेल्सियस, किलोमीटर वगैरह).

आउटपुट स्कीमा

LookupWeather आरपीसी के लिए जवाब - अनुरोध की गई जगह के मौसम की जानकारी दिखाता है.

इस जवाब में हर घंटे और हर दिन की जानकारी दी गई है. इसलिए, जवाब को तीन सेक्शन में बांटा गया है: हर घंटे, हर दिन, और शेयर की गई जानकारी. सिर्फ़ हर घंटे और हर दिन वाले फ़ील्ड को 'ज़रूरी नहीं' के तौर पर मार्क किया गया है. हर घंटे और हर दिन की जानकारी के बीच शेयर किए जाने वाले फ़ील्ड में से कुछ फ़ील्ड हमेशा मौजूद होते हैं. इसलिए, उन्हें 'ज़रूरी नहीं' के तौर पर मार्क नहीं किया जाता. वहीं, बाकी फ़ील्ड को 'ज़रूरी नहीं' के तौर पर मार्क किया जाता है, क्योंकि वे हमेशा उपलब्ध नहीं होते.

LookupWeatherResponse

JSON के काेड में दिखाना
{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "returnedLocation": {
    object (Location)
  },
  "attribution": {
    object (Attribution)
  },

  // Union field _temperature can be only one of the following:
  "temperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _temperature.

  // Union field _feels_like_temperature can be only one of the following:
  "feelsLikeTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_temperature.

  // Union field _heat_index can be only one of the following:
  "heatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _heat_index.

  // Union field _air_pressure can be only one of the following:
  "airPressure": {
    object (AirPressure)
  }
  // End of list of possible types for union field _air_pressure.

  // Union field _max_temperature can be only one of the following:
  "maxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_temperature.

  // Union field _min_temperature can be only one of the following:
  "minTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _min_temperature.

  // Union field _feels_like_max_temperature can be only one of the following:
  "feelsLikeMaxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_max_temperature.

  // Union field _feels_like_min_temperature can be only one of the following:
  "feelsLikeMinTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_min_temperature.

  // Union field _max_heat_index can be only one of the following:
  "maxHeatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_heat_index.

  // Union field _sun_events can be only one of the following:
  "sunEvents": {
    object (SunEvents)
  }
  // End of list of possible types for union field _sun_events.

  // Union field _moon_events can be only one of the following:
  "moonEvents": {
    object (MoonEvents)
  }
  // End of list of possible types for union field _moon_events.

  // Union field _relative_humidity can be only one of the following:
  "relativeHumidity": integer
  // End of list of possible types for union field _relative_humidity.

  // Union field _uv_index can be only one of the following:
  "uvIndex": integer
  // End of list of possible types for union field _uv_index.

  // Union field _thunderstorm_probability can be only one of the following:
  "thunderstormProbability": integer
  // End of list of possible types for union field _thunderstorm_probability.

  // Union field _cloud_cover can be only one of the following:
  "cloudCover": integer
  // End of list of possible types for union field _cloud_cover.
}
फ़ील्ड
weatherCondition

object (WeatherCondition)

मौसम की स्थिति

precipitation

object (Precipitation)

बारिश या बर्फ़बारी वगैरह होने की संभावना और उसकी मात्रा

wind

object (Wind)

हवा की स्थिति

returnedLocation

object (Location)

ज़रूरी है. वह जगह जहां के मौसम की जानकारी दी गई है. यह जगह, अनुरोध में दी गई जगह से मिलती-जुलती है. हालांकि, अगर अनुरोध की गई जगह, फ़्री टेक्स्ट पता है, तो यह जगह उससे अलग हो सकती है. फ़्री टेक्स्ट पता, अनुमानित जगह की जानकारी देता है. जैसे, "माउंटेन व्यू, कैलिफ़ोर्निया".

attribution

object (Attribution)

मौसम की जानकारी के साथ एट्रिब्यूशन दिखाना ज़रूरी है.

यूनियन फ़ील्ड _temperature.

_temperature इनमें से सिर्फ़ एक हो सकता है:

temperature

object (Temperature)

हर घंटे के हिसाब से तापमान

यूनियन फ़ील्ड _feels_like_temperature.

_feels_like_temperature इनमें से सिर्फ़ एक हो सकता है:

feelsLikeTemperature

object (Temperature)

हर घंटे के हिसाब से तापमान कैसा महसूस हो रहा है.

यूनियन फ़ील्ड _heat_index.

_heat_index इनमें से सिर्फ़ एक हो सकता है:

heatIndex

object (Temperature)

हर घंटे के हिसाब से हीट इंडेक्स का तापमान.

यूनियन फ़ील्ड _air_pressure.

_air_pressure इनमें से सिर्फ़ एक हो सकता है:

airPressure

object (AirPressure)

हर घंटे के हिसाब से हवा के दबाव की जानकारी.

यूनियन फ़ील्ड _max_temperature.

_max_temperature इनमें से सिर्फ़ एक हो सकता है:

maxTemperature

object (Temperature)

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

यूनियन फ़ील्ड _min_temperature.

_min_temperature इनमें से सिर्फ़ एक हो सकता है:

minTemperature

object (Temperature)

पूरे दिन का कम से कम तापमान.

यूनियन फ़ील्ड _feels_like_max_temperature.

_feels_like_max_temperature इनमें से सिर्फ़ एक हो सकता है:

feelsLikeMaxTemperature

object (Temperature)

दिन भर में महसूस होने वाला ज़्यादा से ज़्यादा तापमान.

यूनियन फ़ील्ड _feels_like_min_temperature.

_feels_like_min_temperature इनमें से सिर्फ़ एक हो सकता है:

feelsLikeMinTemperature

object (Temperature)

पूरे दिन के दौरान, महसूस होने वाला कम से कम तापमान.

यूनियन फ़ील्ड _max_heat_index.

_max_heat_index इनमें से सिर्फ़ एक हो सकता है:

maxHeatIndex

object (Temperature)

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

यूनियन फ़ील्ड _sun_events.

_sun_events इनमें से सिर्फ़ एक हो सकता है:

sunEvents

object (SunEvents)

सूरज से जुड़े इवेंट. जैसे, सूर्योदय, सूर्यास्त.

यूनियन फ़ील्ड _moon_events.

_moon_events इनमें से सिर्फ़ एक हो सकता है:

moonEvents

object (MoonEvents)

चाँद से जुड़े इवेंट. जैसे, चंद्रोदय, चंद्रास्त.

यूनियन फ़ील्ड _relative_humidity.

_relative_humidity इनमें से सिर्फ़ एक हो सकता है:

relativeHumidity

integer

रिलेटिव ह्यूमिडिटी का प्रतिशत (0 से 100 के बीच की वैल्यू). इसे वैकल्पिक के तौर पर तय करें, क्योंकि यह हमेशा उपलब्ध नहीं होता

यूनियन फ़ील्ड _uv_index.

_uv_index इनमें से सिर्फ़ एक हो सकता है:

uvIndex

integer

मैक्सिमम अल्ट्रावॉयलेट (यूवी) इंडेक्स. इसे वैकल्पिक के तौर पर तय करें, क्योंकि यह हमेशा उपलब्ध नहीं होता

यूनियन फ़ील्ड _thunderstorm_probability.

_thunderstorm_probability इनमें से सिर्फ़ एक हो सकता है:

thunderstormProbability

integer

तूफ़ान आने की संभावना (0 से 100 तक की वैल्यू). इसे वैकल्पिक के तौर पर तय करें, क्योंकि यह हमेशा उपलब्ध नहीं होता

यूनियन फ़ील्ड _cloud_cover.

_cloud_cover इनमें से सिर्फ़ एक हो सकता है:

cloudCover

integer

आसमान का वह हिस्सा जो बादलों से ढका है. इसकी वैल्यू 0 से 100 के बीच होती है. इसे वैकल्पिक के तौर पर तय करें, क्योंकि यह हमेशा उपलब्ध नहीं होता

तापमान

JSON के काेड में दिखाना
{
  "unit": enum (TemperatureUnit),

  // Union field _degrees can be only one of the following:
  "degrees": number
  // End of list of possible types for union field _degrees.
}
फ़ील्ड
unit

enum (TemperatureUnit)

तापमान की वैल्यू को मापने के लिए इस्तेमाल की जाने वाली इकाई का कोड.

यूनियन फ़ील्ड _degrees.

_degrees इनमें से सिर्फ़ एक हो सकता है:

degrees

number

चुनी गई इकाई में तापमान की वैल्यू (डिग्री में).

AirPressure

JSON के काेड में दिखाना
{

  // Union field _mean_sea_level_millibars can be only one of the following:
  "meanSeaLevelMillibars": number
  // End of list of possible types for union field _mean_sea_level_millibars.
}
फ़ील्ड

यूनियन फ़ील्ड _mean_sea_level_millibars.

_mean_sea_level_millibars इनमें से सिर्फ़ एक हो सकता है:

meanSeaLevelMillibars

number

समुद्र तल पर हवा का औसत दबाव, मिलीबार में.

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".

टाइमस्टैम्प

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

string (int64 format)

यह Unix epoch 1970-01-01T00:00:00Z के बाद से, यूटीसी समय के सेकंड दिखाता है. यह -62135596800 और 253402300799 के बीच होना चाहिए. इसमें ये दोनों संख्याएं भी शामिल हैं. यह 0001-01-01T00:00:00Z से 9999-12-31T23:59:59Z के बीच होना चाहिए.

nanos

integer

नैनोसेकंड रिज़ॉल्यूशन में सेकंड के नॉन-नेगेटिव फ़्रैक्शन. यह फ़ील्ड, अवधि का नैनोसेकंड वाला हिस्सा है. यह सेकंड का विकल्प नहीं है. फ़्रैक्शन वाली नेगेटिव सेकंड वैल्यू में, अब भी नॉन-नेगेटिव नैनो वैल्यू होनी चाहिए. ये वैल्यू, समय के साथ आगे बढ़ती हैं. यह संख्या 0 से 99,99,99,999 के बीच होनी चाहिए. हालांकि, इन दोनों में से भी कोई संख्या हो सकती है.

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)

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

WeatherCondition

JSON के काेड में दिखाना
{
  "iconBaseUri": string,
  "description": {
    object (LocalizedText)
  },
  "type": enum (Type)
}
फ़ील्ड
iconBaseUri

string

आइकॉन का बेस यूआरआई, जिसमें फ़ाइल टाइप एक्सटेंशन शामिल नहीं है. आइकॉन दिखाने के लिए, इस यूआरआई में अपनी पसंद की थीम और फ़ाइल टाइप एक्सटेंशन (.png या .svg) जोड़ें. डिफ़ॉल्ट रूप से, आइकॉन हल्के रंग वाली थीम में होता है. हालांकि, गहरे रंग वाले मोड के लिए _dark को जोड़ा जा सकता है. उदाहरण के लिए: "https://maps.gstatic.com/weather/v1/dust.svg" या "https://maps.gstatic.com/weather/v1/dust_dark.svg". यहां icon_base_uri, "https://maps.gstatic.com/weather/v1/dust" है.

description

object (LocalizedText)

मौसम की इस स्थिति के बारे में टेक्स्ट में दी गई जानकारी (स्थानीय भाषा में).

type

enum (Type)

मौसम की स्थिति किस तरह की है.

LocalizedText

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

string

नीचे दिए गए google.type.LocalizedText.language_code के हिसाब से, स्थानीय भाषा में स्ट्रिंग.

languageCode

string

टेक्स्ट का BCP-47 भाषा कोड, जैसे कि "en-US" या "sr-Latn".

ज़्यादा जानकारी के लिए, http://www.unicode.org/reports/tr35/#Unicode_locale_identifier पर जाएं.

बारिश

JSON के काेड में दिखाना
{
  "probability": {
    object (PrecipitationProbability)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
फ़ील्ड
probability

object (PrecipitationProbability)

बारिश या बर्फ़बारी वगैरह होने की संभावना (0 से 100 के बीच की वैल्यू).

snowQpf

object (QuantitativePrecipitationForecast)

एक तय समयावधि में जमा हुई बर्फ़ की मात्रा. इसे तरल पानी के बराबर मापा जाता है. ध्यान दें: क्यूपीएफ़, क्वांटिटेटिव प्रेसिपिटेशन फ़ोरकास्ट का छोटा नाम है. ज़्यादा जानकारी के लिए, कृपया QuantitativePrecipitationForecast की परिभाषा देखें.

qpf

object (QuantitativePrecipitationForecast)

एक तय समय में हुई बारिश की मात्रा, जिसे तरल पानी के बराबर मापा जाता है. ध्यान दें: क्यूपीएफ़, क्वांटिटेटिव प्रेसिपिटेशन फ़ोरकास्ट का छोटा नाम है. ज़्यादा जानकारी के लिए, कृपया QuantitativePrecipitationForecast की परिभाषा देखें.

PrecipitationProbability

JSON के काेड में दिखाना
{
  "type": enum (PrecipitationType),

  // Union field _percent can be only one of the following:
  "percent": integer
  // End of list of possible types for union field _percent.
}
फ़ील्ड
type

enum (PrecipitationType)

एक कोड, जिससे बारिश के टाइप का पता चलता है.

यूनियन फ़ील्ड _percent.

_percent इनमें से सिर्फ़ एक हो सकता है:

percent

integer

0 से 100 के बीच का प्रतिशत, जो बारिश या बर्फ़बारी वगैरह होने की संभावना दिखाता है.

QuantitativePrecipitationForecast

JSON के काेड में दिखाना
{
  "unit": enum (Unit),

  // Union field _quantity can be only one of the following:
  "quantity": number
  // End of list of possible types for union field _quantity.
}
फ़ील्ड
unit

enum (Unit)

जमा हुई बारिश की मात्रा को मापने के लिए इस्तेमाल की गई इकाई का कोड.

यूनियन फ़ील्ड _quantity.

_quantity इनमें से सिर्फ़ एक हो सकता है:

quantity

number

एक तय समय में हुई बारिश की मात्रा, जिसे तरल पानी के बराबर मापा जाता है.

हवा

JSON के काेड में दिखाना
{
  "direction": {
    object (WindDirection)
  },
  "speed": {
    object (WindSpeed)
  },
  "gust": {
    object (WindSpeed)
  }
}
फ़ील्ड
direction

object (WindDirection)

हवा की दिशा और वह किस ऐंगल से आ रही है.

speed

object (WindSpeed)

हवा की रफ़्तार.

gust

object (WindSpeed)

हवा का झोंका (हवा की रफ़्तार में अचानक बढ़ोतरी).

WindDirection

JSON के काेड में दिखाना
{
  "cardinal": enum (CardinalDirection),

  // Union field _degrees can be only one of the following:
  "degrees": integer
  // End of list of possible types for union field _degrees.
}
फ़ील्ड
cardinal

enum (CardinalDirection)

वह कोड जो हवा चलने की दिशा बताता है.

यूनियन फ़ील्ड _degrees.

_degrees इनमें से सिर्फ़ एक हो सकता है:

degrees

integer

हवा की दिशा डिग्री में (0 से 360 तक की वैल्यू).

WindSpeed

JSON के काेड में दिखाना
{
  "unit": enum (SpeedUnit),

  // Union field _value can be only one of the following:
  "value": number
  // End of list of possible types for union field _value.
}
फ़ील्ड
unit

enum (SpeedUnit)

हवा की रफ़्तार को मापने के लिए इस्तेमाल की जाने वाली इकाई को दिखाने वाला कोड.

यूनियन फ़ील्ड _value.

_value इनमें से सिर्फ़ एक हो सकता है:

value

number

हवा की रफ़्तार की वैल्यू.

जगह

JSON के काेड में दिखाना
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
फ़ील्ड
यूनियन फ़ील्ड location_type. किसी जगह को दिखाने के अलग-अलग तरीके. location_type इनमें से सिर्फ़ एक हो सकता है:
latLng

object (LatLng)

भौगोलिक निर्देशांकों का इस्तेमाल करके तय किया गया पॉइंट.

placeId

string

जगह से जुड़ा जगह का आईडी .

address

string

किसी व्यक्ति के लिए आसानी से पढ़ा जा सकने वाला पता या Plus Code. ज़्यादा जानकारी के लिए, https://plus.codes पर जाएं.

LatLng

JSON के काेड में दिखाना
{
  "latitude": number,
  "longitude": number
}
फ़ील्ड
latitude

number

डिग्री में अक्षांश. यह [-90.0, +90.0] की रेंज में होना चाहिए.

longitude

number

डिग्री में देशांतर. यह [-180.0, +180.0] की रेंज में होना चाहिए.

एट्रिब्यूशन

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

string

एट्रिब्यूशन के लिए दिखाया जाने वाला टाइटल.

url

string

एट्रिब्यूशन के लिए लिंक किया जाने वाला यूआरएल.

TemperatureUnit

यह तापमान मापने के लिए इस्तेमाल की जाने वाली इकाई को दिखाता है.

Enums
TEMPERATURE_UNIT_UNSPECIFIED तापमान की इकाई नहीं बताई गई है.
CELSIUS तापमान को सेल्सियस में मापा जाता है.
FAHRENHEIT तापमान को फ़ैरनहाइट में मापा जाता है.

MoonPhase

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

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

टाइप

इससे पूर्वानुमान एलिमेंट के संदर्भ में, मौसम की स्थिति के टाइप को मार्क किया जाता है.

Enums
TYPE_UNSPECIFIED मौसम की स्थिति के बारे में नहीं बताया गया है.
CLEAR कोई क्लाउड नहीं.
MOSTLY_CLEAR बीच-बीच में बादल छाए रहेंगे.
PARTLY_CLOUDY थोड़े-बहुत बादल छाए हैं.
MOSTLY_CLOUDY ज़्यादातर समय बादल छाए रहेंगे (धूप कम और बादल ज़्यादा रहेंगे).
CLOUDY बादल छाए हुए हैं (सिर्फ़ बादल, सूरज नहीं).
WINDY तेज़ हवा.
WIND_AND_RAIN तेज़ हवा के साथ बारिश.
LIGHT_RAIN_SHOWERS हल्की और रुक-रुककर बारिश.
CHANCE_OF_SHOWERS रुक-रुककर बारिश होने की संभावना है.
SCATTERED_SHOWERS रुक-रुककर बारिश होगी.
RAIN_SHOWERS बौछारें, बारिश की तुलना में कम समय के लिए होती हैं. ये अचानक शुरू और बंद होती हैं. साथ ही, इनकी तीव्रता में तेज़ी से बदलाव होता है.
HEAVY_RAIN_SHOWERS तेज़ बारिश.
LIGHT_TO_MODERATE_RAIN बारिश (हल्की से सामान्य).
MODERATE_TO_HEAVY_RAIN बारिश (सामान्य से भारी).
RAIN सामान्य बारिश.
LIGHT_RAIN हल्की बारिश.
HEAVY_RAIN भारी बारिश.
RAIN_PERIODICALLY_HEAVY बीच-बीच में भारी बारिश हो सकती है.
LIGHT_SNOW_SHOWERS हल्की बर्फ़बारी, जो कुछ समय के लिए अलग-अलग तीव्रता से हो रही है.
CHANCE_OF_SNOW_SHOWERS हल्की बर्फ़बारी होने का अनुमान है.
SCATTERED_SNOW_SHOWERS कम समय के लिए, अलग-अलग तीव्रता से होने वाली बर्फ़बारी.
SNOW_SHOWERS बर्फ़बारी.
HEAVY_SNOW_SHOWERS भारी बर्फ़बारी.
LIGHT_TO_MODERATE_SNOW हल्की से मध्यम बर्फ़बारी.
MODERATE_TO_HEAVY_SNOW सामान्य से भारी बर्फ़बारी.
SNOW थोड़ी-बहुत बर्फ़बारी.
LIGHT_SNOW हल्की बर्फ़बारी.
HEAVY_SNOW भारी बर्फ़बारी.
SNOWSTORM बर्फ़बारी के साथ-साथ, बिजली कड़कने और चमकने की संभावना है.
SNOW_PERIODICALLY_HEAVY बर्फ़बारी हो रही है और कभी-कभी तेज़ हो सकती है.
HEAVY_SNOW_STORM भारी बर्फ़बारी के साथ-साथ, बिजली चमकने और गरजने की संभावना है.
BLOWING_SNOW तेज़ हवा के साथ बर्फ़बारी.
RAIN_AND_SNOW बारिश और बर्फ़बारी हो रही है.
HAIL ओले.
HAIL_SHOWERS कम समय के लिए, अलग-अलग तीव्रता से ओले गिर रहे हैं.
THUNDERSTORM आंधी-तूफ़ान.
THUNDERSHOWER बिजली कड़कने और बादल गरजने के साथ तेज़ बारिश.
LIGHT_THUNDERSTORM_RAIN गरज के साथ हल्की बारिश.
SCATTERED_THUNDERSTORMS तूफ़ान के साथ कुछ समय के लिए अलग-अलग तीव्रता की बारिश.
HEAVY_THUNDERSTORM गरज के साथ भारी बारिश.

PrecipitationType

यह किसी जगह पर होने वाली बारिश के टाइप को दिखाता है.

Enums
PRECIPITATION_TYPE_UNSPECIFIED बारिश के टाइप की जानकारी नहीं है.
NONE बारिश या बर्फ़बारी नहीं होगी.
SNOW बर्फ़बारी.
RAIN बारिश.
LIGHT_RAIN हल्की बारिश.
HEAVY_RAIN तेज़ बारिश.
RAIN_AND_SNOW बारिश और बर्फ़बारी, दोनों तरह की बारिश.
SLEET ओले गिर रहे हैं.
FREEZING_RAIN बर्फ़ीली बारिश.

इकाई

इससे उस इकाई का पता चलता है जिसका इस्तेमाल, जमा हुई बारिश की मात्रा को मापने के लिए किया जाता है.

Enums
UNIT_UNSPECIFIED बारिश या बर्फ़बारी की इकाई की जानकारी नहीं दी गई है.
MILLIMETERS बारिश की मात्रा को मिलीमीटर में मापा जाता है.
INCHES बारिश की मात्रा को इंच में मापा जाता है.

CardinalDirection

यह मुख्य दिशाओं को दिखाता है. इसमें ऑर्डिनल दिशाएं भी शामिल हैं.

Enums
CARDINAL_DIRECTION_UNSPECIFIED मुख्य दिशा की जानकारी नहीं दी गई है.
NORTH उत्तर दिशा.
NORTH_NORTHEAST उत्तर-उत्तर-पूर्व की सेकंडरी इंटरकार्डिनल दिशा.
NORTHEAST उत्तर-पूर्व की इंटरकार्डिनल दिशा.
EAST_NORTHEAST पूर्व-उत्तर-पूर्व की सेकंडरी इंटरकार्डिनल दिशा.
EAST पूर्व दिशा.
EAST_SOUTHEAST पूर्व-दक्षिण-पूर्व की सेकंडरी इंटरकार्डिनल दिशा.
SOUTHEAST दक्षिण-पूर्व की इंटरकार्डिनल दिशा.
SOUTH_SOUTHEAST दक्षिण-दक्षिण-पूर्व की सेकंडरी इंटरकार्डिनल दिशा.
SOUTH दक्षिण दिशा.
SOUTH_SOUTHWEST दक्षिण-दक्षिण-पश्चिम की सेकंडरी इंटरकार्डिनल दिशा.
SOUTHWEST दक्षिण-पश्चिम दिशा.
WEST_SOUTHWEST पश्चिम-दक्षिण-पश्चिम की सेकंडरी इंटरकार्डिनल दिशा.
WEST पश्चिम दिशा.
WEST_NORTHWEST पश्चिम-उत्तर-पश्चिम की सेकंडरी इंटरकार्डिनल दिशा.
NORTHWEST उत्तर-पश्चिम दिशा.
NORTH_NORTHWEST उत्तर-उत्तर-पश्चिम की सेकंडरी इंटरकार्डिनल दिशा.

SpeedUnit

इससे रफ़्तार मापने के लिए इस्तेमाल की जाने वाली इकाई का पता चलता है.

Enums
SPEED_UNIT_UNSPECIFIED स्पीड की यूनिट नहीं बताई गई है.
KILOMETERS_PER_HOUR स्पीड को किलोमीटर प्रति घंटे में मापा जाता है.
MILES_PER_HOUR रफ़्तार को मील प्रति घंटे में मापा जाता है.

टूल एनोटेशन

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

टाइटल स्ट्रिंग के साथ-साथ, बूलियन हिंट के बारे में यहां बताया गया है:

  • readOnlyHint: अगर इसकी वैल्यू true है, तो टूल अपने एनवायरमेंट में बदलाव नहीं करता. डिफ़ॉल्ट: false.
  • destructiveHint: अगर इसकी वैल्यू true है, तो टूल नुकसान पहुंचाने वाली कार्रवाइयां कर सकता है. अगर यह वैल्यू false पर सेट है, तो टूल सिर्फ़ जोड़ने वाली कार्रवाइयां कर सकता है. डिफ़ॉल्ट: true.
  • idempotentHint: अगर इसकी वैल्यू true है, तो टूल को एक ही आर्ग्युमेंट के साथ बार-बार कॉल करने पर, उसके एनवायरमेंट पर कोई और असर नहीं पड़ेगा. डिफ़ॉल्ट: false.
  • openWorldHint: सही होने पर, टूल बाहरी इकाइयों की 'विशाल दुनिया' के साथ इंटरैक्ट कर सकता है. अगर यह वैल्यू false है, तो टूल सिर्फ़ इंटरनल इकाइयों के साथ इंटरैक्ट कर सकता है. उदाहरण के लिए, वेब सर्च टूल ओपन वर्ल्ड होगा, जबकि मेमोरी टूल ओपन वर्ल्ड नहीं होगा.

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ✅ | Open World Hint: ❌