Method: publicAlerts.lookup

تعرض هذه الطريقة تنبيهات عامة بشأن الطقس في موقع جغرافي محدّد.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات طلب البحث

المعلمات
location

object (LatLng)

الحقل مطلوب. الموقع الجغرافي الذي تريد تلقّي تنبيهات عامة بشأن حالة الطقس فيه ستعرض الخدمة تنبيهات تتداخل المنطقة المتأثرة فيها مع هذا الموقع الجغرافي.
pageSize

integer

اختيارية: الحدّ الأقصى لعدد سجلّات تنبيهات الطقس العامة التي سيتم عرضها في كل صفحة
pageToken

string

اختيارية: رمز مميز للصفحة تم تلقّيه من طلب publicAlerts.lookup سابق. قدِّم هذه السمة لاسترداد الصفحة التالية. عند تقسيم النتائج إلى صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى publicAlerts.lookup مع الطلب الذي قدَّم الرمز المميّز للصفحة.
languageCode

string

اختيارية: تتيح للعميل اختيار لغة الردّ. إذا تعذّر توفير البيانات لتلك اللغة، تستخدم واجهة برمجة التطبيقات أقرب تطابق. تعتمد القيم المسموح بها على معيار IETF BCP-47. القيمة التلقائية هي "en".

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

استجابة لطلب RPC‏ publicAlerts.lookup.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل 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

إزاحة المنطقة الزمنية عن التوقيت العالمي المنسّق (UTC) لموقع التنبيه يتم تنسيق القيمة كسلسلة تنتهي بالحرف "s"، مثلاً ‫"14400- ثانية" أي 4 ساعات قبل التوقيت العالمي المتفق عليه
startTime

string (Timestamp format)

وقت بدء الحدث

يستخدم المعيار RFC 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)

تمثّل هذه السمة وقت انتهاء صلاحية الحدث.

يستخدم المعيار RFC 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

تمثّل هذه السمة نوع حدث الطقس.

عمليات التعداد
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 حدث عاصفة شتوية

درجة الخطورة

الرمز الذي يشير إلى خطورة الحدث المعنيّ في رسالة التنبيه.

عمليات التعداد
SEVERITY_UNKNOWN لم يتم تحديد مستوى الخطورة.
EXTREME تشكّل الظروف في المنطقة خطرًا غير عادي على الحياة أو الممتلكات.
SEVERE تشكّل الظروف في المنطقة خطرًا كبيرًا على الحياة أو الممتلكات.
MODERATE تشكّل الظروف في المنطقة خطرًا محتملاً على الحياة أو الممتلكات.
MINOR تشكّل الظروف في المنطقة خطرًا بسيطًا على الحياة أو الممتلكات.

اليقين

الرمز الذي يشير إلى مدى صحة الحدث المحدّد في رسالة التنبيه.

عمليات التعداد
CERTAINTY_UNKNOWN لا يمكن تحديد مدى صحة المعلومات.
OBSERVED تم تحديد أنّها حدثت أو أنّها مستمرة.
VERY_LIKELY من المحتمل جدًا.
LIKELY محتمل (الاحتمال > %50 تقريبًا)
POSSIBLE ممكن ولكن ليس محتملاً (الاحتمالية أقل من أو تساوي %50 تقريبًا).
UNLIKELY غير محتمَل (الاحتمال ~ %0).

حاجة ماسة

الرمز الذي يشير إلى مدى إلحاح الحدث الرئيسي لرسالة التنبيه.

عمليات التعداد
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

تمثّل هذه السمة عنوان URL لموقع الجهة الحكومية على الويب.

الناشر

تمثّل هذه السمة ناشر التنبيه.

عمليات التعداد
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 المكسيك (CIRES)
NZ_GEONET نيوزيلندا، شبكة 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 الإدارة الوطنية للمحيطات والغلاف الجوي (NOAA) في الولايات المتحدة
WCATWC المركز الوطني للتحذير من التسونامي