We have two main ways to access GLOS Seagull platform data via API or API-like service:

 

Seagull ERDDAP – https://seagull-erddap.glos.org/erddap/index.html

 

• Look for your dataset on Seagull either through the map, clicking on the platform, and clicking on Dive Deeper in the bottom left of the panel that’s revealed.
• OR click on Console in the upper left of Seagull, and click on the Platform Name from which you want API access to.
• Look in the URL bar. For instance 45029 at Port Sheldon: https://seagull.glos.org/data-console/3
• The number at the end of the URL is what you’ll use to find the data in ERDDAP. From the front page of Seagull ERDDAP, search in the upper right corner for “obs_[number]” or per the example, “obs_3”
• Find the platform you want in the list of results.
• Feel free to explore the links within the target row, but for the purposes here, click on the data link in the target row.
• You’ll find a form to fill out for the platform’s parameters you want. At the bottom of the form there’s a drop down from which you can select the output you desire.
• You can then click “Just generate the URL” for the URL you’d use to download the data in your format. (To better understand the format, click Submit and view the downloaded data.)
• From there, you can modify the URL for time range, for example, acting as an API to the data you want.

 

Seagull API – https://seagull-api.glos.org/docs

For a platform like Port Sheldon, you’ll want to use the ‘obs_dataset_id’ as you did for ERDDAP to navigate. In this example, it’s 3. This won’t be an exhaustive guide on the API, but it should be enough to get started. Under Observation Datasets:

 

• /api/v1/obs-dataset-summaries provides summary information on a platform, including its obs_dataset_id, associated platform_id – which is how its parameters are associated – and more
• Use the platform_id found there to get the platform’s associated parameters at /api/v1/parameters. Filter by platform_id
• You may also want to find the parameter_id simply by clicking around the Seagull interface for that dataset. For example, if you wanted to get Port Sheldon’s Air Temperature via API, you could go to Port Sheldon’s data console page, click on Air Temperature, and then see the URL: https://seagull.glos.org/data-console/3/parameter/179. Port Sheldon Air Temperature’s parameter_id is 179
• /api/v1/obs-datasets provides similar output to the summaries, without other information.
• /api/v1/obs-datasets.geojson provides a GeoJSON layer with the locations of available platforms on Seagull.
• /api/v1/obs-datasets/{obsDatasetId}/metadata provides metadata for a platform. For example: /api/v1/obs-datasets/3/metadata
• /api/v1/obs provides observations for a platform. For example: https://seagull-api.glos.org/api/v1/obs?startDate=2022-08-10&obsDatasetId=3. The result is a massive JSON object shaped like:

[ {
  "obs_dataset_id": 3,
  "parameters": [
    {
      "observations": [
        {
          "latitude": 42.899572,
          "longitude": -86.272291,
          "timestamp": "2022-08-12T18:40:00+00:00",
          "value": 3
        },...
      ],
      "parameter_id": 178
},...]}] 

 

where the information the parameter_id can be found in /api/v1/parameters

 

• Another endpoint for observations is /api/v2/obs. The output data is presented like columns. ‘timestamps’ form one array in the JSON output (in seconds since Unix Epoch – January 1, 1970), and ‘parameter_obs’ form a dictionary, where you’ll want ‘values’.'[parameter_id]’
• Lastly, if you would like the latest data points for platforms, use /api/v1/obs-latest. With that you can filter to your desired “obs_dataset_id”: …, “parameter_id”: …, “observations”, and then “timestamp” + “value”. This endpoint is updated roughly every 10 minutes.

 

Please feel free to reach out with any questions to support@glos.org.

No, access to Great Lakes data and information is free through GLOS.

There could be circumstances where an organization has customized data management needs, atypical data access requirements, or other features requiring engineering development work by GLOS. In those situations, GLOS may charge a cost-recovery fee to help offset expenses to support these requirements.

Access to the new information technology platform is made possible through funding from the Integrated Ocean Observing System (IOOS) program and other donor funds.

Currently, most of the buoys in our network use cellular telemetry, while a few use satellite telemetry. However, the path data takes from sensor to our servers really varies. Many buoys send data directly from their datalogger to our server, while others have an in-between server that translates the data and sends it to us.

On our current systems, we ingest the data from the buoys through FTP. Each data provider has their own FTP account that they can use to send the data in a GLOS-required XML format.

However, for Seagull, we developed a completely new architecture to allow the data providers to send data to us using other secure protocols like HTTPs in flexible formats like JSON. Though not preferable, we will be also support our current FTP/XML protocol in 2022, just in case the data providers are unable to send data to us through a secure protocol.

If you have flexibility to select a data logger, we recommend selecting one that is capable of transmitting data over secure protocols like HTTPs. If not, there is also an option to send data, not directly from the datalogger but from a local server, if that is more practical for your system.

We will decommission our legacy apps as core functionality is built into Seagull or when that app is no longer needed by the observing community.

After Seagull launched on April 28, 2022, in late April or Early May, we shut down GL Buoys, the HABs Portal, and our THREDDS server.

Please reach out to us with any concerns or questions.