Data Grapher   Current Conditions   API   Disclaimer

API

The buoy data API allows developers and statisticians to generate images, data sets, and other useful points of interest through website GET requests to our servers which house historical buoy data.

GET Request

To gather data a GET request will need to be made to the following URL with the desired URL parameters from below:

http://www.gvsu.edu/wri/buoy/data-generate.htm

Examples

Air Temperature compared with Water Temperature at 2m and 4m every Thursday for July 2011 with the missing data points hidden:
http://www.gvsu.edu/wri/buoy/data-generate.htm?x=date&y=atmp1,tp001,tp002&date=7/7/11,7/14/11,7/21/11,7/28/11&concentration=1&disjoined=0
html preview

Chlorophyll μg/L (2m) compared with Chlorophyll μg/L (8m) for all dates between 12:00pm and 1:00pm, displayed on a scatter plot:
http://www.gvsu.edu/wri/buoy/data-generate.htm?x=clcon001&y=clcon003&time=12:00&graph=scatter&concentration=1
html preview

URL Parameters

Attribute Req/Opt Default Description
x Optional date

A single x value may be passed to the API.

Supported values are:

  • date - Date
  • julian - Julian Day
  • yearday - Day of Year
  • yearweek - Week of Year
  • yearmonth - Month of Year
  • weekday - Day of Week
  • dayhour - Hour of Day
  • atmp1 - Air Temp °F (above surface)
  • tp001 - Water Temp °F (2m)
  • tp002 - Water Temp °F (5m)
  • tp003 - Water Temp °F (8m)
  • tp004 - Water Temp °F (11m)
  • tp005 - Water Temp °F (9m)
  • tp006 - Water Temp °F (11m)
  • rh1 - Relative Humidity % (above surface)
  • baro1 - Relative Barometric Pressure in Hg (above surface)
  • wspd1 - Wind Speed knots (above surface)
  • gust1 - Wind Gust knots (above surface)
  • wdir1 - Wind Direction degrees (above surface)
  • raincumulative - Rain, Cumulative inches (above surface)
  • raincurrent - Rain, Currently inches (above surface)
  • par001 - PAR (1m)
  • nit001 - Nitrate mg/L (2m)
  • spcond001 - Specific Conductivity µs/cm (2m)
  • spcond002 - Specific Conductivity µs/cm (5m)
  • spcond003 - Specific Conductivity µs/cm (8m)
  • spcond004 - Specific Conductivity µs/cm (11m)
  • clcon001 - Chlorophyll µg/L (2m)
  • clcon002 - Chlorophyll µg/L (5m)
  • clcon003 - Chlorophyll µg/L (8m)
  • clcon004 - Chlorophyll µg/L (11m)
  • phyco001 - Phycocyanin Cells/L (2m)
  • phyco002 - Phycocyanin Cells/L (5m)
  • phyco003 - Phycocyanin Cells/L (8m)
  • phyco004 - Phycocyanin Cells/L (11m)
  • cdom001 - CDOM µg/L (2m)
  • ph001 - pH (2m)
  • ph002 - pH (5m)
  • ph003 - pH (8m)
  • ph004 - pH (11m)
  • o2perc001 - Dissolved Oxygen Saturation % (2m)
  • o2perc002 - Dissolved Oxygen Saturation % (5m)
  • o2perc003 - Dissolved Oxygen Saturation % (8m)
  • o2perc004 - Dissolved Oxygen Saturation % (11m)
  • odo001 - Dissolved Oxygen mg/L (2m)
  • odo002 - Dissolved Oxygen mg/L (5m)
  • odo003 - Dissolved Oxygen mg/L (8m)
  • odo004 - Dissolved Oxygen mg/L (11m)
  • sp001 - Phycocyanin RFU (2m)
  • sp002 - Phycocyanin RFU (5m)
  • sp003 - Phycocyanin RFU (8m)
  • sp004 - Phycocyanin RFU (11m)
  • fm64k1 - Chlorophyll RFU (2m)
  • fm64k2 - Chlorophyll RFU (5m)
  • fm64k3 - Chlorophyll RFU (8m)
  • fm64k4 - Chlorophyll RFU (11m)

y Required

At least one y value must be passed to the API. Multiple y values can be separated by a comma.

Supported values are:

  • atmp1 - Air Temp °F (above surface)
  • atmp1min - Minimum Air Temperature (Long term since 2011) °F (above surface)
  • tp001 - Water Temp °F (2m)
  • atmp1max - Maximum Air Temperature (Long term since 2011) °F (above surface)
  • tp002 - Water Temp °F (5m)
  • tp003 - Water Temp °F (8m)
  • tp004 - Water Temp °F (11m)
  • tp005 - Water Temp °F (9m)
  • tp006 - Water Temp °F (11m)
  • rh1 - Relative Humidity % (above surface)
  • baro1 - Relative Barometric Pressure in Hg (above surface)
  • wspd1 - Wind Speed knots (above surface)
  • gust1 - Wind Gust knots (above surface)
  • wdir1 - Wind Direction degrees (above surface)
  • raincumulative - Rain, Cumulative inches (above surface)
  • raincurrent - Rain, Currently inches (above surface)
  • par001 - PAR (1m)
  • nit001 - Nitrate mg/L (2m)
  • spcond001 - Specific Conductivity µs/cm (2m)
  • spcond002 - Specific Conductivity µs/cm (5m)
  • spcond003 - Specific Conductivity µs/cm (8m)
  • spcond004 - Specific Conductivity µs/cm (11m)
  • clcon001 - Chlorophyll µg/L (2m)
  • clcon002 - Chlorophyll µg/L (5m)
  • clcon003 - Chlorophyll µg/L (8m)
  • clcon004 - Chlorophyll µg/L (11m)
  • phyco001 - Phycocyanin Cells/L (2m)
  • phyco002 - Phycocyanin Cells/L (5m)
  • phyco003 - Phycocyanin Cells/L (8m)
  • phyco004 - Phycocyanin Cells/L (11m)
  • cdom001 - CDOM µg/L (2m)
  • ph001 - pH (2m)
  • ph002 - pH (5m)
  • ph003 - pH (8m)
  • ph004 - pH (11m)
  • o2perc001 - Dissolved Oxygen Saturation % (2m)
  • o2perc002 - Dissolved Oxygen Saturation % (5m)
  • o2perc003 - Dissolved Oxygen Saturation % (8m)
  • o2perc004 - Dissolved Oxygen Saturation % (11m)
  • odo001 - Dissolved Oxygen mg/L (2m)
  • odo002 - Dissolved Oxygen mg/L (5m)
  • odo003 - Dissolved Oxygen mg/L (8m)
  • odo004 - Dissolved Oxygen mg/L (11m)
  • battvolt001 - Battery Voltage volts (above surface)
  • sp001 - Phycocyanin RFU (2m)
  • sp002 - Phycocyanin RFU (5m)
  • sp003 - Phycocyanin RFU (8m)
  • sp004 - Phycocyanin RFU (11m)
  • fm64k1 - Chlorophyll RFU (2m)
  • fm64k2 - Chlorophyll RFU (5m)
  • fm64k3 - Chlorophyll RFU (8m)
  • fm64k4 - Chlorophyll RFU (11m)

date Optional

Date values must be in the format MM/DD/YYYY or M/D/YY and can be either ranges separated by hyphens, individual dates separated by commas, or any combination of the two. If no value is provided then all dates are considered.

Valid examples:

  • 10/31/11
  • 6/1/11,7/1/2011,8/1/2011
  • 7/1/11-7/8/11
  • 7/15/11-7/20/11,8/15/2011,9/15/2011
time Optional

Time values must be in the 24-hour format H:MM or HH:MM and can be either ranges separated by hyphens, individual times separated by commas, or any combination of the two. Times must also be divisible by 15 minutes (0:00, 0:15, 0:30, and 0:45). If no value is provided then all times are considered.

Valid examples:

  • 13:30
  • 14:00,15:00,16:00
  • 12:45-17:45
  • 7:30-8:30,9:00,10:00
graph Optional line

The type of graph to display. This attribute is only valid for format=html or format=image. If format=image and graph=column then graph=bar is instead used.

Supported values are:

  • line - Line Graph
  • scatter - Scatter Plot
  • column - Column Chart
  • bar - Bar Chart
  • area - Area Chart

format Optional html

The media type to be returned.

Supported values are:

  • html - Dynamic HTML
  • image - Image
  • xml - Extensible Markup Language (XML)
  • json - JavaScript Object Notation (JSON)
  • csv - Comma Separated Values (CSV)
  • tsv - Tab Separated Values (TSV)
  • xls - Microsoft Excel File Format (XLS)

disjoined Optional 1

A boolean variable rather or not to show missing data points for all y variables. This attribute is only valid for format=html.

Supported values are:

  • 1 - Show disjoined data
  • 0 - Exclude disjoined data

concentration Optional .05

A decimal number in the range .01-1.0 which represents the total amount of y plots per x variable. The closer to 1 this number is, the more points will be present in the output and the more accurate the graph.

calculation Optional avg

The mathematical calculation performed on the range points within an x variable's concentration.

Supported values are:

  • avg - Average
  • min - Minimum
  • max - Maximum

ymin Optional smallest y-value

A decimal number which represents the y variable's minimum line of the view window of the graph for format=html with yindividual=0 or format=image. If format=image is declared the ymin cannot be less than the minimum value of y or it will default to the default value.

ymax Optional largest y-value

A decimal number which represents the y variable's maximum line of the view window of the graph for format=html with yindividual=0 or format=image. If format=image is declared the ymax cannot be greater than the maximum value of y or it will default to the default value.

width Optional 600

An integer which represents the width of the graph for format=image.

height Optional 400

An integer which represents the height of the graph for format=image.

callback Optional

A function wrapper for JSONP support with format=json. The JSON object will be passed to the value of this attribute, interpreted as a javascript function, for cross domain support.

yindividual Optional 0

A boolean variable rather or not to show all y variables plotted on the same graph. This attribute is only valid for format=html.

Supported values are:

  • 1 - Show unique graph for each Y variable
  • 0 - Show all Y variables on the same graph

All dates and times are in Eastern Standard Time (EST), GMT-4:00


Report a problem with this page