Method: gauges.queryGaugeForecasts

توقّعات مقياس طلب البحث

طلب HTTP

GET https://floodforecasting.googleapis.com/v1/gauges:queryGaugeForecasts

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

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

المعلمات
gaugeIds[]

string

مطلوب. قائمة بمعرّفات المقاييس يقتصر حجم القائمة المتوافقة على 500. إذا تم تقديم قائمة أكبر من 500 عنصر، سيتعذّر ذلك وسيظهر الخطأ INVALID_REQUEST.
issuedTimeStart

string

اختياريّ. تمثّل هذه السمة أبكر وقت تم فيه إصدار توقعات الطقس كسلسلة (ISO 8601)، مثلاً "2023-06-17T10:34:00Z" أو سلسلة تاريخ، مثلاً "2023-10-13". لا يمكن أن يكون وقت البدء قبل "2023-10-01". القيمة التلقائية هي قبل أسبوع واحد.
issuedTimeEnd

string

اختياريّ. تمثّل هذه السمة آخر وقت تم فيه إصدار التوقّعات كسلسلة (ISO 8601)، مثلاً "2023-06-17T10:34:00Z" أو سلسلة تاريخ، مثلاً "2023-10-13". القيمة التلقائية هي "الآن".

نص الطلب

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

نص الاستجابة

استجابة gauges.queryGaugeForecasts

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

تمثيل JSON 
{
  "forecasts": {
    string: {
      object (ForecastSet)
    },
    ...
  }
}
الحقول
forecasts

map (key: string, value: object (ForecastSet))

خريطة من معرّف المقياس إلى مجموعة التوقعات

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }

ForecastSet

مجموعة من التوقعات لمقياس.

تمثيل JSON 
{
  "forecasts": [
    {
      object (Forecast)
    }
  ]
}
الحقول
forecasts[]

object (Forecast)

التوقّعات

التوقعات

توقّعات مقياس واحد لعدّة فترات زمنية متقدّمة على سبيل المثال، يمكن أن يكون وقت الإصدار في التوقّعات هو الساعة 5 مساءً، وأن تتضمّن التوقّعات الساعة 6 مساءً و7 مساءً و8 مساءً وما إلى ذلك.

ملاحظة: يمكن أن تكون بعض نطاقات التوقعات أقدم من وقت الإصدار. قد يحدث ذلك بسبب تأخُّر في بيانات الإدخال للنموذج، على سبيل المثال. في المثال أعلاه، قد يكون وقت حدوث المشكلة هو الساعة 5 مساءً، وتكون نطاقات التوقعات للساعة 4 مساءً و5 مساءً و6 مساءً وما إلى ذلك.

ملاحظة: تختلف النطاقات في طولها والمسافة بينها. في ما يلي بعض الأمثلة على النطاقات المحتملة:

  1. [5pm - 5pm], [6pm - 6pm], [7pm - 7pm]

  2. [من 1 مارس الساعة 12 صباحًا إلى 2 مارس الساعة 12 صباحًا]، [من 2 مارس الساعة 12 صباحًا إلى 3 مارس الساعة 12 صباحًا]، [من 3 مارس الساعة 12 صباحًا إلى 4 مارس الساعة 12 صباحًا]

تمثيل JSON 
{
  "forecastRanges": [
    {
      object (ForecastTimedValue)
    }
  ],
  "gaugeId": string,
  "issuedTime": string
}
الحقول
forecastRanges[]

object (ForecastTimedValue)

تتألف التوقعات من عدة "نطاقات توقعات"، وهي عبارة عن قيم توقعات مختلفة تتعلق بنطاقات زمنية مختلفة. عندما يتساوى بداية ونهاية النطاق، يعني ذلك أنّه لحظة زمنية.
gaugeId

string

معرّف المقياس الذي تتعلّق به هذه التوقّعات.
issuedTime

string

تمثّل هذه السمة وقت إصدار التوقّعات (ISO 8601)، مثلاً "2023-06-17T10:34:00Z". يشير وقت الإصدار إلى الوقت الذي تم فيه إنشاء التوقّع.

ForecastTimedValue

قيمة توقّعية مرتبطة بنطاق زمني يتم تحديد وحداته من خلال GaugeModel المرتبط به. إذا كان وقت البدء ووقت الانتهاء متساويَين، يعني ذلك أنّه وقت فوري.

تمثيل JSON 
{
  "value": number,
  "forecastStartTime": string,
  "forecastEndTime": string
}
الحقول
value

number

تمثّل هذه السمة قيمة التوقّع.
forecastStartTime

string

بداية الفاصل الزمني
forecastEndTime

string

نهاية الفاصل الزمني