API Endpoints
1. Return List of Stations
Returns list of stations referred to as 'model' in other endpoints.
[
"gits",
"humboldt",
"petermann",
"tunu_n",
"swisscamp_10m_tower",
"swisscamp",
"crawfordpoint",
"nasa_u",
"summit",
"dye2",
"jar1",
"saddle",
"southdome",
"nasa_east",
"nasa_southeast",
"neem",
"east_grip"
]
2. Download NEAD
Click here for information about the NEAD format
URL template with time range:
https://www.envidat.ch/data-api//nead/model/timestamp_meaning/nodata/start/end/
Example with time range, timestamp meaning 'end' and no data value ''
(empty string):
URL template returning all records:
https://www.envidat.ch/data-api//nead/model/timestamp_meaning/nodata/
Example returning all records, timestamp meaning 'end' and no data
value '' (empty string):
model
should correspond to a model name listed at
, for example
timestamp_meaning
should be
end
or
beginning
-
end means that
timestamps are at the "end" of a hour long averaging period
-
beginning means that
timestamps are at the "beginning" of a hour long averaging period
nodata
represents "null" values in the database
-
means that all "null" values will be "" in the NEAD file
-
empty means that all "null"
values will be "" (empty strings) in the NEAD file
start
is the start date of the dataset
end
is the end date of the dataset (exclusive)
-
start and
end dates must be in in ISO
timestamp date format: YYYY-MM-DD ('2019-12-20')
-
start date must precede
end date
3. Download CSV
URL template:
https://www.envidat.ch/data-api//csv/model/parameter/timestamp_meaning/nodata/start/end/
Example with timestamp meaning 'end' and no data value '':
Example returning several parameters with timestamp meaning 'end' and
no data value '':
model
should correspond to a model name listed at
, for example
parameter
should be a type of measurement, for example
parameter
can also be several types of measurements separated by commas, for
example
-
multiple means that all
parameters will be included in the CSV
timestamp_meaning
should be
end
or
beginning
-
end means that
timestamps are at the "end" of a hour long averaging period
-
beginning means that
timestamps are at the "beginning" of a hour long averaging period
nodata
represents "null" values in the database
-
means that all "null" values will be "" in the CSV file
-
empty means that all "null"
values will be "" (empty strings) in the CSV file
start
is the start date of the dataset
end
is the end date of the dataset (exclusive)
-
start and
end dates must be in in ISO
timestamp date format: YYYY-MM-DD ('2019-12-20')
-
start date must precede
end date
4. Return JSON Data
URL template:
https://www.envidat.ch/data-api//json/model/parameter/start/end/
Example returning several parameters:
model
should correspond to a model name listed at
, for example
parameter
should be a type of measurement, for example
parameter
can also be several types of measurements separated by commas, for
example
-
multiple means that all
parameters will be included in the returned JSON data
start
is the start date and time of the dataset
end
is the end date and time of the dataset
-
start date must precede
end date
-
start and
end must be in in ISO
timestamp date and time format: YYYY-MM-DDTHH:MM:SS
('2020-10-20T17:00:00)
5. Return Daily Summary JSON Data
URL template:
https://www.envidat.ch/data-api//summary/daily/json/model/parameter/start/end/
Example returning several parameters:
model
should correspond to a model name listed at
, for example
parameter
should be a type of measurement, for example
parameter
can also be several types of measurements separated by commas, for
example
start
is the start date of the dataset
end
is the end date of the dataset (exclusive)
-
start and
end dates must be in in ISO
timestamp date format: YYYY-MM-DD ('2019-12-20')
-
start date must precede
end date
Parameters are aggregated daily for the following derived values:
minimum ('_min'), maximum ('_max'), and average ('_avg)
'day' values are in "year-"day number" format
'timestamp_first' and 'timestamp_last' are the range of timestamps
(inclusive) used for calculating the daily aggregated values
[
{
day: "2020-308",
timestamp_first: "2020-11-03T00:00:00Z",
timestamp_last: "2020-11-03T23:00:00Z",
_min: -21.93,
_max: -3.15,
_avg: -12.93
},
{
day: "2020-309",
timestamp_first: "2020-11-04T00:00:00Z",
timestamp_last: "2020-11-04T23:00:00Z",
_min: -10.47,
_max: -4.15,
_avg: -7.59
},
{
day: "2020-310",
timestamp_first: "2020-11-05T00:00:00Z",
timestamp_last: "2020-11-05T23:00:00Z",
_min: -20.21,
_max: -10.65,
_avg: -14.39
}
]
6. Download Daily Summary CSV
URL template:
https://www.envidat.ch/data-api//summary/daily/csv/model/parameter/timestamp_meaning/nodata/start/end/
Example with timestamp meaning 'end' and no data value '' (empty
string):
Example returning several parameters with timestamp meaning 'end' and
no data value '' (empty string):
model
should correspond to a model name listed at
, for example
parameter
should be a type of measurement, for example
parameter
can also be several types of measurements separated by commas, for
example
timestamp_meaning
should be
end
or
beginning
-
end means that
timestamps are at the "end" of a hour long averaging period
-
beginning means that
timestamps are at the "beginning" of a hour long averaging period
nodata
represents "null" values in the database
-
means that all "null" values will be "" in the CSV file
-
empty means that all "null"
values will be "" (empty strings) in the CSV file
start
is the start date of the dataset
end
is the end date of the dataset (exclusive)
-
start and
end dates must be in in ISO
timestamp date format: YYYY-MM-DD ('2019-12-20')
-
start date must precede
end date
Parameters are aggregated daily for the following derived values:
minimum ('_min'), maximum ('_max'), and average ('_avg)
'day' values are in "year-"day number" format
'timestamp_first' and 'timestamp_last' are the range of timestamps
(inclusive) used for calculating the daily aggregated values
Returns metadata for each station including earliest timestamps.
Also returns both earliest and latest timestamps for specified
parameters in ISO and UNIX (millisecond) formats.
URL template:
https://www.envidat.ch/data-api//metadata/model/parameter/
Example returning several parameters:
model
should correspond to a model name listed at
, for example
parameter
should be a type of measurement, for example
parameter
can also be several types of measurements separated by commas, for
example
-
multiple means that all
parameters and their aggregated values will be included in the
returned JSON data
Parameter List
| Parameter |
Name |
Units |
| swin |
Shortwave Incoming Radiation |
W m-2 |
| swout |
Shortwave Outgoing Radiation |
W m-2 |
| netrad |
Net Radiation |
W m-2 |
| airtemp1 |
Thermocouple Air Temperature 1 |
°C |
| airtemp2 |
Thermocouple Air Temperature 2 |
°C |
| airtemp_cs500air1 |
CS500 Air Temperature 1 |
°C |
| airtemp_cs500air2 |
CS500 Air Temperature 2 |
°C |
| rh1 |
Relative Humidity 1 |
% |
| rh2 |
Relative Humidity 2 |
% |
| windspeed1 |
Wind Speed 1 |
m s-1 |
| windspeed2 |
Wind Speed 2 |
m s-1 |
| winddir1 |
Wind Direction 1 |
degrees |
| winddir2 |
Wind Direction 2 |
degrees |
| pressure |
Atmospheric Pressure |
mb |
| sh1 |
Snow Surface Distance 1 |
m |
| sh2 |
Snow Surface Distance 2 |
m |
| battvolt |
Battery Voltage |
V |
| swin_maximum |
Shortwave Incoming Radiation Maximum |
W m-2 |
| swin_stdev |
Shortwave Incoming Radiation Standard Deviation |
W m-2 |
| netrad_stdev |
Net Radiation Standard Deviation |
W m-2 |
| airtemp1_maximum |
Thermocouple Air Temperature 1 Maximum |
°C |
| airtemp2_maximum |
Thermocouple Air Temperature 2 Maximum |
°C |
| airtemp1_minimum |
Thermocouple Air Temperature 1 Minimum |
°C |
| airtemp2_minimum |
Thermocouple Air Temperature 2 Minimum |
°C |
| windspeed_u1_maximum |
Wind Speed 1 Maximum |
m s-1 |
| windspeed_u2_maximum |
Wind Speed 2 Maximum |
m s-1 |
| windspeed_u1_stdev |
Wind Speed 1 Standard Deviation |
m s-1 |
| windspeed_u2_stdev |
Wind Speed 2 Standard Deviation |
m s-1 |
| reftemp |
Reference Temperature |
°C |