Your First Query
After you received your username and password you can start using the Weather API.
Just click here or copy this link to your favourite web browser to get the current temperature on Mont Blanc.
https://api.meteomatics.com/now/t_2m:C/45.842875,6.863229/csv
How Does It Work?
The URL has the following structure:
api.meteomatics.com/datetime/parameters/locations/format?optionals
Click here for more information about the structure.
Looking at the example from above:
api.meteomatics.com/now/t_2m:C/45.842875,6.863229/csv
where
- now - current date and time
- t_2m:C - parameter with units (temperature at two meters in degree Celsius)
- 45.842875,6.863229 - latitude, longitude (Coordinates of Mont Blanc)
- csv - output format
The result is a csv file containing the queried data:
validdate;t_2m:C
2017-06-12T00:00:00Z;0.8Let's Add More Parameters
For more than one parameter type them separated by commas:
api.meteomatics.com/today_replaceT00:00:00Z/t_2m:C,precip_1h:mm,total_cloud_cover:p/45.842875,6.863229/csv
where
- t_2m:C - temperature at two meters in degree Celsius
- precip_1h:mm - precipitation during the last hour in mm
- total_cloud_cover:p - total cloud cover in percent
Click here for more available parameters.
Get Parameters On a Grid
Interested in a larger area? No problem, just change the coordinates!
api.meteomatics.com/today_replaceT00:00:00Z/t_2m:C/50,10_40,20:100x100/csv
api.meteomatics.com/today_replaceT00:00:00Z/t_2m:C/50,10_40,20:100x100/csv
where
- 50,10 - latitude max, longitude min (upper left corner of the area)
- 40,20 - latitude min, longitude max (lower right corner of the area)
- 100x100 - resolution (grid 100x100)
Click here for a detailed coordinates description.
Use a Time Interval
Let’s get the temperature for a ten day interval with temporal increments of one day:
api.meteomatics.com/today_replaceT00:00:00ZP10D:P1D/t_2m:C/45.842875,6.863229/csv
api.meteomatics.com/today_replaceT00:00:00ZP10D:P1D/t_2m:C/45.842875,6.863229/csv
where
- today_replaceT00:00:00Z - start date
- P10D - time interval (10 days)
- P1D - time step (1 day)
Click here for a detailed time description
Output Formats
Just replace csv with your favourite format:
png, xml, json, netcdf...
api.meteomatics.com/today_replaceT00:00:00Z/t_2m:C/45.842875,6.863229/json
api.meteomatics.com/today_replaceT00:00:00Z/t_2m:C/45.842875,6.863229/json
where
- json - json format
Click here for available formats.
URL Creator
Feel free to play around with our URL creator to get a feeling for the URL construction.
First, decide what format you prefer. Then choose the start date, the length of the interval and the steps, where m = minute, h = hour, D = day, M = month and Y = year. Next choose the parameter. If you want more than one parameter, you can add up to three more parameters by clicking on the plus sign. The coordinates can either be single points, point lists or rectangles, depending on the format you chose. The last step is to decide which model you choose.
The URL-link will then be shown. Just click on the link or copy it to your web browser to retrieve the data.
Point list: 50,10+40,20
<lat1>,<lon1>+...+<latN>,<lonN>
Rectangle (fixed number of points): 50,10_40,20:11x11
<lat_max>,<lon_min><lat_min>,<lon_max>:<number_lons>x<number_lats>
You can get a subscription for the Meteomatics Weather API at the shop or by directly contacting us.
Email: api@meteomatics.com.
Phone (Switzerland): +41 (0) 71 272 66 50
Phone (Germany): +49 (0) 30 200 74 280
Phone (France): +33 (0) 7 89 57 22 32
Get Support
Please use the support form to contact us: Meteomatics API Support Form.
