As of January 2020 GLTG has 32,122,836 datapoints.
WARNING Please don't fetch all of them at once.
Step 1: Create an Account
- go to: https://greatlakestogulf.org/geostreams
- Click "Sign Up"
- Fill out form
- Ignore check email
- You're done
Step 2: Acquire Data from API
You can acquire the data from API by using curl command or python library (we provide the example in jupyter notebook in attached)
Using CURL
Get all Sensors in JSON format
Currently, pulling sensors does not require authentication.
| Inputs | Output type | Output Example |
|---|---|---|
| url | JSON |
Get all Sensors
curl -X GET --compressed https://greatlakestogulf.org/geostreams/api/sensors
Authenticate
| Inputs | Output | Details |
|---|---|---|
| X-Auth-Token | Use the token for fetching datapoints |
Authenticate
curl -X POST -H 'Content-Type: application/json' -d '{"password": "****", "identifier": "email"}' --compressed -i https://greatlakestogulf.org/geostreams/api/authenticate
Get all Datapoints for Single Sensor
We request that a user not try to pull all datapoints concurrently. It is preferred that datapoints be pulled in series by sensor id.
| Inputs | Output Type | Details |
|---|---|---|
| JSON | Use X-Auth-Token from authentication |
Get Datapoints for Single Sensor
curl -X GET -H 'Content-Encoding: application/json' -H 'x-auth-token:token' --compressed 'https://greatlakestogulf.org/geostreams/api/datapoints?sensor_id=22&since=2018-06-01'
Using Python Library (pyGeotemporal)
<< insert code example here>>
<< need to have instruction how to get pyGeotemporal >>
Jupyter Notebook
Jupyter notebook example can be download here geostreams_jupyter.ipynb