Skip to content

Commit a3a9ee3

Browse files
committed
2025-06-30 10h32: Update to usage.md
1 parent f1a1f89 commit a3a9ee3

File tree

1 file changed

+2
-7
lines changed

1 file changed

+2
-7
lines changed

doc/usage.md

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -9,19 +9,14 @@ The weather API provides historical and current weather measurements, and weathe
99
Since there are many differences between the sources and models, regarding both naming and the units in which features are described, this API aims to provide a uniform way to access and represent the weather features. In order to do so, where possible, weather factors are given the same label across sources and models. Additionaly, the user of the API can choose between the original variable units, SI units, and units which are easier to read and grasp for humans. Finally, the output format can be chosen and ranges from basic types such as JSON, to more advanced and specialized models like NetCDF.
1010

1111
## Usage
12-
### Online client and specifications
13-
The easiest way to try out the API and browse all available operations, is by using the [interactive online documentation](https://weather.appx.cloud/api/v1/docs). It contains a built-in client, which gives access to the full functionality of the API.
14-
15-
Naturally, the operations can be called from any HTTP-compatible client as well. This allows you to programmatically use the API in your applications. The API's [OpenAPI specification (v3)](https://weather.appx.cloud/api/v1/openapi.json) may come in handy to establish this connection.
16-
1712
### Retrieving weather data
1813
To retrieve weather data, whether historical or predictive, a few parameters need to be provided to the API.
1914

20-
The `source_id` and `model_id` tell the API which dataset you want to query. The available sources and models can be retrieved using [this API call](https://weather.appx.cloud/api/v1/weather/sources). Possible values are, for instance, *knmi* as the `source_id` and *daggegevens* as the `model_id`.
15+
The `source_id` and `model_id` tell the API which dataset you want to query. The available sources and models can be retrieved using the **"/weather/sources"** endpoint. Possible values are, for instance, *knmi* as the `source_id` and *daggegevens* as the `model_id`.
2116

2217
A measurement or prediction time window must be provided as well. This is done by setting the `begin` and `end` values. Both need to be in the following date time format: `%m-%d-%Y %H:%M`. For example, `2019-01-31 04:00`, `2017-12-25 14:45`, and `2020-02-28 00:00` are valid values.
2318

24-
The location is needed as well and is described in *WGS84* format, by specifying latitude `lat` and longitude `lon`. The API selects the closest weather station or grid in a model for which data is available. The [interactive online documentation](https://weather.appx.cloud/api/v1/docs) is pre-filled with the latitude and longitude for *De Bilt*. In future versions of the API it will be possible to retrieve weather data for multiple locations in a single call.
19+
The location is needed as well and is described in *WGS84* format, by specifying latitude `lat` and longitude `lon`. The API selects the closest weather station or grid in a model for which data is available. The Swagger UI is pre-filled with the latitude and longitude for *De Bilt*. In future versions of the API it will be possible to retrieve weather data for multiple locations in a single call.
2520

2621
The units and names of the various weather variables can be changed. SI units are returned by default but if preferred the original units and labels can be returned, or units which are easier to read for humans.
2722

0 commit comments

Comments
 (0)