Method: gauges.queryGaugeForecasts

پیش بینی سنج پرس و جو

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای پرس و جو

پارامترها
gaugeIds[]

string

مورد نیاز. لیستی از شناسه های سنج. اندازه لیست پشتیبانی شده به 500 محدود شده است. اگر لیستی بزرگتر از 500 ارائه شود، با خطای INVALID_REQUEST ناموفق است.

issuedTimeStart

string

اختیاری. اولین پیش‌بینی زمان صادر شده به‌عنوان رشته (ISO 8601)، به‌عنوان مثال «2023-06-17T10:34:00Z» یا یک رشته تاریخ مانند «2023-10-13». زمان شروع نمی تواند زودتر از "01-10-2023" باشد. پیش فرض یک هفته پیش است.

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 بعدازظهر باشد و محدوده پیش بینی برای 16، 17، 18 و غیره باشد.

توجه: دامنه ها از نظر طول و فاصله بین آنها متفاوت است. چند نمونه از محدوده های ممکن عبارتند از:

  1. [5 بعدازظهر - 5 بعد از ظهر]، [6 بعد از ظهر تا 6 بعد از ظهر]، [7 بعد از ظهر تا 7 بعد از ظهر]

  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

پایان فاصله.