Method: publicAlerts.lookup

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

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

GET https://weather.googleapis.com/v1/publicAlerts:lookup

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

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

पैरामीटर
location

object (LatLng)

ज़रूरी है. वह जगह जहां के लिए आपको मौसम की सार्वजनिक चेतावनियां चाहिए. यह सेवा, उन चेतावनियों को दिखाएगी जिन पर इस जगह का असर पड़ा है.
pageSize

integer

ज़रूरी नहीं. हर पेज पर, मौसम की सार्वजनिक चेतावनियों के ज़्यादा से ज़्यादा रिकॉर्ड दिखाए जाते हैं.
pageToken

string

ज़रूरी नहीं. यह पिछले publicAlerts.lookup कॉल से मिला पेज टोकन है. अगला पेज पाने के लिए, यह टोकन दें. पेज नंबर के हिसाब से डेटा दिखाने के दौरान, publicAlerts.lookup को दिए गए अन्य सभी पैरामीटर, पेज टोकन देने वाले कॉल से मेल खाने चाहिए.
languageCode

string

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

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

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

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

publicAlerts.lookup RPC के लिए जवाब.

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

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

object (PublicAlerts)

सार्वजनिक मौसम की चेतावनी के रिकॉर्ड, अनुरोध में बताई गई चेतावनियों की संख्या और पेज के साइज़ के हिसाब से.
regionCode

string

यह ISO_3166-1 alpha-2 कोड है. यह उस इलाके का कोड है जिसकी जानकारी अनुरोध में दी गई है. क्षेत्र की जानकारी देने के लिए, ISO_3166-1_alpha-2 का इस्तेमाल किया जाता है.
nextPageToken

string

यह एक ऐसा टोकन होता है जिसे pageToken के तौर पर भेजा जा सकता है, ताकि अगला पेज वापस पाया जा सके. अगर इस फ़ील्ड को खाली छोड़ा जाता है, तो इसके बाद कोई पेज नहीं होता.

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

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

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

PublicAlerts

इससे मौसम की सार्वजनिक चेतावनियों के बारे में पता चलता है.

JSON के काेड में दिखाना 
{
  "alertId": string,
  "alertTitle": {
    object (LocalizedText)
  },
  "eventType": enum (WeatherEventType),
  "areaName": string,
  "instruction": [
    string
  ],
  "safetyRecommendations": [
    {
      object (SafetyRecommendation)
    }
  ],
  "timezoneOffset": string,
  "startTime": string,
  "expirationTime": string,
  "dataSource": {
    object (DataSource)
  },
  "polygon": string,
  "description": string,
  "severity": enum (Severity),
  "certainty": enum (Certainty),
  "urgency": enum (Urgency)
}
फ़ील्ड
alertId

string

इस सूचना के लिए यूनीक आइडेंटिफ़ायर.
alertTitle

object (LocalizedText)

सूचना का स्थानीय भाषा में टाइटल.
eventType

enum (WeatherEventType)

मौसम से जुड़ी घटना का टाइप.
areaName

string

उस इलाके का नाम जहां के लिए सूचना जारी की गई है.
instruction[]

string

पब्लिशर के सुझाए गए निर्देश. कृपया ध्यान दें कि इस फ़ील्ड को स्थानीय भाषा में होना चाहिए. हालांकि, इसकी कोई गारंटी नहीं है.
safetyRecommendations[]

object (SafetyRecommendation)

उपयोगकर्ता को सुरक्षा से जुड़े सुझाव देने का निर्देश. ये सुझाव, पब्लिशर या अन्य संस्थाएं दे सकती हैं.
timezoneOffset

string

सूचना की जगह के लिए, यूटीसी से टाइम ज़ोन का ऑफ़सेट. वैल्यू को 's' पर खत्म होने वाली स्ट्रिंग के तौर पर फ़ॉर्मैट किया जाता है. उदाहरण के लिए, यूटीसी से चार घंटे पहले के लिए "-14400s".
startTime

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

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

object (DataSource)

सूचना जारी करने वाले पब्लिशर की जानकारी.
polygon

string

उन इलाकों का GeoJSON फ़ॉर्मैट, जहां के लिए सूचना जारी की गई है.

GeoJSON डेटा, RFC 7946 फ़ॉर्मैट में होना चाहिए. साथ ही, यह एक पॉलीगॉन (एक ही इलाके के लिए) या मल्टीपॉलीगॉन (अलग-अलग इलाकों के लिए) के तौर पर दिखना चाहिए.

उदाहरण:

{ "type": "Polygon", "coordinates": [ [ [-1, -1], [-1, 0], [0, 0], [-1, -1] ] ] }

MultiPolygon GeoJson स्ट्रिंग का सैंपल ऐसा दिखता है:

{ "type": "MultiPolygon", "coordinates": [ [ [0, 0], [-1, 0], [-1, 1], [0, 0] ], [ [0, 0], [-2, 0], [-2, 2], [0, 0] ] ]
description

string

आधिकारिक संस्था की ओर से जारी की गई चेतावनी के बारे में नया टेक्स्ट. कृपया ध्यान दें कि इस फ़ील्ड को स्थानीय भाषा में होना चाहिए. हालांकि, इसकी कोई गारंटी नहीं है.
severity

enum (Severity)

चेतावनी का गंभीरता लेवल.
certainty

enum (Certainty)

सूचना मिलने की संभावना.
urgency

enum (Urgency)

सूचना कितनी ज़रूरी है.

WeatherEventType

मौसम से जुड़ी घटना का टाइप.

Enums
WEATHER_EVENT_TYPE_UNSPECIFIED मौसम से जुड़े इवेंट के टाइप की जानकारी नहीं दी गई है.
ACID_RAIN ऐसिड रेन का इवेंट.
AFTERSHOCK भूकंप के बाद के झटके का इवेंट.
AVALANCHE हिमस्खलन का इवेंट.
BLIZZARD बर्फ़ीला तूफ़ान.
BLOWING_SNOW बर्फ़ीली आंधी से जुड़ी चेतावनी.
BUSHFIRE जंगल में आग लगने की घटना.
COASTAL_FLOOD तटीय इलाकों में बाढ़ की घटना.
COASTAL_HAZARD तटीय इलाकों में खतरे की घटना.
COLD कोल्ड इवेंट.
CYCLONE चक्रवात का इवेंट.
DROUGHT सूखे की स्थिति.
DUST_STORM धूल भरी आंधी.
EARTHQUAKE भूकंप का इवेंट.
EXTRATROPICAL_CYCLONE उष्णकटिबंधीय चक्रवात का इवेंट.
FIRE इवेंट ट्रिगर करता है.
FIRE_WEATHER जंगल में आग लगने की घटना.
FLASH_FLOOD अचानक बाढ़ आने की घटना.
FLOOD बाढ़ की घटना.
FOG फ़ॉग इवेंट.
FREEZING फ़्रीज़िंग इवेंट.
FREEZING_AIR_TEMPERATURE हवा का तापमान बहुत कम होने की वजह से होने वाला इवेंट.
FREEZING_DRIZZLE बर्फ़ीली बूंदा-बांदी की चेतावनी.
FREEZING_RAIN_EVENT बर्फ़ीली बारिश.
FROST पाले का इवेंट.
GALE Gale इवेंट.
GLAZE ग्लेज़ इवेंट.
HAIL ओले गिरने का इवेंट.
HAZARDOUS_SEAS समुद्र में खतरे की स्थिति.
HEAT हीट इवेंट.
HUMIDITY नमी से जुड़ा इवेंट.
HURRICANE तूफ़ान से जुड़ा इवेंट.
ICE_STORM बर्फ़ीले तूफ़ान का इवेंट.
INDUSTRIAL_FIRE फ़ैक्ट्री में आग लगने की घटना.
LAKE_EFFECT_SNOW लेक इफ़ेक्ट स्नो इवेंट.
LANDSLIDE भूस्खलन की घटना.
MONSOON बारिश के मौसम में होने वाला इवेंट.
MUDDY_FLOOD बाढ़ के पानी में मिट्टी मिली हुई है.
OUTFLOW आउटफ़्लो इवेंट.
RADIATION रेडिएशन इवेंट.
RAIN_EVENT बारिश का इवेंट.
RIVER_FLOODING नदी में बाढ़ आने की घटना.
SEVERE_THUNDERSTORM_WARNING बादलों की गड़गड़ाहट के साथ तेज़ आंधी की चेतावनी.
SNOWSQUALL स्नोस्क्वाल इवेंट.
SNOW_EVENT बर्फ़बारी का इवेंट.
STORM तूफ़ान की घटना.
STORM_SURGE तूफ़ान बढ़ने की घटना.
THUNDER तूफ़ान की घटना.
THUNDERSTORM आंधी-तूफ़ान की घटना.
TORNADO बवंडर की घटना.
TORNADO_WARNING बवंडर की चेतावनी वाला इवेंट.
TROPICAL_CYCLONE उष्णकटिबंधीय चक्रवात की घटना.
TROPICAL_CYCLONE_WARNINGS_AND_WATCHES उष्णकटिबंधीय चक्रवात की चेतावनी और निगरानी से जुड़ा इवेंट.
TROPICAL_DISTURBANCE ट्रॉपिकल डिस्टर्बेंस की घटना.
TROPICAL_STORM उष्णकटिबंधीय तूफ़ान.
TSUNAMI सुनामी से जुड़ा इवेंट.
TYPHOON तूफ़ान का इवेंट.
VOLCANIC_ASH ज्वालामुखी की राख का धुआँ फ़ैला है.
VOLCANIC_ERUPTION ज्वालामुखी विस्फोट का इवेंट.
WILDFIRE जंगल में आग लगने की घटना.
WIND हवा से जुड़ा इवेंट.
WIND_CHILL ठंडी हवा चलने की वजह से तापमान में गिरावट.
WIND_WAVE हवा की लहर का इवेंट.
WINTER_STORM बर्फ़ीले तूफ़ान का इवेंट.

गंभीरता

यह कोड, सूचना वाले मैसेज के विषय इवेंट की गंभीरता को दिखाता है.

Enums
SEVERITY_UNKNOWN गंभीरता के बारे में जानकारी नहीं है.
EXTREME जीवन या संपत्ति को असाधारण खतरा।
SEVERE जीवन या संपत्ति को गंभीर खतरा।
MODERATE जीवन या संपत्ति को संभावित खतरा।
MINOR जीवन या संपत्ति को मामूली खतरा।

निश्चितता

यह कोड, सूचना वाले मैसेज के विषय इवेंट की पुष्टि करता है.

Enums
CERTAINTY_UNKNOWN पक्के तौर पर नहीं कहा जा सकता.
OBSERVED यह तय किया गया है कि उल्लंघन हुआ है या अब भी हो रहा है.
VERY_LIKELY बहुत ज़्यादा संभावना है.
LIKELY संभावना है (p > ~50%).
POSSIBLE संभव है, लेकिन इसकी संभावना कम है (p <= ~50%).
UNLIKELY नहीं (p ~ 0%).

अत्यावश्यकता

यह कोड, सूचना वाले मैसेज के विषय इवेंट की प्राथमिकता को दिखाता है.

Enums
URGENCY_UNKNOWN इस बारे में जानकारी नहीं है कि यह समस्या कितनी ज़रूरी है.
IMMEDIATE जवाब देने वाली कार्रवाई तुरंत की जानी चाहिए.
EXPECTED जल्द से जल्द (अगले एक घंटे के अंदर) जवाब देना ज़रूरी है.
FUTURE जल्द ही जवाब देने वाली कार्रवाई की जानी चाहिए.
PAST अब जवाब देने वाली कार्रवाई की ज़रूरत नहीं है.

SafetyRecommendation

यह सुरक्षा से जुड़े सुझाव को दिखाता है.

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

string

उपयोगकर्ता के लिए निर्देश. कृपया ध्यान दें कि इस फ़ील्ड को स्थानीय भाषा में होना चाहिए. हालांकि, इसकी कोई गारंटी नहीं है.
subtext

string

निर्देश के लिए एक वैकल्पिक सबटेक्स्ट, जिसमें उपयोगकर्ता के लिए ज़्यादा जानकारी हो सकती है. कृपया ध्यान दें कि इस फ़ील्ड को स्थानीय भाषा में होना चाहिए. हालांकि, इसकी कोई गारंटी नहीं है.

DataSource

यह किसी डेटा सोर्स के लिंक को दिखाता है.

JSON के काेड में दिखाना 
{
  "publisher": enum (Publisher),
  "name": string,
  "authorityUri": string
}
फ़ील्ड
publisher

enum (Publisher)

सूचना देने वाला पब्लिशर.
name

string

पब्लिशर का आधिकारिक नाम. कृपया ध्यान दें कि इस फ़ील्ड को स्थानीय भाषा में होना चाहिए. हालांकि, इसकी कोई गारंटी नहीं है.
authorityUri

string

अथॉरिटी की वेबसाइट का यूआरएल.

प्रकाशक

सूचना देने वाला पब्लिशर.

Enums
PUBLISHER_UNSPECIFIED पब्लिशर की जानकारी नहीं दी गई है.
AUSTRALIA_ACT_ESA ऑस्ट्रेलिया ऑस्ट्रेलियन कैपिटल टेरिटरी
AUSTRALIA_NSW_RFS न्यू साउथ वेल्स
AUSTRALIA_QLD_QFES क्वींसलैंड
AUSTRALIA_SA_CFS दक्षिणी ऑस्ट्रेलिया
METEO_ALARM_AT Meteoalarm / EUMETNET Austria
METEO_ALARM_BS बोस्निया
BRAZIL_CENAD ब्राज़ील में आपदा प्रबंधन एजेंसी
BRAZIL_INMET ब्राज़ील में मौसम विज्ञान एजेंसी
UK_ENV_AGENCY यूनाइटेड किंगडम
METEO_ALARM_BG Meteoalarm / EUMETNET Bulgaria
METEO_ALARM_CR क्रोएशिया
METEO_ALARM_CY साइप्रस
METEO_ALARM_CS चेकिया
METEO_ALARM_DK डेनमार्क
EC_INAMHI इक्वाडोर
METEO_ALARM_FI Meteoalarm / EUMETNET Finland
METEO_ALARM_FR फ़्रांस
DE_DWD जर्मनी
METEO_ALARM_GB Meteoalarm / EUMETNET Great Britain
METEO_ALARM_GR ग्रीस
METEO_ALARM_HU हंगरी
METEO_ALARM_IS आइसलैंड
METEO_ALARM_IE आयरलैंड
METEO_ALARM_IT इटली
JM_JMS जमैका
JMA जापान
METEO_ALARM_NL Meteoalarm / EUMETNET Netherlands
METEO_ALARM_LV लातविया
METEO_ALARM_LT लिथुआनिया
METEO_ALARM_LU लक्ज़मबर्ग
MEXICO_CIRES मेक्सिको मेक्सिको सीआईआरईएस
NZ_GEONET न्यूज़ीलैंड न्यूज़ीलैंड जियोनेट
NZ_NMS MetService
METEO_ALARM_MK Meteoalarm / EUMETNET North Macedonia
METEO_ALARM_NO नॉर्वे
PHILIPPINES_PAGASA फ़िलिपींस
METEO_ALARM_PL Meteoalarm / EUMETNET Poland
METEO_ALARM_PT पुर्तगाल
METEO_ALARM_RO रोमानिया
METEO_ALARM_RS सर्बिया
SG_MSS सिंगापुर
METEO_ALARM_SK Meteoalarm / EUMETNET Slovakia
METEO_ALARM_SI स्लोवेनिया
SB_MET सोलोमन द्वीप समूह
METEO_ALARM_ES Meteoalarm / EUMETNET Spain
METEO_ALARM_SE स्वीडन
METEO_ALARM_CH स्विट्ज़रलैंड
TAIWAN_NCDR ताइवान
NOAA अमेरिका का एनओएए
WCATWC नैशनल सुनामी वॉर्निंग सेंटर