extremes

io.weathersight/weathersight · Verify this server

Returns extreme value analysis (return periods) for a specified location and metric. <br><b>When to use:</b> Quantify the statistical rarity of a record or near-record value. Typically called after other APIs establish that an observation is anomalous. <br><b>Performance:</b> Computed on demand; moderate speed. <br><b>Prerequisites:</b> Use /location to obtain a locid first. Prefer level='area' over 'city' for better recall and longer period of record. <br><b>Investigate:</b> Use after /recentextremes or /anom establishes a high value; provides the return-period framing ('a once-in-50-year event'). <br><b>Augment:</b> Provides the statistical rarity framing needed for record-event stories. Try both src_types 'Obs' and 'ERA5' for non-US locations to account for discontinuous station records. Returns: locid, period, months_covered, window_size, N, coverage_pct, results, result.metric, result.value, result.return_period.