Migrating from Legacy Naming

This document describes the variable naming conventions previously used for API requests. These conventions are considered legacy and differ from the naming conventions used in newer models.

Note: Currently we are supporting both the standardized naming and legacy naming for API request. This will change in the future and we recommend migrating to the standardized naming convention.

Per default we return the legacy naming for requests that did not request specific variables. Set use_new_naming=true in your query or body parameters to use the new naming.

Common Weather Variables

Legacy Name	Standardized Name	Unit	ECMWF Code
air_temperature_2m	air_temperature_at_height_level_2m	K	2
air_pressure_at_mean_sea_level	air_pressure_at_mean_sea_level	Pa	msl
wind_speed_10m	wind_speed_at_height_level_10m	m s⁻¹	10si
wind_direction_10m	wind_direction_at_height_level_10m	°	10wdir
wind_speed_100m	wind_speed_at_height_level_100m	m s⁻¹	100si
wind_direction_100m	wind_direction_at_height_level_100m	°	100wdir
geopotential_500hpa	geopotential_at_pressure_level_50000Pa	m² s⁻²	z_500
ssrd	surface_downwelling_shortwave_flux_1h	J m⁻²	ssrd

Important Notes

1. Temperature variables in EPT-1.5 are provided in Kelvin (K), unlike some other providers that use Celsius (°C).

2. For most forecast parameters (non-accumulated), the value at a given timestamp represents the weather conditions exactly at that time.

3. SSRD is an accumulated parameter reflecting the total solar radiation for the hour preceding the timestamp.