Meteo automatic access

Meteo automatic access


Meteo proposes two monitoring services : "Meteo Historical" & "Meteo Monitoring"

Automatic access is a charged service. Please contact us for a quotation and receive your SoDa credentials.

Meteo HistoricalMeteo Monitoring
DescriptionThe "Meteo Historical" service is in charge of retrieving archive meteo dataThe "Meteo Historical"service is in charge of retrieving meteo data to help for monitoring
Date range"1980-01-01" up to "d-45""d-45" up to "d+15
Requests1 request per year per site4 requests per day per site
Service namemeteo_historicalmeteo_monitoring
Download examples

download unix "Meteo Historical" examples

download windows "Meteo Historical" examples

download unix "Meteo Monitoring"  examples

download windows "Meteo Monitoring" examples

FAQError messages & FAQ


Warning! It is strongly recommanded to avoid the launch of parallel requests, using the "&" at the end of each wget request line. This would endanger our system.

Automatic access using WGET

WGET command example ("guest" user on Carpentras location 44.083, 5.059)

wget -O output.csv --header="soda-user: guest" --header="soda-passwd: guest" ",5.059&firstday=d&lastday=d+15&duration=15&format=unified"

WGET command in details


wget -O output.csv ...
--header="soda-user: login" --header="soda-passwd: password" ...



authentication: login and password provided by the Commcercial SoDa team. Note that a free permanent automatic access is set up for the site of Carpentras, France (44.083, 5.059) with the login/password guest/guest


(see array above) "meteo_historical" or "meteo_monitoring"

latitude and longitude

in degrees, with at least 3 digits after comma


"firstday" and the "lastday" parameters of the request. It can be defined either by a numerical date YYYY-MM-DD or thanks to date shortcuts.

The available date shortcuts are : d, d-x, d+x, m, m-x, y, y-x 

  • "x" representing an integer value,
  • "d", "m", "y" stands (respectively) for day, month, year.

For instance "m-2" means "2 months ago".


"1", "5", "10", "15" (minutes), "h" (hourly), "d" (daily), "m" (monthly).

time_reference (optional)

The only possible value is "UT" (universal time)

Default value is "UT".

output_format (optional)

Possible values are standard formats "excel", "netcdf", "json" and "unified"

Default format is "unified".


The output data :

  • Temperature (K): Temperature at 2 m above ground in Kelvins (K)
  • Relative humidity (%): Relative humidity at 2 m above ground in percent (%)
  • Pressure (hPa): Pressure at ground level in hPa
  • Wind speed (m/s): Wind speed at 10 m above ground in m/s
  • Wind direction (deg): Wind direction at 10 m above ground in degrees (0 means from North, 90 from East...)
  • Rainfall (kg/m2): Rainfall (= rain depth in mm)
  • Snowfall (kg/m2): Snowfall
  • Snow depth (m): Snow depth in meters
  • Short-wave irradiation (wh/m2): Surface downward short-wave irradiation (broadband=GHI)

Automatic access using CURL

You can also automatically retrieve HC3 Meteo time series using the CURL command. The advantage is to accelerate the requests by an approx. factor of 2. CURL outputs don't have any header. This is due to the fact that each station configuration (i.e each line of the stations.txt file) can be different (tilted or not, date range, ...), so the "stations" header information (contained in header) may be differrent.

Curl command example ("guest" user on Carpentras location 44.083, 5.059)

curl -f -s -S -F stations=@stations.txt -o output.csv --header "soda-user: guest" --header "soda-passwd: guest"

With the following stations.txt file format:

# Columns description
# id: station name
# latitude and longitude: in degrees, with at least 3 digits after comma

# altitude: ignored
# time reference: "UT" (universal time)
# duration: "1", "5", "10", "15" (minutes), "h" (hourly), "d" (daily), "m" (monthly)
# firstday and lastday: first and the last days of the request, expressed as yyyy-mm-dd
# slope of panel: ignored
# azimuth of panel: ignored
#id                     lat    lon     elevation time   duration   firstday      lastday    slope   azimuth 
Carpentras1 44.083 5.059   -999           UT     15             m-1           m-1         0          0          
Carpentras2 44.083 5.059   -999           UT     d               y-1            y-1           0          0        

CURL command in details

curl -f -s -S -F stations=@my_stations.txt -o output.csv --header "soda-user: login" --header "soda-passwd: password"

  • login, password and service_name are described in the table above.
  • The station file "my_stations.txt" should be defined with the same format as the "stations.txt" file in the previous example. The columns descriptions are available in the table above.