This page has example queries. For more indepth instructions on how to make them see Using the Timeseries API -page.
Feel free to contribute your own examples on this page!
Please note that some data in the examples are only only available for commercial use and are therefore not found in the FMI Open Data.
For FMI Open Data replace the host part in the example URLs with
opendata.fmi.fi
.
For commercial use replace the host part with data.fmi.fi
and add your personal apikey with /apikey/WriteApiKeyHere/timeseries
before the
querystring.
Most examples here format the output as styled HTML for testing purposes. Use Json or other machine readable formats for any real use.
http://smartmet.fmi.fi/timeseries?precision=double×tep=data¶m=utctime,fmisid,stationname,stationlat,stationlon,distance,TA_PT1H_AVG&producer=observations_fmi&latlon=60.1757,24.9336&starttime=2018-05-14T00:00:00&endtime=2018-05-15T00:00:00&tz=UTC&format=debug
The param
field defines what values to return in results.
utctime
: Time of observation in UTCfmisid
: FMI's ID-number of weather stationstationname
: Name of the weather stationstationlat
: Latitude of the weather stations locationstationlon
: Longitude of the weather stations locationdistance
: Distance from requested location to the weather station in metersTA_PT1H_AVG
: The actual weather observation. Temperature of the past hour.
Other querystring fields in the example are used to filte
precision=double
: Allow decimals in number values of observationstimestep=data
: Request that all available observations within the time rage are returned for requested parametersproducer=observations_fmi
: Use FMI's observation stationslatlon=60.1757,24.9336
: Point of interest where the nearest observations should be returnedformat=debug
: Return human readable HTML-table (useformat=json
for Json-formatted data)
The weather observations, if any is availble, are within the requested time range, including the start and end times.
starttime=2018-05-14T00:00:00
: Get observations made later or at this timeendtime=2018-05-15T00:00:00
: Get observations made before or at this timetz=UTC
: Given times are in UTC timezone. This can be replaced with aZ
at the end of timestrings.
Returns and array of Json objects.
[
{
"utctime":"20180514T000000",
"fmisid":100971,
"stationname":"Helsinki Kaisaniemi",
"stationlat":60.1752300,
"stationlon":24.9445900,
"distance":0.6,
"TA_PT1H_AVG":13.0
},
...
]
This uses the groupareas=0
field to return data as multiple items.
Parameter is TA_PT1H_AVG
but might as well be Temperature
.
http://smartmet.fmi.fi/timeseries?producer=observations_fmi&area=Finland¶m=utctime,fmisid,stationname,TA_PT1H_AVG&format=debug&starttime=2018-07-07T00:00:00Z&endtime=2018-07-07T00:00:00Z&groupareas=0
http://smartmet.fmi.fi/timeseries?producer=observations_fmi&place=kumpula¶m=utctime,fmisid,stationname,GLOB_PT1H_SUM&format=debug&tz=utc&starttime=2018-07-07T00:00:00
http://smartmet.fmi.fi/timeseries?param=time,name,t2m(:1),t2m(:11)&fmisid=101004&producer=observations_fmi&format=ascii&timeformat=sql×tep=data&precision=double&starttime=202002200800&endtime=202002200810
http://smartmet.fmi.fi/timeseries?param=time,name,t2m(:1),t2m(:11),t2m(:1:qc),t2m(:11:qc)&fmisid=101004&producer=observations_fmi&format=ascii&timeformat=sql×tep=data&precision=double&starttime=202002200800&endtime=202002200810
Use lang=fi|en|sv
to set preferred language in results.
http://smartmet.fmi.fi/timeseries?producer=observations_fmi&latlon=60.20,24.96¶m=utctime,TA_PT1H_AVG,fmisid,wmo,region,country,stationname,elevation,stationlatitude,stationlongitude,distance&format=debug×teps=1
Use lang=fi|en|sv
to set preferred language in results.
http://smartmet.fmi.fi/timeseries?producer=foreign&place=Tokyo¶m=utctime,temperature,elevation,country,region,latitude,longitude&format=debug
http://smartmet.fmi.fi/timeseries?producer=observations_fmi&latlon=60.20,24.96¶m=fmisid,stationname,utctime,TA_PT1H_AVG,mean_t(TA_PT1H_AVG:3h)&format=debug&starttime=2018-08-08T00:00:00×teps=24&tz=utc
http://smartmet.fmi.fi/timeseries?format=debug&area=Helsinki¶m=fmisid,name,time,min(TA_PT1H_AVG)%20as%20mintemp,max(TA_PT1H_AVG)%20as%20maxtemp%20,mean(TA_PT1H_AVG)%20as%20meantemp&producer=observations_fmi&numberofstations=50
http://smartmet.fmi.fi/timeseries?producer=flash&starttime=2018-08-01T00:00:00&endtime=2018-08-01T01:00:00¶m=utctime,flash_id,peak_current,latitude,longitude&bbox=6,51.3,49,70.2&format=json
These calculated values are not available in the opendata.
The parameter HDD_P1D_AVG
aka. "lämmitystarveluku" or "astepäiväluku" in
Finnish.
Example to get a single values for all availble weather startions for given time
http://smartmet.fmi.fi/timeseries?producer=observations_fmi¶m=stationname,utctime,HDD_P1D_AVG&precision=double&keyword=synop_fi&starttime=2021-05-01T00:00:00Z×tep=data×teps=1&format=json
For any particular location use use for example fmisid
instead of keyword.
http://smartmet.fmi.fi/timeseries?producer=observations_fmi¶m=stationname,utctime,HDD_P1D_AVG&precision=double&fmisid=151049&starttime=2021-05-01T00:00:00Z×tep=data×teps=1&format=json
Availabe only available for commercial use and are therefore not found in the FMI Open Data.
Example returns latest forecast for Helsinki
/timeseries?producer=ecmwf_eurooppa_calibrated_fractiles&format=json¶m=TemperatureF10,TemperatureF90,TemperatureDeviation,WindSpeedF90,WindSpeedF10,TotalPrecipitationF90,TotalPrecipitationF10&place=Helsinki
Example returns latest forecast for Helsinki:
/timeseries?producer=metcoop_scandinavia_nowcast_surface&format=json¶m=utctime,Pressure,Temperature,WindDirection,WindSpeedMS&place=Helsinki