REST Resource: significantEvents

리소스: SignificantEvent

중요한 이벤트는 발생 가능성이 높고 영향이 큰 예측된 홍수 이벤트입니다. 품질이 검증된 게이지가 없는 장소를 다룹니다.

JSON 표현
{
  "eventInterval": {
    object (SignificantEventInterval)
  },
  "affectedCountryCodes": [
    string
  ],
  "affectedPopulation": integer,
  "areaKm2": number,
  "gaugeIds": [
    string
  ],
  "eventPolygonId": string,
  "eventTrackingIds": [
    string
  ]
}
필드
eventInterval

object (SignificantEventInterval)

이벤트의 시작 시간과 종료 시간입니다.

affectedCountryCodes[]

string

영향을 받는 국가(ISO 3166 alpha-2 형식) 이 목록에는 앞으로 이벤트의 영향을 받을 것으로 예측되는 모든 국가가 포함됩니다.

affectedPopulation

integer

영향을 받는 지역의 예상 인구입니다. 앞으로 이벤트의 영향을 받을 것으로 예측되는 인구를 나타냅니다.

areaKm2

number

이벤트의 면적(km^2) 앞으로 이벤트의 영향을 받을 것으로 예측되는 면적을 나타냅니다.

gaugeIds[]

string

이벤트의 게이지 목록입니다. 이 목록에는 앞으로 이벤트의 영향을 받을 것으로 예측되는 모든 게이지가 포함됩니다.

eventPolygonId

string

[serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] 에 전송하여 이벤트 영역의 다각형을 가져올 수 있는 다각형 ID입니다.

eventTrackingIds[]

string

시간 경과에 따라 이 이벤트를 추적하는 데 사용되는 ID입니다.
주의사항:
1. 병합된 이벤트에 여러 ID가 있을 수 있습니다.
2. 추적 ID가 이벤트 기간 내내 완전히 유지된다고 보장할 수는 없습니다. 최선을 다해 제공됩니다.
배경: 중요한 이벤트를 정의하기 위한 내부 점수 지정 및 임곗값 설정이 있습니다. 이벤트가 임곗값을 초과한 후 다시 임곗값 아래로 내려갔다가 다시 임곗값을 초과하면 두 번째로 임곗값을 초과할 때 새 추적 ID가 할당됩니다.

SignificantEventInterval

중요한 이벤트의 시간 간격입니다.

JSON 표현
{
  "startTime": string,

  // Union field predicted_end_time can be only one of the following:
  "endTime": string,
  "minimumEndTime": string
  // End of list of possible types for union field predicted_end_time.
}
필드
startTime

string

이벤트의 시작 시간입니다. ISO 8601 형식(예: '2025-03-17T10:34:00Z')

통합 필드 predicted_end_time. 이벤트의 종료 시간입니다. predicted_end_time은 다음 중 하나여야 합니다.
endTime

string

이벤트의 종료 시간입니다. ISO 8601 형식(예: '2025-03-25T10:34:00Z')

minimumEndTime

string

이벤트의 최소 종료 시간입니다. ISO 8601 형식(예: '2025-03-25T10:34:00Z') 이벤트가 모델의 리드 타임보다 오래 지속될 것으로 예측됩니다. 실제 종료 시간은 알 수 없지만 이벤트가 최소한 이 시간까지 지속될 것으로 예측됩니다.

메서드

최신 중요 이벤트를 검색합니다.