Website Developer Console Playground

Queries

serverTime

Description

Current time on the server.

Response

Returns a Time!

Example

Query
query serverTime {
  serverTime
}
Response
{
  "data": {
    "serverTime": "2022-10-26T12:37:53.528758212+03:00"
  }
}

serverTimestamp

Description

Current time on the server.

Response

Returns a Timestamp!

Example

Query
query serverTimestamp {
  serverTimestamp
}
Response
{"data": {"serverTimestamp": "1666778972"}}

stations

Description

List of weather stations values.

Response

Returns [Station!]!

Arguments
Name Description
minLat - Float!
maxLat - Float!
minLon - Float!
maxLon - Float!
language - Language

Example

Query
query stations(
  $minLat: Float!,
  $maxLat: Float!,
  $minLon: Float!,
  $maxLon: Float!,
  $language: Language
) {
  stations(
    minLat: $minLat,
    maxLat: $maxLat,
    minLon: $minLon,
    maxLon: $maxLon,
    language: $language
  ) {
    id
    code
    name
    lat
    lon
    time
    timestamp
    cloudiness
    condition
    distance
    feelsLike
    humidity
    icon
    isThunder
    phenomCondition
    phenomIcon
    prec
    precProbability
    precStrength
    precType
    pressure
    temperature
    waterTemperature
    windAngle
    windDirection
    windSpeed
  }
}
Variables
{
  "minLat": 47.27319717,
  "maxLat": 47.27319717,
  "minLon": -119.7085724,
  "maxLon": -119.7085724,
  "language": "EN"
}
Response
{
  "data": {
    "stations": [
      {
        "id": 987,
        "code": "xyz789",
        "name": "xyz789",
        "lat": 47.27319717,
        "lon": -119.7085724,
        "time": "2022-10-26T12:37:53.528758212+03:00",
        "timestamp": "1666778972",
        "cloudiness": "CLEAR",
        "condition": "CLEAR",
        "distance": 987.65,
        "feelsLike": 15,
        "humidity": 82,
        "icon": "skc_d",
        "isThunder": false,
        "phenomCondition": "BLOWING_SNOW",
        "phenomIcon": "skc_d",
        "prec": 10.1,
        "precProbability": 82,
        "precStrength": "ZERO",
        "precType": "NO_TYPE",
        "pressure": 762,
        "temperature": 15,
        "waterTemperature": 10,
        "windAngle": 145,
        "windDirection": "CALM",
        "windSpeed": 3.5
      }
    ]
  }
}

stationsByTimeRange

Description

List of weather stations values by time range.

Response

Returns [Station!]!

Arguments
Name Description
request - PointInput!
timeRange - TimeRange!

Example

Query
query stationsByTimeRange(
  $request: PointInput!,
  $timeRange: TimeRange!
) {
  stationsByTimeRange(
    request: $request,
    timeRange: $timeRange
  ) {
    id
    code
    name
    lat
    lon
    time
    timestamp
    cloudiness
    condition
    distance
    feelsLike
    humidity
    icon
    isThunder
    phenomCondition
    phenomIcon
    prec
    precProbability
    precStrength
    precType
    pressure
    temperature
    waterTemperature
    windAngle
    windDirection
    windSpeed
  }
}
Variables
{
  "request": PointInput,
  "timeRange": TimeRange
}
Response
{
  "data": {
    "stationsByTimeRange": [
      {
        "id": 123,
        "code": "abc123",
        "name": "abc123",
        "lat": 47.27319717,
        "lon": -119.7085724,
        "time": "2022-10-26T12:37:53.528758212+03:00",
        "timestamp": "1666778972",
        "cloudiness": "CLEAR",
        "condition": "CLEAR",
        "distance": 123.45,
        "feelsLike": 15,
        "humidity": 82,
        "icon": "skc_d",
        "isThunder": true,
        "phenomCondition": "BLOWING_SNOW",
        "phenomIcon": "skc_d",
        "prec": 10.1,
        "precProbability": 82,
        "precStrength": "ZERO",
        "precType": "NO_TYPE",
        "pressure": 762,
        "temperature": 15,
        "waterTemperature": 10,
        "windAngle": 145,
        "windDirection": "CALM",
        "windSpeed": 3.5
      }
    ]
  }
}

tiles

Description

Timelines for tiled data.

Response

Returns a Tiles!

Arguments
Name Description
request - PointInput!

Example

Query
query tiles($request: PointInput!) {
  tiles(request: $request) {
    humidity {
      steps {
        ...TimelineStepFragment
      }
    }
    prec {
      steps {
        ...TimelineStepFragment
      }
    }
    pressureMm {
      steps {
        ...TimelineStepFragment
      }
    }
    snowDepth {
      steps {
        ...TimelineStepFragment
      }
    }
    soilMoisture {
      steps {
        ...TimelineStepFragment
      }
    }
    soilTemperature {
      steps {
        ...TimelineStepFragment
      }
    }
    surfaceTemperature {
      steps {
        ...TimelineStepFragment
      }
    }
    temperature {
      steps {
        ...TimelineStepFragment
      }
    }
    waterTemperature {
      steps {
        ...TimelineStepFragment
      }
    }
    windSpeed {
      steps {
        ...TimelineStepFragment
      }
    }
  }
}
Variables
{"request": PointInput}
Response
{
  "data": {
    "tiles": {
      "humidity": 82,
      "prec": 10.1,
      "pressureMm": 762,
      "snowDepth": TilesTimeline,
      "soilMoisture": 20,
      "soilTemperature": 10,
      "surfaceTemperature": 10,
      "temperature": 15,
      "waterTemperature": 10,
      "windSpeed": 3.5
    }
  }
}

weatherByPoint

Description

Weather for a geographical point with lat and lon coordinates.

Response

Returns a Weather!

Arguments
Name Description
request - PointInput!
language - Language

Example

Query
query weatherByPoint(
  $request: PointInput!,
  $language: Language
) {
  weatherByPoint(
    request: $request,
    language: $language
  ) {
    climate {
      days {
        ...ClimateDayFragment
      }
      weeks {
        ...ClimateWeekFragment
      }
      months {
        ...ClimateMonthFragment
      }
      zone {
        ...ClimateZoneFragment
      }
    }
    forecast {
      days {
        ...ForecastDayFragment
      }
    }
    location {
      altitude
      lat
      lon
      pressureNorm
      timezone {
        ...TimezoneFragment
      }
    }
    now {
      cloudiness
      condition
      daytime
      feelsLike
      humidity
      icon
      isThunder
      phenomCondition
      phenomIcon
      pollution {
        ...PollutionFragment
      }
      precProbability
      precStrength
      precType
      pressure
      season
      soilMoisture
      soilTemperature
      temperature
      uvIndex
      visibility
      waterTemperature
      waveAngle
      waveDirection
      waveHeight
      wavePeriod
      windAngle
      windDirection
      windGust
      windSpeed
    }
    nowcast {
      region
      steps {
        ...NowcastTimelineStepFragment
      }
    }
    url
  }
}
Variables
{"request": PointInput, "language": "EN"}
Response
{
  "data": {
    "weatherByPoint": {
      "climate": Climate,
      "forecast": Forecast,
      "location": Location,
      "now": Now,
      "nowcast": NowcastTimeline,
      "url": "https://meteum.ai/london"
    }
  }
}

Types

Boolean

Description

The Boolean scalar type represents true or false.

Example
true

Bounds

Description

Rectangle where data is available.

Fields
Field Name Description
lat - BoundsRange!
lon - BoundsRange!
Example
{"lat": 47.27319717, "lon": -119.7085724}

BoundsRange

Description

The range of coordinates for one of the dimensions.

Fields
Field Name Description
min - Float!
max - Float!
Example
{"min": 987.65, "max": 123.45}

Climate

Description

Average weather statistics for 10 years.

Fields
Field Name Description
days - [ClimateDay!]! Statistics grouped by day.
Arguments
offset - Int

Allows you to skip N entries.

limit - Int

Allows you to limit the number of entries returned. In a leap year, 366 days will be returned.

loop - Boolean

Allows you to loop records. After December 31, it will be followed by January 1.
weeks - [ClimateWeek!]! Statistics grouped by week.
Arguments
offset - Int

Allows you to skip N entries.

limit - Int

Allows you to limit the number of entries returned. It always returns no more than 48 possible weeks in a year.

loop - Boolean

Allows you to loop records. After last week of the year, it will be followed by first week.
months - [ClimateMonth!]! Statistics grouped by month.
Arguments
offset - Int

Allows you to skip N entries.

limit - Int

Allows you to limit the number of entries returned. It always returns no more than 12 possible months in a year.

loop - Boolean

Allows you to loop records. After December, it will be followed by January.
zone - ClimateZone! Climate zone description.
Example
{
  "days": [ClimateDay],
  "weeks": [ClimateWeek],
  "months": [ClimateMonth],
  "zone": ClimateZone
}

ClimateDay

Description

Statistics for one day.

Fields
Field Name Description
cloudiness - Cloudiness! Average cloudiness for this day.
condition - Condition! The general weather condition that fits to cloudiness, precStrength and precType.
feelsLike - Int! The same temperature values may be perceived differently depending on humidity, wind strength, and ultraviolet radiation. feelsLike shows how comfortable the weather conditions are, taking into account all these factors.
Arguments
unit - TemperatureUnit
humidity - Int! The percentage of the mass fraction of water vapor in the air to the maximum possible at the current temperature. Contains the average value for this day.
icon - Url! Icon describing the general weather condition for this day. Fits to the cloudiness, precStrength and precType.
Arguments
format - IconFormat!
theme - IconTheme
maxDayTemperature - Int! The highest temperature for this day.
Arguments
unit - TemperatureUnit
maxWindSpeed - Float! The highest wind speed for this day.
Arguments
unit - WindSpeedUnit
minNightTemperature - Int! The lowest temperature for this day.
Arguments
unit - TemperatureUnit
minWindSpeed - Float! The lowest wind speed for this day.
Arguments
unit - WindSpeedUnit
prec - Float! Total amount of precipitation in this day. Measured in millimeters.
precProbability - Float! The probability of precipitation for this day. Possible values are in [0, 1].
precStrength - PrecStrength! The highest strength of precipitation for this day.
precType - PrecType! Precipitation corresponding to the precipitation strength.
pressure - Int! Atmospheric pressure for this day.
Arguments
unit - PressureUnit
waterTemperature - Int The water surface temperature for this day. Exists only for cities that are located near large bodies of water.
Arguments
unit - TemperatureUnit
windAngle - Int! The angle of the wind direction in degrees.
windDirection - WindDirection! Average wind direction for this day.
Example
{
  "cloudiness": "CLEAR",
  "condition": "CLEAR",
  "feelsLike": 15,
  "humidity": 82,
  "icon": "skc_d",
  "maxDayTemperature": 15,
  "maxWindSpeed": 3.5,
  "minNightTemperature": 15,
  "minWindSpeed": 3.5,
  "prec": 10.1,
  "precProbability": 82,
  "precStrength": "ZERO",
  "precType": "NO_TYPE",
  "pressure": 762,
  "waterTemperature": 10,
  "windAngle": 145,
  "windDirection": "CALM"
}

ClimateMonth

Description

Statistics for one month.

Fields
Field Name Description
avgDayTemperature - Int! Average daily temperature for this month.
Arguments
unit - TemperatureUnit
humidity - Int! The percentage of the mass fraction of water vapor in the air to the maximum possible at the current temperature. Contains the average value for this month.
maxDayTemperature - Int! The highest daily temperature for this month.
Arguments
unit - TemperatureUnit
minNightTemperature - Int! The lowest night temperature for this month.
Arguments
unit - TemperatureUnit
overcastDays - Int! The number of cloudy days for this month.
prec - Float! Total amount of precipitation for this month. Measured in millimeters.
precDays - Int! The number of days with precipitation for this month.
pressure - Int! Average atmospheric pressure for this month.
Arguments
unit - PressureUnit
sunnyDays - Int! Number of sunny days for this month.
waterTemperature - Int Average water surface temperature for this month. Exists only for cities that are located near large bodies of water.
Arguments
unit - TemperatureUnit
windAngle - Int! Average angle of the wind direction in degrees.
windDirection - WindDirection! Average wind direction for this month.
windSpeed - Float! Average wind speed for this month.
Arguments
unit - WindSpeedUnit
Example
{
  "avgDayTemperature": 15,
  "humidity": 82,
  "maxDayTemperature": 15,
  "minNightTemperature": 15,
  "overcastDays": 10,
  "prec": 10.1,
  "precDays": 10,
  "pressure": 762,
  "sunnyDays": 10,
  "waterTemperature": 10,
  "windAngle": 145,
  "windDirection": "CALM",
  "windSpeed": 3.5
}

ClimateWeek

Description

Statistics for one week.

Fields
Field Name Description
maxDayTemperature - Int! The highest daily temperature for this week.
Arguments
unit - TemperatureUnit
maxWindSpeed - Float! The highest wind speed for this week.
Arguments
unit - WindSpeedUnit
minNightTemperature - Int! The lowest night temperature for this week.
Arguments
unit - TemperatureUnit
prec - Float! Total amount of precipitation for this week. Measured in millimeters.
strongPrecDays - Int! Days of this week with heavy precipitation.
sunnyDays - Int! Number of sunny days for this week.
veryStrongPrecDays - Int! Days of this week with very heavy precipitation.
verySunnyDays - Int! Number of very sunny days for this week.
waterTemperature - Int Average water surface temperature for this week. Exists only for cities that are located near large bodies of water.
Arguments
unit - TemperatureUnit
windAngle - Int! Average angle of the wind direction in degrees.
windDirection - WindDirection! Average wind direction for this week.
windSpeed - Float! Average wind speed for this week.
Arguments
unit - WindSpeedUnit
Example
{
  "maxDayTemperature": 15,
  "maxWindSpeed": 3.5,
  "minNightTemperature": 15,
  "prec": 10.1,
  "strongPrecDays": 10,
  "sunnyDays": 10,
  "veryStrongPrecDays": 10,
  "verySunnyDays": 10,
  "waterTemperature": 10,
  "windAngle": 145,
  "windDirection": "CALM",
  "windSpeed": 3.5
}

ClimateZone

Description

Climate zone description.

Fields
Field Name Description
code - ClimateZoneCode!
description - String!
Example
{"code": "None", "description": "xyz789"}

ClimateZoneCode

Description

Represents codes of climate zones. See more here https://en.wikipedia.org/wiki/Köppen_climate_classification

Values
Enum Value Description

None

Af

Am

Aw

BWh

BWk

BSh

BSk

Csa

Csb

Csc

Cwa

Cwb

Cwc

Cfa

Cfb

Cfc

Dsa

Dsb

Dsc

Dsd

Dwa

Dwb

Dwc

Dwd

Dfa

Dfb

Dfc

Dfd

ET

EF
Example
"None"

Cloudiness

Description

Represents the state of cloudiness. In ascending order: CLEAR – minimum, OVERCAST – maximum.

Values
Enum Value Description

CLEAR

PARTLY

SIGNIFICANT

CLOUDY

OVERCAST
Example
"CLEAR"

CloudinessLevel

Description

Cloud cover level.

Values
Enum Value Description

LOW

MIDDLE

HIGH

TOTAL
Example
"LOW"

Condition

Description

Represents the general weather conditions.

Values
Enum Value Description

CLEAR

PARTLY_CLOUDY

CLOUDY

OVERCAST

LIGHT_RAIN

RAIN

HEAVY_RAIN

SHOWERS

SLEET

LIGHT_SNOW

SNOW

SNOWFALL

HAIL

THUNDERSTORM

THUNDERSTORM_WITH_RAIN

THUNDERSTORM_WITH_HAIL
Example
"CLEAR"

Datum

Description

Supported datum options. https://tidesandcurrents.noaa.gov/datum_options.html

Values
Enum Value Description

MSL

LAT

MLLW
Example
"MSL"

Daypart

Description

Aggregations for one time of day. Be careful, some of the fields may be skipped.

Fields
Field Name Description
avgTemperature - Int! Average temperature value for this time of day.
Arguments
unit - TemperatureUnit
cloudiness - Cloudiness! Average cloudiness for this time of day.
condition - Condition! The general weather condition that fits to cloudiness, precStrength and precType.
daytime - Daytime! Indicates the presence of the sun most of the time during the aggregation period.
feelsLike - Int! The same temperature values may be perceived differently depending on humidity, wind strength, and ultraviolet radiation. feelsLike shows how comfortable the weather conditions are, taking into account all these factors.
Arguments
unit - TemperatureUnit
freshSnow - Float! Amount of fresh snow in this time of day. Measured in millimeters.
humidity - Int! The percentage of the mass fraction of water vapor in the air to the maximum possible at the current temperature. Contains the average value for time of day.
icon - Url! Icon describing the general weather condition. Fits to the cloudiness, precStrength and precType.
Arguments
format - IconFormat!
theme - IconTheme
maxSoilTemperature - Int Highest soil temperature at a depth of 7 cm.
Arguments
unit - TemperatureUnit
minSoilTemperature - Int Lowest soil temperature at a depth of 7 cm.
Arguments
unit - TemperatureUnit
maxTemperature - Int! Highest temperature value for this time of day.
Arguments
unit - TemperatureUnit
minTemperature - Int! Lowest temperature value for this time of day.
Arguments
unit - TemperatureUnit
pollution - PollutionDaypart Atmospheric composition forecast for this time of day.
prec - Float! Total amount of precipitation in this time of day. Measured in millimeters.
precProbability - Float The probability of precipitation for this time of day. Possible values are in [0, 1].
precStrength - PrecStrength! Highest strength of precipitation for this time of day.
precType - PrecType! Precipitation corresponding to the precipitation strength.
pressure - Int! Atmospheric pressure for this time of day.
Arguments
unit - PressureUnit
soilMoisture - Float Median percentage of all soil moisture to dry soil.
soilTemperature - Int Median soil temperature at a depth of 7 cm.
Arguments
unit - TemperatureUnit
temperature - Int! Contains the temperature value that is more suitable for this time of day.
Arguments
unit - TemperatureUnit
uvIndex - Int The level of solar radiation on the Earth's surface. Possible values are in [0, 13].
visibility - Int Visibility in meters for this time of day.
waterTemperature - Int Highest water surface temperature for this time of day. Exists only for cities that are located near large bodies of water.
Arguments
unit - TemperatureUnit
waveDirection - WaveDirection The direction in which the primary wave is moving.
waveHeight - Float Significant height of combined wind waves and swell surface. Measured in meters.
wavePeriod - Int Primary wave mean period surface. Measured in seconds.
windAngle - Int! The angle of the wind direction in degrees.
windDirection - WindDirection! Wind direction for this time of day.
windGust - Float! Highest speed of wind gusts for this time of day. Measured in meters per second.
Arguments
unit - WindSpeedUnit
windSpeed - Float! Highest wind speed for this time of day. Measured in meters per second.
Arguments
unit - WindSpeedUnit
Example
{
  "avgTemperature": 123,
  "cloudiness": "CLEAR",
  "condition": "CLEAR",
  "daytime": "DAY",
  "feelsLike": 15,
  "freshSnow": 10.1,
  "humidity": 82,
  "icon": "skc_d",
  "maxSoilTemperature": 10,
  "minSoilTemperature": 10,
  "maxTemperature": 15,
  "minTemperature": 15,
  "pollution": PollutionDaypart,
  "prec": 10.1,
  "precProbability": 82,
  "precStrength": "ZERO",
  "precType": "NO_TYPE",
  "pressure": 762,
  "soilMoisture": 20,
  "soilTemperature": 10,
  "temperature": 15,
  "uvIndex": 2,
  "visibility": 987,
  "waterTemperature": 10,
  "waveDirection": "CALM",
  "waveHeight": 20,
  "wavePeriod": 20,
  "windAngle": 145,
  "windDirection": "CALM",
  "windGust": 3.5,
  "windSpeed": 3.5
}

Dayparts

Description

Summary for four parts of the day. Use this aggregations when you divide the day into morning, afternoon, evening, and night.

Fields
Field Name Description
night - Daypart! Night aggregations. Be careful, it is the night before the morning of the current day. If you need a night after the evening of the current day, take the night from the next day.
morning - Daypart! Morning aggregations.
day - Daypart! Afternoon aggregations.
evening - Daypart! Evening aggregations
Example
{
  "night": Daypart,
  "morning": Daypart,
  "day": Daypart,
  "evening": Daypart
}

Daytime

Description

Represents the time of day.

Values
Enum Value Description

DAY

NIGHT
Example
"DAY"

Float

Description

The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.

Example
987.65

Forecast

Description

The main weather forecast.

Fields
Field Name Description
days - [ForecastDay!]! Forecasts grouped by day.
Arguments
offset - Int

Allows you to skip N entries.

limit - Int

Allows you to limit the number of entries returned.
Example
{"days": [ForecastDay]}

ForecastDay

Description

Forecast for one day.

Fields
Field Name Description
hours - [ForecastHour!]! Forecast hours list for this day. Be careful, the size of this list may be less than 24 due to the decreasing frequency of forecasts for distant days.
kpIndex - Int Magnetic field Kp-index. Possible values are in [0, 10].
moon - Int! Moon phase. Possible values are in [0, 15].
oceanTideExtremums - [OceanTideExtremumItem!] The ocean water level maximums and minimums in day
Arguments
datum - Datum
parts - Dayparts! Dayparts aggregations for this day.
polar - Daytime Indicates the polar day or polar night. Skipped when the day is normal.
summary - Summary! Summary aggregations for this day.
sunrise - String! Sunrise time in format hh:mm. use sunriseTime field
sunriseTime - Time! Sunrise time.
sunriseTimestamp - Timestamp! Sunrise time.
sunriseBegin - String! Start time of the sunrise in format hh:mm. use sunriseBeginTime field
sunriseBeginTime - Time! Start time of the sunrise.
sunriseBeginTimestamp - Timestamp! Start time of the sunrise.
sunset - String! Sunset time in format hh:mm. use sunsetTime field
sunsetTime - Time! Sunset time.
sunsetTimestamp - Timestamp! Sunset time.
sunsetEnd - String! End time of the sunset in format hh:mm. use sunsetEndTime field
sunsetEndTime - Time! End time of the sunset.
sunsetEndTimestamp - Timestamp! End time of the sunset.
time - Time! Start time of the day.
timestamp - Timestamp! Start time of the day.
Example
{
  "hours": [ForecastHour],
  "kpIndex": 2,
  "moon": 2,
  "oceanTideExtremums": [OceanTideExtremumItem],
  "parts": Dayparts,
  "polar": "DAY",
  "summary": Summary,
  "sunrise": "10:30",
  "sunriseTime": "2022-10-26T12:37:53.528758212+03:00",
  "sunriseTimestamp": "1666778972",
  "sunriseBegin": "10:30",
  "sunriseBeginTime": "2022-10-26T12:37:53.528758212+03:00",
  "sunriseBeginTimestamp": "1666778972",
  "sunset": "10:30",
  "sunsetTime": "2022-10-26T12:37:53.528758212+03:00",
  "sunsetTimestamp": "1666778972",
  "sunsetEnd": "10:30",
  "sunsetEndTime": "2022-10-26T12:37:53.528758212+03:00",
  "sunsetEndTimestamp": "1666778972",
  "time": "2022-10-26T12:37:53.528758212+03:00",
  "timestamp": "1666778972"
}

ForecastHour

Description

One hour of the forecast. Can contains data from Meteum, Nowcast, and others.

Fields
Field Name Description
cloudiness - Cloudiness! Cloudiness for this hour.
cloudinessOnLevel - Int Cloud cover at the given level [%].
Arguments
level - CloudinessLevel!
condition - Condition! The general weather condition that fits to cloudiness, isThunder, precStrength and precType.
feelsLike - Int! The same temperature values may be perceived differently depending on humidity, wind strength, and ultraviolet radiation. feelsLike shows how comfortable the weather conditions are, taking into account all these factors.
Arguments
unit - TemperatureUnit
freshSnow - Float! Amount of fresh snow in this hour. Measured in millimeters.
humidity - Int! The percentage of the mass fraction of water vapor in the air to the maximum possible at the current temperature.
icon - Url! Icon describing the general weather condition. Fits to the cloudiness, isThunder, precStrength and precType.
Arguments
format - IconFormat!
theme - IconTheme
isThunder - Boolean! Flag showing the presence of a thunder for the current hour.
oceanTide - Float The height of the ocean water level relative to the specified datum in centimeters.
Arguments
datum - Datum
pollution - Pollution Atmospheric composition forecast for this hour.
prec - Float! Total amount of precipitation in this hour. Measured in millimeters.
precProbability - Float The probability of precipitation for this hour. Possible values are in [0, 1].
precStrength - PrecStrength! The strength of precipitation for this hour.
precType - PrecType! The type of precipitation for this hour.
pressure - Int! Atmospheric pressure for this hour.
Arguments
unit - PressureUnit
surfaceTemperature - Int The temperature of the surface of the Earth for this hour.
Arguments
unit - TemperatureUnit
soilMoisture - Float The percentage of all soil moisture to dry soil.
soilTemperature - Int Soil temperature at a depth of 7 cm.
Arguments
unit - TemperatureUnit
solarIrradiation - Float Average direct solar irradiation on the horizontal plane Measured in W/m^2. https://en.wikipedia.org/wiki/Solar_irradiance
temperature - Int! The temperature value in the shade at a height of 2 meters from the ground surface.
Arguments
unit - TemperatureUnit
temperatureOnHeight - TemperatureWithHeight The temperature value at the closest to the given height(in meters) from the ground surface.
Arguments
height - Int!
unit - TemperatureUnit
time - Time! Forecast horizon time.
timestamp - Timestamp! Forecast horizon time.
uvIndex - Int The level of solar radiation on the Earth's surface. Possible values are in [0, 13].
visibility - Int Visibility in meters.
waterTemperature - Int The water surface temperature. Exists only for cities that are located near large bodies of water.
Arguments
unit - TemperatureUnit
waveAngle - Int The angle in which the primary wave is moving. Measured in degrees.
waveDirection - WaveDirection The direction in which the primary wave is moving.
waveHeight - Float Significant height of combined wind waves and swell surface. Measured in meters.
wavePeriod - Int Primary wave mean period surface. Measured in seconds.
windAngle - Int! The angle of the wind direction in degrees.
windAngleOnHeight - WindAngleWithHeight The angle of the wind direction in degrees at the closest to the given height(in meters).
Arguments
height - Int!
windDirection - WindDirection! Wind direction for this hour.
windDirectionOnHeight - WindDirectionWithHeight Wind direction for this hour at the closest to the given height(in meters).
Arguments
height - Int!
windGust - Float! The speed of wind gusts. Measured in meters per second.
Arguments
unit - WindSpeedUnit
windSpeed - Float! Wind speed at a height of 10 meters from the ground surface. Measured in meters per second.
Arguments
unit - WindSpeedUnit
windSpeedOnHeight - WindSpeedWithHeight Wind speed at the closest to the given height(in meters) from the ground surface. Measured in meters per second.
Arguments
height - Int!
unit - WindSpeedUnit
Example
{
  "cloudiness": "CLEAR",
  "cloudinessOnLevel": 987,
  "condition": "CLEAR",
  "feelsLike": 15,
  "freshSnow": 10.1,
  "humidity": 82,
  "icon": "skc_d",
  "isThunder": false,
  "oceanTide": 20,
  "pollution": Pollution,
  "prec": 10.1,
  "precProbability": 82,
  "precStrength": "ZERO",
  "precType": "NO_TYPE",
  "pressure": 762,
  "surfaceTemperature": 10,
  "soilMoisture": 20,
  "soilTemperature": 10,
  "solarIrradiation": 987.65,
  "temperature": 15,
  "temperatureOnHeight": 15,
  "time": "2022-10-26T12:37:53.528758212+03:00",
  "timestamp": "1666778972",
  "uvIndex": 2,
  "visibility": 123,
  "waterTemperature": 10,
  "waveAngle": 145,
  "waveDirection": "CALM",
  "waveHeight": 20,
  "wavePeriod": 20,
  "windAngle": 145,
  "windAngleOnHeight": 145,
  "windDirection": "CALM",
  "windDirectionOnHeight": WindDirectionWithHeight,
  "windGust": 3.5,
  "windSpeed": 3.5,
  "windSpeedOnHeight": 3.5
}

IconFormat

Description

Represents the icon format. If you need a fixed-size png, use PNG_{size}. If you need only code, use CODE.

Values
Enum Value Description

CODE

PNG_24

PNG_32

PNG_48

PNG_64

PNG_96

PNG_112

PNG_128

SVG
Example
"CODE"

IconTheme

Description

Represents the theme of the icon. Be careful, some icons may not exist in a particular theme.

Values
Enum Value Description

BLACK

CIRCLE

DARK

FLAT

LIGHT

OUTLINE
Example
"BLACK"

Int

Description

The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

Example
123

Language

Description

Represents all available Weather languages. The language will be used in texts.

Values
Enum Value Description

BE

DE

EN

ES

ES_LA

FR

HU

ID

IT

KK

MK

PL

PT

PT_BR

RO

RU

SR

TR

TT

UK

UZ
Example
EN

Location

Description

All information about requested location or point.

Fields
Field Name Description
altitude - Int Altitude of this location from topography data source.
lat - Float! Latitude of this location.
lon - Float! Longitude of this location.
pressureNorm - Int! Info about normal pressure values for this location.
Arguments
unit - PressureUnit
timezone - Timezone! Timezone information for this location.
Example
{
  "altitude": 123,
  "lat": 47.27319717,
  "lon": -119.7085724,
  "pressureNorm": 762,
  "timezone": Timezone
}

Now

Description

Weather now. It can be compiled from many sources based on different business logic. If you need the actual weather values, then use the data from the Query.stations.

Fields
Field Name Description
cloudiness - Cloudiness! Current value of cloudiness.
condition - Condition! Current general weather condition that fits to cloudiness, isThunder, precStrength and precType.
daytime - Daytime! Indicates the presence of the sun right now.
feelsLike - Int! The same temperature values may be perceived differently depending on humidity, wind strength, and ultraviolet radiation. feelsLike shows how comfortable the weather conditions are, taking into account all these factors.
Arguments
unit - TemperatureUnit
humidity - Int! The percentage of the mass fraction of water vapor in the air to the maximum possible at the current temperature.
icon - Url! Icon describing the general weather condition. Fits to the cloudiness, isThunder, precStrength and precType.
Arguments
format - IconFormat!
theme - IconTheme
isThunder - Boolean! Flag showing the presence of a thunder right now (or for some short time period).
phenomCondition - PhenomCondition Current phenomenon. Skipped when weather conditions are normal.
phenomIcon - Url Icon of the phenomenon. Skipped when weather conditions are normal.
Arguments
format - IconFormat!
theme - IconTheme
pollution - Pollution The current composition of the atmosphere.
precProbability - Float! Current probability of precipitation. Possible values are in [0, 1].
precStrength - PrecStrength! Current value of precipitation strength.
precType - PrecType! Current type of precipitation.
pressure - Int! Current atmospheric pressure.
Arguments
unit - PressureUnit
season - Season! Current time of year.
soilMoisture - Float The percentage of all soil moisture to dry soil.
soilTemperature - Int Soil temperature at a depth of 7 cm.
Arguments
unit - TemperatureUnit
temperature - Int! The temperature value in the shade at a height of 2 meters from the ground surface.
Arguments
unit - TemperatureUnit
uvIndex - Int The level of solar radiation on the Earth's surface. Possible values are in [0, 13].
visibility - Int Visibility in meters.
waterTemperature - Int The water surface temperature. Exists only for cities that are located near large bodies of water.
Arguments
unit - TemperatureUnit
waveAngle - Int The angle in which the primary wave is moving. Measured in degrees.
waveDirection - WaveDirection The direction in which the primary wave is moving.
waveHeight - Float Significant height of combined wind waves and swell surface. Measured in meters.
wavePeriod - Int Primary wave mean period surface. Measured in seconds.
windAngle - Int! The angle of the wind direction in degrees.
windDirection - WindDirection! Current wind direction.
windGust - Float The speed of wind gusts.
Arguments
unit - WindSpeedUnit
windSpeed - Float! Wind speed at a height of 10 meters from the ground surface.
Arguments
unit - WindSpeedUnit
Example
{
  "cloudiness": "CLEAR",
  "condition": "CLEAR",
  "daytime": "DAY",
  "feelsLike": 15,
  "humidity": 82,
  "icon": "skc_d",
  "isThunder": true,
  "phenomCondition": "BLOWING_SNOW",
  "phenomIcon": "skc_d",
  "pollution": Pollution,
  "precProbability": 82,
  "precStrength": "ZERO",
  "precType": "NO_TYPE",
  "pressure": 762,
  "season": "SPRING",
  "soilMoisture": 20,
  "soilTemperature": 10,
  "temperature": 15,
  "uvIndex": 2,
  "visibility": 123,
  "waterTemperature": 10,
  "waveAngle": 145,
  "waveDirection": "CALM",
  "waveHeight": 20,
  "wavePeriod": 20,
  "windAngle": 145,
  "windDirection": "CALM",
  "windGust": 3.5,
  "windSpeed": 3.5
}

NowcastTimeline

Description

Weather precipitations nowcast timeline.

Fields
Field Name Description
region - String! Nowcast region.
steps - [NowcastTimelineStep!]! Nowcast timeline steps array.
Example
{
  "region": "xyz789",
  "steps": [NowcastTimelineStep]
}

NowcastTimelineStep

Description

One step of nowcast timeline.

Fields
Field Name Description
bounds - Bounds! Rectangle where nowcast data is available.
cloudiness - Cloudiness! Cloudiness for this step.
condition - Condition! The general weather condition that fits to cloudiness, precStrength and precType.
daytime - Daytime! Indicates the presence of the sun most of the time during the aggregation period.
genTime - Timestamp! Nowcast generation time. Used for synchronization when requesting tile data.
icon - Url! Icon describing the general weather condition. Fits to the cloudiness, isThunder, precStrength and precType.
Arguments
format - IconFormat!
theme - IconTheme
isLongterm - Boolean! A step for the hourly nowcast horizons.
precStrength - PrecStrength! The strength of precipitation for this step.
precType - PrecType! The type of precipitation for this step.
resolution - Resolution! Resolution of the image with data. Measured in degrees.
time - Time! Nowcast step time.
timestamp - Timestamp! Nowcast step time.
Example
{
  "bounds": Bounds,
  "cloudiness": "CLEAR",
  "condition": "CLEAR",
  "daytime": "DAY",
  "genTime": "1666778972",
  "icon": "skc_d",
  "isLongterm": -119.7085724,
  "precStrength": "ZERO",
  "precType": "NO_TYPE",
  "resolution": Resolution,
  "time": "2022-10-26T12:37:53.528758212+03:00",
  "timestamp": "1666778972"
}

OceanTideExtremumItem

Description

Ocean tide timeline point.

Fields
Field Name Description
timestamp - Timestamp! Tide timestamp.
value - Float! Tide value in centimeters.
type - OceanTideExtremumType! Extemum type.
Example
{"timestamp": "1666778972", "value": 987.65, "type": "MAX"}

OceanTideExtremumType

Description

Ocean tide extremum type.

Values
Enum Value Description

MAX

 Maximum from 12 a.m to 12 p.m or from 12 p.m. to 12 a.m.

MIN

 Minimum from 12 a.m to 12 p.m or from 12 p.m. to 12 a.m.

USUAL

 Just local extremum.
Example
"MAX"

PhenomCondition

Description

Represents the phenomenon weather conditions.

Values
Enum Value Description

BLOWING_SNOW

CONTINUOUS_HEAVY_RAIN

DRIFTING_SNOW

DRIZZLE

DUST

DUSTSTORM

DUST_SUSPENSION

FOG

FREEZING_RAIN

ICE_PELLETS

MIST

MODERATE_RAIN

SMOKE

THUNDERSTORM_WITH_DUSTSTORM

TORNADO

VOLCANIC_ASH
Example
"BLOWING_SNOW"

PointInput

Description

Input for Query.weatherByPoint. Represents a geographical point with lat and lon coordinates.

Fields
Input Field Description
lat - Float!
lon - Float!
Example
{"lat": 47.27319717, "lon": -119.7085724}

Pollutant

Description

Represents the air pollutant.

Values
Enum Value Description

CO

O3

PM10

PM2p5

SO2

NO2
Example
"CO"

Pollution

Description

Atmospheric composition forecasts.

Fields
Field Name Description
aqi - Int! Air quality index (AQI). See more here https://en.wikipedia.org/wiki/Air_quality_index
co - Float! Carbon monoxide (CO) is a colorless, highly poisonous, odorless, tasteless, flammable gas that is slightly less dense than air. See more here https://en.wikipedia.org/wiki/Carbon_monoxide
dominant - Pollutant! The pollutant that makes the greatest contribution to the calculation of AQI. You can assume that aqi is the IAQI of this pollutant.
density - Float! The density of air or atmospheric density, is the mass per unit volume of Earth's atmosphere. See more here https://en.wikipedia.org/wiki/Density_of_air
no2 - Float! The major sources of anthropogenic emissions of NO2 are combustion processes (heating, power generation, and engines in vehicles and ships). See more here https://en.wikipedia.org/wiki/Nitrogen_dioxide
o3 - Float! Ground-level ozone (O3), also known as surface-level ozone and tropospheric ozone, is a trace gas in the troposphere. See more here https://en.wikipedia.org/wiki/Ground-level_ozone
pm10 - Float! PM2.5 is a fine particulate matter, with a diameter of 2.5 micrometers (microns) or less. See more here https://en.wikipedia.org/wiki/Particulates
pm2p5 - Float! PM10 is a suspended large solid particles, with a diameter of 10 micrometers (microns) or less. See more here https://en.wikipedia.org/wiki/Particulates
so2 - Float! SO2 is a colorless gas with a pungent odor, which is formed during the burning of fossil fuels and the melting of mineral ores containing sulfur. See more here https://en.wikipedia.org/wiki/Sulfur_dioxide
Example
{
  "aqi": 31,
  "co": 132,
  "dominant": "CO",
  "density": 1.2,
  "no2": 16,
  "o3": 39,
  "pm10": 9,
  "pm2p5": 6,
  "so2": 3
}

PollutionDaypart

Description

Atmospheric composition forecasts aggregated for one time of day .

Fields
Field Name Description
maxAqi - Int! Max air quality index (AQI). See more here https://en.wikipedia.org/wiki/Air_quality_index
minAqi - Int! Min air quality index (AQI). See more here https://en.wikipedia.org/wiki/Air_quality_index
Example
{"maxAqi": 123, "minAqi": 123}

PrecStrength

Description

Represents the strength of precipitations. In ascending order: ZERO – minimum, VERY_STRONG – maximum.

Values
Enum Value Description

ZERO

WEAK

AVERAGE

STRONG

VERY_STRONG
Example
"ZERO"

PrecType

Description

Represents the type of precipitations.

Values
Enum Value Description

NO_TYPE

RAIN

SLEET

SNOW

HAIL
Example
"NO_TYPE"

PressureUnit

Description

Represents the units of measurement of the pressure value. Can be used to convert to convenient units of measurement. Default unit for this API is MM_HG.

Values
Enum Value Description

MBAR

 millibar (mbar)

MM_HG

 millimeters of mercury (mm Hg)

PASCAL

 pascal (Pa)
Example
"MBAR"

Resolution

Description

Resolution of the image with data. Measured in degrees.

Fields
Field Name Description
x - Float!
y - Float!
Example
{"x": 123.45, "y": 987.65}

Season

Description

Represents the time of the year.

Values
Enum Value Description

SPRING

SUMMER

AUTUMN

WINTER
Example
"SPRING"

Station

Description

Fact weather values from the station. Be careful, some weather values may be skipped because the station can't measure them.

Fields
Field Name Description
id - Int! Unique station ID for these values.
code - String! Unique station code for these values.
name - String! Unique station name for these values.
lat - Float! Latitude of the station location.
lon - Float! Longitude of the station location.
time - Time! Time of the last data readout in string.
timestamp - Timestamp! Time of the last data readout.
cloudiness - Cloudiness Cloudiness value from this station for this timestamp.
condition - Condition Calculated using the same logic as Weather.forecast.hours.condition, but based on the values from this station.
distance - Float! Distance between the station and the search point. Measured in kilometers.
feelsLike - Int Calculated using the same logic as Weather.forecast.hours.feelsLike, but based on the values from this station.
Arguments
unit - TemperatureUnit
humidity - Int The percentage of the mass fraction of water vapor in the air to the maximum possible at the current temperature.
icon - Url Calculated using the same logic as Weather.forecast.hours.icon, but based on the values from this station.
Arguments
format - IconFormat!
theme - IconTheme
isThunder - Boolean! Flag showing the presence of a thunder for the timestamp.
phenomCondition - PhenomCondition The phenomenon observed from this weather station.
phenomIcon - Url The phenomenon icon that fits to phenomCondition.
Arguments
format - IconFormat!
theme - IconTheme
prec - Float Total amount of precipitation. Measured in millimeters.
precProbability - Float The probability of precipitation for this hour. Possible values are in [0, 1].
precStrength - PrecStrength The strength of precipitation according to the data from the station.
precType - PrecType The type of precipitation according to the data from the station.
pressure - Int Atmospheric pressure for this hour.
Arguments
unit - PressureUnit
temperature - Int The temperature value in the shade at a height of 2 meters from the ground surface.
Arguments
unit - TemperatureUnit
waterTemperature - Int The water surface temperature. Exists only for cities that are located near large bodies of water.
Arguments
unit - TemperatureUnit
windAngle - Int The angle of the wind direction in degrees.
windDirection - WindDirection Wind direction according to the data from the station.
windSpeed - Float Wind speed at a height of 10 meters from the ground surface.
Arguments
unit - WindSpeedUnit
Example
{
  "id": 987,
  "code": "xyz789",
  "name": "xyz789",
  "lat": 47.27319717,
  "lon": -119.7085724,
  "time": "2022-10-26T12:37:53.528758212+03:00",
  "timestamp": "1666778972",
  "cloudiness": "CLEAR",
  "condition": "CLEAR",
  "distance": 123.45,
  "feelsLike": 15,
  "humidity": 82,
  "icon": "skc_d",
  "isThunder": true,
  "phenomCondition": "BLOWING_SNOW",
  "phenomIcon": "skc_d",
  "prec": 10.1,
  "precProbability": 82,
  "precStrength": "ZERO",
  "precType": "NO_TYPE",
  "pressure": 762,
  "temperature": 15,
  "waterTemperature": 10,
  "windAngle": 145,
  "windDirection": "CALM",
  "windSpeed": 3.5
}

String

Description

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

Example
"xyz789"

Summary

Description

Summary for day and night parts only. Use this aggregations when you divide the day into two parts: day and night.

Fields
Field Name Description
night - Daypart! Night aggregations. Be careful, it is the night before the morning of the current day. If you need a night after the evening of the current day, take the night from the next day.
day - Daypart! Aggregations for the entire civil day.
Example
{"night": Daypart, "day": Daypart}

TemperatureUnit

Description

Represents the units of measurement of the temperature value. Can be used to convert to convenient units of measurement. Default unit for this API is CELSIUS.

Values
Enum Value Description

CELSIUS

 degrees Celsius

FAHRENHEIT

 Fahrenheit degree
Example
"CELSIUS"

TemperatureWithHeight

Description

Response of temperatureOnHeight function.

Fields
Field Name Description
temperature - Int! Temperature at the provided height.
height - Int! The closest to the specified height.
Example
{"temperature": 15, "height": 123}

Tiles

Description

Timelines for tiled data.

Fields
Field Name Description
humidity - TilesTimeline!
prec - TilesTimeline!
pressureMm - TilesTimeline!
snowDepth - TilesTimeline!
soilMoisture - TilesTimeline!
soilTemperature - TilesTimeline!
surfaceTemperature - TilesTimeline!
temperature - TilesTimeline!
waterTemperature - TilesTimeline!
windSpeed - TilesTimeline!
Example
{
  "humidity": 82,
  "prec": 10.1,
  "pressureMm": 762,
  "snowDepth": TilesTimeline,
  "soilMoisture": 20,
  "soilTemperature": 10,
  "surfaceTemperature": 10,
  "temperature": 15,
  "waterTemperature": 10,
  "windSpeed": 3.5
}

TilesTimeline

Description

Weather tiles timeline.

Fields
Field Name Description
steps - [TimelineStep!]! Timeline steps array.
Example
{"steps": [TimelineStep]}

Time

Description

Time in ISO 8601 format 2021-03-30T04:10:02Z.

Example
"2022-10-26T12:37:53.528758212+03:00"

TimeRange

Description

Time interval [from, to].

Fields
Input Field Description
from - Timestamp!
to - Timestamp!
Example
{"from": "1666778972", "to": "1666778972"}

TimelineStep

Description

One step of timeline.

Fields
Field Name Description
bounds - Bounds! Rectangle where data is available.
genTime - Timestamp! Data generation time. Used for synchronization when requesting tile data.
resolution - Resolution! Resolution of the image with data. Measured in degrees.
time - Time! Timeline step time.
timestamp - Timestamp! Timeline step time.
value - Float! Timeline step value.
Example
{
  "bounds": Bounds,
  "genTime": "1666778972",
  "resolution": Resolution,
  "time": "2022-10-26T12:37:53.528758212+03:00",
  "timestamp": "1666778972",
  "value": 987.65
}

Timestamp

Description

Unix timestamp for UTC timezone.

Example
"1666778972"

Timezone

Description

Information that defines the time zone.

Fields
Field Name Description
abbr - String! A well-known abbreviation.
dst - Boolean! Indicates that the timezone is currently daylight saving time (DST).
name - String! Name from IANA time zone database.
offset - Int! Offset in seconds (can be negative).
Example
{"abbr": "BST", "dst": true, "name": "Europe/London", "offset": 3600}

Url

Description

Always URL with schema, host, path. Query parameters are also possible.

Example
Url

WaveDirection

Description

Represents the direction of the wave in terms of the cardinal directions. To determine the direction more accurately, use waveAngle. The value 0 of waveAngle corresponds to NORTH, 180 – SOUTH. The enumeration value CALM is possible when the waveHeight is near 0.

Values
Enum Value Description

CALM

NORTH

NORTH_EAST

EAST

SOUTH_EAST

SOUTH

SOUTH_WEST

WEST

NORTH_WEST
Example
"CALM"

Weather

Description

Generic object containing all available types of weather data.

Fields
Field Name Description
climate - Climate! Average weather statistics for 10 years.
forecast - Forecast! The main weather forecast.
location - Location! All information about requested location or point.
now - Now! Weather now.
nowcast - NowcastTimeline! Weather precipitations nowcast timeline.
url - Url! URL to page for the current request.
Example
{
  "climate": Climate,
  "forecast": Forecast,
  "location": Location,
  "now": Now,
  "nowcast": NowcastTimeline,
  "url": "https://meteum.ai/london"
}

WindAngleWithHeight

Description

Response of windAngleOnHeight function.

Fields
Field Name Description
windAngle - Int! Wind angle at the provided height.
height - Int! The closest to the specified height.
Example
{"windAngle": 145, "height": 987}

WindDirection

Description

Represents the direction of the wind in terms of the cardinal directions. To determine the direction more accurately, use windAngle. The value 0 of windAngle corresponds to NORTH, 180 – SOUTH. The enumeration value CALM is possible when the windSpeed is 0.

Values
Enum Value Description

CALM

NORTH

NORTH_EAST

EAST

SOUTH_EAST

SOUTH

SOUTH_WEST

WEST

NORTH_WEST
Example
"CALM"

WindDirectionWithHeight

Description

Response of windDirectionOnHeight function.

Fields
Field Name Description
windDirection - WindDirection! Wind direction at the provided height.
height - Int! The closest to the specified height.
Example
{"windDirection": "CALM", "height": 123}

WindSpeedUnit

Description

Represents the units of measurement of the wind speed value. Can be used to convert to convenient units of measurement. Default unit for this API is METERS_PER_SECOND.

Values
Enum Value Description

KILOMETERS_PER_HOUR

 kilometers per hour

METERS_PER_SECOND

 meters per second

MILES_PER_HOUR

 miles per hour
Example
"KILOMETERS_PER_HOUR"

WindSpeedWithHeight

Description

Response of windSpeedOnHeight function.

Fields
Field Name Description
windSpeed - Float! Wind speed at the provided height.
height - Int! The closest to the specified height.
Example
{"windSpeed": 3.5, "height": 987}
In this article: