TimeseriesTableForecast
Packaged hourly matrix with toolbar.
Wraps TimeseriesModelsProvider and TimeseriesTableProvider, then optional Toolbar, Builder + Table. lat and lon are required. Rows load from GET /api/platform/timeseries-point-forecast (or marine-timeseries-point-forecast when domain is marine) unless you pass tables or getTables. All config groups share one time axis. Applies ip-platform for you.
import { TimeseriesTableForecast } from '@infoplaza/platform/timeseries-table'- Do not pass a models array. The catalog is loaded from GET /api/platform/timeseries-models (or marine-timeseries-models when domain is marine).
- domain defaults to land. Set domain="marine" on Forecast or TimeseriesModelsProvider.
- Builder renders one unified table, not one table per group.
- showToolbar defaults to true. showFooter is off for now (group-visibility pills are disabled).
- This package is a sibling of @infoplaza/platform/timeseries. The original table is unchanged.
Required props
| Prop | Type | Default | Description |
|---|---|---|---|
| lat | number | — | Latitude of the forecast point. |
| lon | number | — | Longitude of the forecast point. |
Optional props
| Prop | Type | Default | Description |
|---|---|---|---|
| basePath | string | '/api/platform' | Auth handler mount path. |
| domain | 'land' | 'marine' | 'land' | Which PlatformAuth proxy to use. land hits timeseries-models and timeseries-point-forecast; marine hits the marine-timeseries-* routes. |
| model / defaultModel / onModelChange | string | — | Preferred catalog slug. model without onModelChange (or defaultModel) is the initial selection; model + onModelChange is controlled. If the slug is not in the fetched catalog, the first model is used unless onModelFallback picks one. |
| onModelFallback | (args: TimeseriesModelFallbackArgs) => string | — | Optional. Called with { models, model, lat, lon } when the requested slug is missing from the location-filtered catalog or is marked available: false. Return the slug to show. Unknown, empty or unchanged slugs are ignored and the built-in first-model fallback is used. Not called while the catalog loads. The fallback is not reported through onModelChange; the requested model stays as passed. |
| showToolbar | boolean | true | Render the model / run pill toolbar. |
| showFooter | boolean | false | Group-visibility pills. Off for now; leave false. |
| elementGroups | TimeseriesTableElementGroup[] | DEFAULT_LAND_TIMESERIES_TABLE_GROUPS when domain is land, DEFAULT_MARINE_TIMESERIES_TABLE_GROUPS when marine | Table config. Item view is VALUE, DIRECTION, or PRECIPITATION_TYPE. A defined array replaces domain defaults (it does not merge). |
| visibleGroups / defaultVisibleGroups / onVisibleGroupsChange | string[] | — | Which group keys are shown. Defaults to every group. |
| tables | TimeseriesTableSnapshot[] | — | Host-owned snapshots. When defined, skips the point-forecast fetch. |
| getTables | (options) => TimeseriesTableSnapshot[] | — | Sync override when tables is omitted. Receives model, run, models, elementGroups, visibleGroups, locale, timezone. |
| locale | string | 'en' | Date headers: 'en' | 'nl' | 'de' | 'it' | 'es' | 'fr'. |
| thresholds | TimeseriesTableThresholds | null | — | Optional. conditions + ignored_hours. VALUE cells paint yellow / orange / red when matching groups fire at that hour. |
| className | string | — | Extra class on the root wrapper. |
| timestamp | number | null | — | Selected unix timestamp in seconds. The host owns this value. That hour column stays marked. Omit it and the current hour stays highlighted. |
| onTimestampChange | (timestamp: number) => void | — | Called with the clicked hour in unix seconds. A drag-to-scroll does not fire it. Clicks in the frozen label columns do not fire it. |
| hoverTimestamp | number | null | — | Preview column in unix seconds. Highlights that column when the pointer is off the table. Does not seek timestamp. Pass a chart onHover timestamp here to sync the two. |
| onHover | (hover: TimeseriesTableHover | null) => void | — | Mouse sample for the hovered hour: { timestamp, values }. timestamp is unix seconds. values maps every row slug to a number or null. Null when the pointer leaves the hour columns. Does not fire for touch, drag-to-scroll, or an external hoverTimestamp. |
| pinnedTimestamp | number | null | — | Pinned column in unix seconds. Outlines that hour column with a "Pinned" badge. Independent of timestamp and hoverTimestamp. Omit it and nothing is pinned. |
Example
<TimeseriesTableForecast
lat={52.3676}
lon={4.9041}
model="gfs"
locale="en"
/>