Developers
DEVELOPER INFORMATION

Precipitation Service

ETI precipitation gauge at JHR in northwest Wyoming.

Synoptic’s Mesonet API Precipitation Service is a powerful and flexible tool, processing raw precipitation data from station networks and serving it in a uniform format through Mesonet API. Precipitation is reported from hundreds of networks with different reporting conventions and precipitation sensor types. For example, precipitation may be reported in 15 minute accumulations, hourly accumulations, accumulation since local midnight, or continuous accumulation over the calendar year or water year. Across our data providers, precipitation is reported in more than 20 different forms (see Station Variables that include precip).

The large variety of precipitation measurement types (i.e. precipitation variables) makes it challenging for users to compare precipitation amounts over geographic areas with stations reporting a variety of variable types. Finding precipitation totals for a defined time period and collection of stations requires tailoring the precipitation processing to each station’s specific variable type, and accounting for events such as station resets. Synoptic’s Precipitation Service eliminates these variable-specific complications for the user, providing access to derived precipitation data that can be easily integrated into downstream applications.

Real-time precipitation data is processed and stored in Synoptic’s derived precipitation database. We have dedicated years to developing robust QC methods to remove outlier data, such as physically implausible dips and spikes. Through the Precipitation Service, we enable flexible retrieval of both current and historical data over time periods and intervals defined by the user. The result is access to real-time, quality-controlled, and consistently formatted precipitation data reported by more than 60,000 stations, all from a single API retrieval endpoint.

Basic Precipitation

Basic derived precipitation is provided for single or multiple stations via the Time Series Service by adding precip=1 to the request. This will replace any raw precipitation variables with two derived variables, precip_intervals and precip_accumulated. precip_intervals represent precipitation received in the intervals between consecutive observations. precip_accumulated is the cumulative sum of the interval values for the requested time period. This essentially standardizes the returned precipitation data for any network and request period. Basic precipitation is also available in csv output for individual stations. Note that basic precipitation intervals and accumulations are only provided at the reporting frequency of the station. For custom user-defined time intervals and totals, the advanced precipitation features must be used.

Advanced Precipitation

Advanced derived precipitation is provided with the Precipitation Service. This service allows for user-defined “modes” (pmode) including:

Requests can include multiple station networks over broad geographic regions and time periods, where all results are returned with uniform format. The Precipitation Service accepts the same station selection parameters available to other web services, such as state, county, network, radius and bbox. Example request patterns may include: