Method: gauges.queryGaugeForecasts

게이지 예측을 쿼리합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

쿼리 매개변수

매개변수
gaugeIds[]

string

필수입니다. 게이지 ID 목록입니다. 지원되는 목록 크기는 500으로 제한됩니다. 500보다 큰 목록이 제공되면 INVALID_REQUEST 오류와 함께 실패합니다.
issuedTimeStart

string

선택사항입니다. 가장 빠른 예측 발급 시간(문자열, ISO 8601)(예: '2023-06-17T10:34:00Z') 또는 날짜 문자열(예: '2023-10-13')입니다. 시작 시간은 '2023-10-01'보다 이전일 수 없습니다. 기본값은 1주일 전입니다.
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))

게이지 ID에서 예측 세트로의 맵입니다.

"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. [오후 5시~오후 5시], [오후 6시~오후 6시], [오후 7시~오후 7시]

  2. [3월 1일 오전 12시~3월 2일 오전 12시], [3월 2일 오전 12시~3월 3일 오전 12시], [3월 3일 오전 12시~3월 4일 오전 12시]

JSON 표현 
{
  "forecastRanges": [
    {
      object (ForecastTimedValue)
    }
  ],
  "gaugeId": string,
  "issuedTime": string
}
필드
forecastRanges[]

object (ForecastTimedValue)

예측은 여러 '예측 범위'로 구성되며, 이는 서로 다른 시간 범위와 관련된 서로 다른 예측 값입니다. 범위의 시작과 끝이 같으면 시간 순간을 의미합니다.
gaugeId

string

이 예측의 게이지 ID입니다.
issuedTime

string

예보가 발표된 시간입니다 (ISO 8601). 예를 들어 '2023-06-17T10:34:00Z'입니다. 발급 시간은 예측이 생성된 시간입니다.

ForecastTimedValue

시간 범위와 관련된 예측 값입니다. 단위는 연결된 GaugeModel에 의해 정의됩니다. 시작과 끝이 같으면 시간 순간을 의미합니다.

JSON 표현 
{
  "value": number,
  "forecastStartTime": string,
  "forecastEndTime": string
}
필드
value

number

예측 값입니다.
forecastStartTime

string

간격의 시작입니다.
forecastEndTime

string

간격의 끝입니다.