Data Grapher  •  Current Conditions  •  API

Buoy Data API BETA

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
Examples
URL Paramaters


GET Request

To gather data a GET request will need to be made to the following URL with the desired URL paramaters 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 Paramaters

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 Temperature °F (above surface)
  • tp001 - Water Temperature °F (2m)
  • tp002 - Water Temperature °F (4m)
  • tp003 - Water Temperature °F (6m)
  • tp004 - Water Temperature °F (7m)
  • tp005 - Water Temperature °F (9m)
  • tp006 - Water Temperature °F (11m)
  • rh1 - Relative Humidity % (above surface)
  • baro1 - Relative Barometric Pressure inHg (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)
  • phyco001 - Phycocyanin Cells/mL (2m)
  • phyco002 - Phycocyanin Cells/mL (8m)
  • cdom001 - CDOM µg/L (2m)
  • ph001 - pH (2m)
  • ph002 - pH (5m)
  • ph003 - pH (8m)
  • ph004 - pH (11m)
  • turb001 - Turbidity NTU (2m)
  • turb002 - Turbidity NTU (5m)
  • turb003 - Turbidity NTU (8m)
  • turb004 - Turbidity NTU (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)

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 Temperature °F (above surface)
  • tp001 - Water Temperature °F (2m)
  • tp002 - Water Temperature °F (4m)
  • tp003 - Water Temperature °F (6m)
  • tp004 - Water Temperature °F (7m)
  • tp005 - Water Temperature °F (9m)
  • tp006 - Water Temperature °F (11m)
  • rh1 - Relative Humidity % (above surface)
  • baro1 - Relative Barometric Pressure inHg (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)
  • phyco001 - Phycocyanin Cells/mL (2m)
  • phyco002 - Phycocyanin Cells/mL (8m)
  • cdom001 - CDOM µg/L (2m)
  • ph001 - pH (2m)
  • ph002 - pH (5m)
  • ph003 - pH (8m)
  • ph004 - pH (11m)
  • turb001 - Turbidity NTU (2m)
  • turb002 - Turbidity NTU (5m)
  • turb003 - Turbidity NTU (8m)
  • turb004 - Turbidity NTU (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)

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 mathamatical calulcation 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