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:

• Amerada Hess
• Anadarko
• Apache
• ATP
• BHP
• BP
• Chevron
• COAPS
• Cobalt
• COMPS
• Conoco
• CUBENet
• Deep Gulf
• DISL
• ENI
• ENP
• Enven
• Equinor
• Exxon
• FIT
• FWRI
• Freeport
• Helix
• Kerr-McGee
• LLOG
• LOOP
• LUMCON
• Maersk
• Marathon
• Mariner
• Marubeni
• Murphy
• NDBC
• NERRS
• Noble Energy
• NOS
• Oxy
• Petrobras
• Repsol
• SCCF RECON
• Scripps
• Shell
• Statoil
• Stone
• TABS
• Talos
• TCOON
• Total USA
• Walter
• WAVCIS
• Williams
• Woodside

{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