Document current conditions consensus selection
All checks were successful
ci/woodpecker/push/build-image Pipeline was successful
All checks were successful
ci/woodpecker/push/build-image Pipeline was successful
This commit is contained in:
@@ -162,8 +162,10 @@ GET /observations?units=us&precision=1
|
||||
GET /conditions/current
|
||||
```
|
||||
|
||||
Returns current conditions aggregated from recent `observations` rows. The
|
||||
implemented observation window is 30 minutes.
|
||||
Returns current conditions from recent `observations` rows. Numeric fields are
|
||||
aggregated over the implemented 30-minute observation window. `conditionCode`
|
||||
is selected from the latest observation per source in that window by
|
||||
source-balanced WMO family consensus.
|
||||
|
||||
Query parameters: `format`, `units`, `precision`.
|
||||
|
||||
@@ -171,6 +173,7 @@ Common `data` fields:
|
||||
|
||||
| Field | Type | Notes |
|
||||
| --- | --- | --- |
|
||||
| `conditionCode` | integer | WMO weather code selected by source-balanced family consensus |
|
||||
| `conditionText` | string | optional text derived from WMO code and day/night flag |
|
||||
| `isDay` | boolean | optional |
|
||||
| `relativeHumidityPercent` | number | optional |
|
||||
|
||||
@@ -57,8 +57,10 @@ Latest parent resources use these ordering rules:
|
||||
story_order ASC, story_index ASC`.
|
||||
- convective outlook runs: `as_of DESC, event_emitted_at DESC`.
|
||||
|
||||
Current conditions aggregate `observations` rows where `observed_at` is inside
|
||||
the application-provided observation window.
|
||||
Current conditions aggregate numeric values from `observations` rows where
|
||||
`observed_at` is inside the application-provided observation window. They also
|
||||
use the latest row per `event_source` in that window to select `condition_code`
|
||||
by source-balanced WMO family consensus.
|
||||
|
||||
## Child Ordering
|
||||
|
||||
@@ -79,15 +81,16 @@ The repository reads only these columns.
|
||||
|
||||
### `observations`
|
||||
|
||||
`event_id`, `station_id`, `station_name`, `observed_at`, `condition_code`,
|
||||
`is_day`, `text_description`, `temperature_c`, `dewpoint_c`,
|
||||
`event_id`, `event_source`, `station_id`, `station_name`, `observed_at`,
|
||||
`condition_code`, `is_day`, `text_description`, `temperature_c`, `dewpoint_c`,
|
||||
`wind_direction_degrees`, `wind_speed_kmh`, `wind_gust_kmh`,
|
||||
`barometric_pressure_pa`, `visibility_meters`, `relative_humidity_percent`,
|
||||
`apparent_temperature_c`, and `event_emitted_at`.
|
||||
|
||||
Current conditions additionally aggregate recent `observations` values for
|
||||
Current conditions additionally read recent `observations` values for
|
||||
temperature, apparent temperature, dewpoint, humidity, wind speed, wind
|
||||
direction, condition code, and latest `is_day`.
|
||||
direction, latest `is_day`, and latest condition-code candidates per
|
||||
`event_source`.
|
||||
|
||||
### `observation_present_weather`
|
||||
|
||||
|
||||
@@ -76,8 +76,9 @@ successful responses with `data: null`.
|
||||
|
||||
- `LatestObservation`: latest row from `observations`, then present-weather
|
||||
rows from `observation_present_weather`.
|
||||
- `CurrentConditions`: aggregates recent rows from `observations` using the
|
||||
application-provided observation window.
|
||||
- `CurrentConditions`: reads an aggregate row from recent `observations` using
|
||||
the application-provided observation window, then reads the latest
|
||||
condition-code candidate per `event_source` in the same window.
|
||||
- `LatestAlertRun`: latest row from `alert_runs`, then child `alerts` and
|
||||
`alert_references`. This is the latest stored alert snapshot. The repository
|
||||
maps both `ends` and `expires`; active-time filtering is performed by the
|
||||
|
||||
Reference in New Issue
Block a user