Getting Started

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.8

Let'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

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>

Get A Subscription

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.