HTTP Direct Data Request

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 {YYYY can only be the current year; i.e., 2023}

{3} stop date formatted as YYYY-MM-DDTHH:MM:SSZ {YYYY can only be the current year; i.e., 2023}

{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, TABS, TCOON, COMPS, LUMCON, WAVCIS, DISL, CenGOOS, Shell, NDBC, NOS, NERRS, SCCF RECON, COAPS, FWRI, ENP, Scripps, LOOP, FIT, Anadarko, Chevron, Total USA, BP, Kerr-McGee, BHP, Noble Energy, ENI, Petrobras, Talos, ATP, Mariner, Murphy, Amerada Hess, Freeport, Walter, Repsol, Marubeni, Exxon, Enven, Williams, Marathon, Apache, Helix, LLOG, Conoco, Cobalt, Deep Gulf, Statoil, Maersk, Stone, Oxy, CUBENet, Woodside, Beacon, CBI, Kosmos, PMEL

{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 August 01, 2022 (time: 00:00:00 UTC) to August 03, 2022 (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=2022-08-01T00:00:00Z&stop=2022-08-03T23:59:59Z&obs=water_temperature&source=All&fmt=csv&sortBy=dates&qc=on