Meta Requests
Get Latest Initial Time
You can find out when the data was computed (which model run the data originated from) using this query:
https://api.meteomatics.com/get_init_date?model=<model>&valid_date=<validdatetime>¶meters=<parameter_list>
https://api.meteomatics.com/get_init_date?model=ecmwf-ifs&valid_date=2024-12-03T19:00:00ZP1D:PT6H¶meters=t_2m:C,relative_humidity_2m:pReply:
validdate;initdate_t_2m:sql;initdate_relative_humidity_2m:sql
2017-06-22T19:00:00Z;2017-06-21T12:00:00Z;2017-06-21T12:00:00Z
2017-06-23T01:00:00Z;2017-06-21T12:00:00Z;2017-06-21T12:00:00Z
2017-06-23T07:00:00Z;2017-06-21T12:00:00Z;2017-06-21T12:00:00Z
2017-06-23T13:00:00Z;2017-06-21T12:00:00Z;2017-06-21T12:00:00Z
2017-06-23T19:00:00Z;2017-06-21T12:00:00Z;2017-06-21T12:00:00Z
If a value of a certain time step can not be assigned to an init date, the init date is represented as 00-00-00T00:00:00Z
.
Get Available Time Range
The valid dates that are available within the API can be queried with using:https://api.meteomatics.com/get_time_range?model=<model>¶meters=<parameter_list>
Example: https://api.meteomatics.com/get_time_range?model=ecmwf-ifs¶meters=global_rad:W,t_2m:C
Response:parameter;min_date;max_date
global_rad:W;2013-12-30T00:00:00Z;2017-07-01T12:00:00Z
t_2m:C;2013-12-30T00:00:00Z;2017-07-01T12:00:00Z
Get Colormaps
The colormaps described here can be queried by using:
https://api.meteomatics.com/get_colormap?parameter=<parameter>&style=<style>&format=<format>
The parameters of a get_colormap request a as follows:
Option | Description | Example |
---|---|---|
parameter |
A weather parameter. Please refer to Available Parameters for a sorted list of valid parameters. | fresh_snow:cm |
style |
The colormap you want to get the numerical values for. The list of available colormaps is here. If style= is omitted from a get_colormap request, then a default value for <style> is provided depending on the requested parameter. |
jet_segmented |
format |
The output data format. CSV is the only available output format. | csv |
Example of a get_colormap request with all the three parameters explicitly defined:
https://api.meteomatics.com/get_colormap?parameter=fresh_snow:cm&style=jet_segmented&format=csv
Example of a get_colormap request with only two parameters explicitly defined. In this case,<style>
is automatically set to jet
:
https://api.meteomatics.com/get_colormap?parameter=fresh_snow:cm&format=csv
Example of generated csv file:
Value;Hex Color
160;#870000FF
156;#9B0F14FF
152;#AC1E32FF
...
12;#1928B9FF
8;#0519A0FF
4;#000A6EFF
Show User Statistics
You can check how many queries you already sent and how your limits are defined by calling https://api.meteomatics.com/user_statsThis is also available in a machine readable format: https://api.meteomatics.com/user_stats_json