| NOTICE! While the Direct Access option to extract data from the GCOOS Data Portal provides flexibility and allows the download of most recent data, it can be slow. Pre-generated CSV files are also available on the GCOOS WAF facility. We encourage users to use the GCOOS WAF to download monthly summaries. Data in netCDF4 data format is also available for data summarized by platforms or stations. Whenever possible, use the GCOOS ERDDAP data services for in situ data. |
The following is a form to interactively retrieve data using a form (see the tab on Data Call Instructions for more on this). To retrieve data, simply provide the inputs and click on the [Retrieve Data] button to generate the CSV file.
The following is the syntax for direct data retrieval from GCOOS repository.
Syntax:
https://data.gcoos.org/get_gcoos_data.php?bbox={1}&start={2}&stop={3}&obs={4}&source={5}&fmt={6}&sortBy={7}&qc={8}where:
{1} westlon,southlat,eastlon,northlat, where:
- westlon = longitude of western edge of bounding box expressed as a floating point number
- southlat = latitude of southern edge of bounding box expressed as a floating point number
- eastlon = longitude of eastern edge of bounding box expressed as a floating point number
- norhtlat = latitude of northern edge of bounding box expressed as a floating point number
{2} start date formatted as YYYY-MM-DDTHH:MM:SSZ [NOTE: Contact GCOOS (data@gcoos.org) for data older that 2020-01-01]
{3} stop date formatted as YYYY-MM-DDTHH:MM:SSZ
{4} observation to retrieve
- air_pressure: for barometric readings
- air_temperature: for air temperature readings
- chlorophyll: for chlorophyll readings
- current: for the ocean current data (speed, direction, meridional and zonal velocities)
- do: for disolved oxygen and concentrations
- relHumidity: relative humidity readings
- salinity: for salintity measurements
- turbidity: turbidity measurements
- water_level: water level measurements
- water_temperature: for water temperature data
- waves: wave readings
- winds: for winds (speed, direction and gust)
{5} data source which may either be: All, COMPS, TABS, DISL, WAVCIS, FWRI, TCOON, LUMCON, ADCP, NDBC, Scripps, CUBENet, NERRS, SCCF RECON, COAPS, NOS, ENP, LOOP, FIT, Shell
{6} desired output format. Only csv is currently supported.
{7} ascending sort order:
dates: sort the output by dates;
provider: sort the ouput by data provider, then dates; or
station: sort the output by the name of the station.{8} QC flag:
- on: QC flags will be exported with each data (1: good; 1: not evaluated, not available or unknown; 3: questionable; 4: bad; 9: missing data)
- not set: this is the default and no QC flag will be exported
Example:
To access the water temperature data in the repository for all the Gulf region for the period November 01, 2020 (time: 00:00:00 UTC) to November 15, 2020 (23:59:59 UTC) and sorted by dates, the call should be: https://data.gcoos.org/get_gcoos_data.php?bbox=-98.4,21.7,-80.5,31.0&start=2020-11-01T00:00:00Z&stop=2020-11-15T23:59:59Z&obs=water_temperature&source=All&fmt=csv&sortBy=dates&qc=on
