get https://api.eratos.com/api/workspace/v1/drill
Drill a gridded dataset at a given latitude and longitude along the time axis for a given variable or variables
- If no variables are provided, all variables in the dataset will be returned. To obtain a list of variables in the dataset, see the
/resources/:rid
endpoint. - Results are returned in natural order by default, however, the
direction
parameter can be used to reverse the order of the results - Limits and offsets can be used to paginate the results (default limit is 10 and max limit is 1000)
Constraints:
- Only resources of type
ern:e-pn.io:schema:block
orern:e-pn.io:schema:dataset
are supported and must offer a gridded interface. - The dataset resource must have a recognised time property to drill on. Supported property names are ['time']
- The dataset resource must have a recognised
latitude
andlongitude
property to drill on. Supported property names are ['lat', 'latitude', 'Latitude'] and ['lon', 'longitude', 'Longitude'] - The
start
date must be before theend
date if both are provided and in ISO8601 format - The
latitude
must be between -90 and 90 degrees and the longitude must be between -180 and 180 degrees inclusive. - The
latitude
andlongitude
must be within the bounds of the dataset
Returns:
- A timeseries along the time axis for the given latitude and longitude with the requested variables
Example:
GET /drill?resourceId=eratos.blocks.silo.maxtemperature&variable=max_temp&latitude=-37.8&longitude=144.95&start=2024-08-23&end=2024-08-24