- طلب HTTP
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات الأذونات
- PrecipitationSegment
- DominantPrecipitationType
- PrecipitationIntensity
- جرِّبه الآن
تعرض هذه الدالة أحداث التوقعات الآنية لهطول الأمطار على مستوى الدقيقة لمدة تصل إلى 6 ساعات.
طلب HTTP
GET https://weather.googleapis.com/v1/forecast/minutes:lookup
يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.
مَعلمات طلب البحث
| المعلمات | |
|---|---|
location |
الحقل مطلوب. الموقع الجغرافي الذي تريد الحصول على توقعات الطقس له كل دقيقة |
unitsSystem |
اختياريّ. نظام الوحدات المطلوب استخدامه لأحوال الطقس التي يتم عرضها وفي حال عدم توفيرها، ستكون أحوال الطقس التي يتم عرضها بالنظام المتري (القيمة التلقائية = METRIC). |
pageSize |
اختياريّ. الحد الأقصى لعدد سجلّات التوقّعات التي يتم عرضها في كل صفحة. |
pageToken |
اختياريّ. رمز مميّز للصفحة تم تلقّيه من طلب سابق ويُستخدَم لاسترداد الصفحة التالية. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
الاستجابة لطلب RPC minutes.lookup.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
|---|
{ "overallPredictionTimeframe": { object ( |
| الحقول | |
|---|---|
overallPredictionTimeframe |
الإطار الزمني العام للتوقّعات |
timeZone |
المنطقة الزمنية في الموقع الجغرافي المطلوب |
nextPageToken |
الرمز المميّز لاسترداد الصفحة التالية |
segments[] |
شرائح التوقّعات على مستوى الدقيقة |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/cloud-platform
PrecipitationSegment
تمثّل هذه السمة جزءًا من بيانات توقّعات هطول الأمطار.
| تمثيل JSON |
|---|
{ "timeFrame": { object ( |
| الحقول | |
|---|---|
timeFrame |
الإطار الزمني ذو الصلة بالشريحة |
type |
نوع هطول الأمطار |
probability |
احتمال هطول الأمطار تكون القيم بنسب مئوية تتراوح بين 0 و100. |
qpf |
توقّعات كمية هطول الأمطار |
snowfallAmount |
توقّعات كمية تساقط الثلوج |
intensity |
كثافة هطول الأمطار في الشريحة |
DominantPrecipitationType
نوع هطول الأمطار
| عمليات التعداد | |
|---|---|
DOMINANT_PRECIPITATION_TYPE_UNSPECIFIED |
نوع هطول غير محدّد |
NONE |
لا هطول للأمطار. |
RAIN |
مطر |
SNOW |
ثلوج |
HAIL |
تساقط بَرَد |
PrecipitationIntensity
كثافة هطول الأمطار في الشريحة
| عمليات التعداد | |
|---|---|
PRECIPITATION_INTENSITY_UNSPECIFIED |
شدة هطول الأمطار غير معروفة. |
NO_INTENSITY |
لا تتوفّر بيانات عن شدة هطول الأمطار. |
LIGHT |
هطول خفيف |
MODERATE |
هطول أمطار بمستوى جهد متوسط |
HEAVY |
هطول أمطار غزيرة |
MID_LIGHT |
هطول أمطار متوسطة إلى خفيفة |
MID_MODERATE |
كثافة هطول الأمطار متوسطة إلى معتدلة. |
MID_HEAVY |
هطول أمطار متوسطة إلى غزيرة |