Start Trial API 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": "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": 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": 987.65,
        "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 for point with lat and lon coordinates.

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
      dewPoint
      feelsLike
      heatIndex
      humidity
      iceAreaFraction
      iceThickness
      icon
      isThunder
      kpIndex
      leafWetnessIndex
      meanSeaLevelPressure
      phenomCondition
      phenomIcon
      pollution {
        ...PollutionFragment
      }
      precProbability
      precStrength
      precType
      pressure
      pressureInHg
      seaCurrentAngle
      seaCurrentDirection
      seaCurrentSpeed
      season
      snowDepth
      soilMoisture
      soilTemperature
      space {
        ...SpaceFragment
      }
      swellAngle
      swellDirection
      swellHeight
      swellPeriod
      temperature
      uv
      uvIndex
      visibility
      waterTemperature
      waveAngle
      waveDirection
      waveHeight
      waveMaxHeight
      wavePeriod
      windAngle
      windChill
      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
time - Time! Start time of the day.
timestamp - Timestamp! Start time of the day.
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,
  "time": "2022-10-26T12:37:53.528758212+03:00",
  "timestamp": "1666778972",
  "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
rainyDays - Int! The number of days with rain for this month.
snowyDays - Int! The number of days with snow for this month.
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,
  "rainyDays": 123,
  "snowyDays": 123,
  "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. Read more: https://koeppen-geiger.vu-wien.ac.at/present.htm

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

ClimateZoneCode

Description

Represents codes of climate zones. See more here https://koeppen-geiger.vu-wien.ac.at/present.htm

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

 0 oktas.

PARTLY

 1-2 oktas.

SIGNIFICANT

 3-4 oktas.

CLOUDY

 5-7 oktas.

OVERCAST

 8 oktas.
Example
"CLEAR"

CloudinessWithHeight

Description

Response of cloudinessOnHeight function.

Fields
Field Name Description
cloudiness - Int! Cloudiness at the provided height.
height - Int! The closest to the specified height.
Example
{"cloudiness": 123, "height": 987}

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.

Units: mm Possible values: [0, +Infinity)

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.

Units: % Possible values: [0, 100]

iceAreaFraction - Float

Sea ice area fraction.

Possible values: [0, 1]
iceThickness - Float

Ice thickness.

Units: m Possible values: [0, +Infinity)

icon - Url! Icon describing the general weather condition. Fits to the cloudiness, precStrength and precType.
Arguments
format - IconFormat!
theme - IconTheme
leafWetnessPercent - Int What percentage of the daypart leafWetnessIndex is equal to true.
maxDewPoint - Float Highest dew point value for this time of day.
Arguments
unit - TemperatureUnit
maxKpIndex - Float

Max planetary K-index for this time of day. If gScale true scale K-index to NOAA Space Weather Scales. More information about G-Scale: https://www.swpc.noaa.gov/noaa-scales-explanation

Possible values: [0, 5] if gScale else [0, 9]
Arguments
gScale - Boolean
maxSoilTemperature - Int Highest soil temperature at a depth of 7 cm.
Arguments
unit - TemperatureUnit
maxTemperature - Int! Highest temperature value for this time of day.
Arguments
unit - TemperatureUnit
meanSeaLevelPressure - Int! Atmospheric pressure on mean sea level for this time of day.
Arguments
unit - PressureUnit
minSoilTemperature - Int Lowest soil temperature at a depth of 7 cm.
Arguments
unit - TemperatureUnit
minTemperature - Int! Lowest temperature value for this time of day.
Arguments
unit - TemperatureUnit
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 - PollutionDaypart Atmospheric composition forecast for this time of day.
prec - Float!

Total amount of precipitation in this time of day.

Units: mm Possible values: [0, +Infinity)

precProbability - Float

The probability of precipitation for this time of day.

Possible values: [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
pressureInHg - Float! Atmospheric pressure for this time of day in inHg.
seaCurrentDirection - SeaCurrentDirection Mode of sea current direction from.
seaCurrentSpeed - Float

Maximum of sea current speed.

Units: cm/s Possible values: [0, +Infinity)

snowDepth - Int

Snow depth.

Units: mm Possible values: [0, +Infinity)

soilMoisture - Float

Median fraction of all soil moisture to dry soil.

Possible values: [0, 1]
soilTemperature - Int Median soil temperature at a depth of 7 cm.
Arguments
unit - TemperatureUnit
swellDirection - SwellDirection Mode of swell wave direction from.
swellHeight - Float

Average spectral significant primary swell wave height

Units: m Possible values: [0, +Infinity)

swellPeriod - Int

Average spectral moments (0,1) primary swell wave period

Units: s Possible values: [0, +Infinity)

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: [0, 11]
visibility - Int

Visibility for this time of day.

Units: m Possible values: [0, 10000]

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
waveAngle - Int

The angle in which the primary wave is moving.

Units: ° Possible values: [0, 359]

waveDirection - WaveDirection The direction in which the primary wave is moving.
waveHeight - Float

Significant height of combined wind waves and swell surface.

Units: m Possible values: [0, +Infinity)

waveMaxHeight - Float

Maximum height of combined wind waves and swell surface.

Units: m Possible values: [0, +Infinity)

wavePeriod - Int

Primary wave mean period surface.

Units: s Possible values: [0, +Infinity)

windAngle - Int!

The angle of the wind direction.

Units: ° Possible values: [0, 359]

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,
  "iceAreaFraction": 987.65,
  "iceThickness": 987.65,
  "icon": "skc_d",
  "leafWetnessPercent": 123,
  "maxDewPoint": 987.65,
  "maxKpIndex": 987.65,
  "maxSoilTemperature": 10,
  "maxTemperature": 15,
  "meanSeaLevelPressure": 123,
  "minSoilTemperature": 10,
  "minTemperature": 15,
  "phenomCondition": "BLOWING_SNOW",
  "phenomIcon": "skc_d",
  "pollution": PollutionDaypart,
  "prec": 10.1,
  "precProbability": 82,
  "precStrength": "ZERO",
  "precType": "NO_TYPE",
  "pressure": 762,
  "pressureInHg": 762,
  "seaCurrentDirection": "CALM",
  "seaCurrentSpeed": 123.45,
  "snowDepth": 987,
  "soilMoisture": 20,
  "soilTemperature": 10,
  "swellDirection": "CALM",
  "swellHeight": 987.65,
  "swellPeriod": 123,
  "temperature": 15,
  "uvIndex": 2,
  "visibility": 987,
  "waterTemperature": 10,
  "waveAngle": 145,
  "waveDirection": "CALM",
  "waveHeight": 20,
  "waveMaxHeight": 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"

DustStormStrength

Description

Represents the strength of dust storm.

Values
Enum Value Description

ZERO

 No risk of dust storm.

WEAK

 Risk of dust (without storm).

AVERAGE

 Risk of dust storm.

STRONG

 Risk of strong dust storm.
Example
"ZERO"

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 (biomet in REST). Possible values are in [0, 9]. Calculated as maximum of Daypart.maxKpIndex. Use maxKpIndex
maxKpIndex - Float

Planetary K-index. More information: https://www.swpc.noaa.gov/phenomena/geomagnetic-storms If gScale true scale K-index to NOAA Space Weather Scales. More information about G-Scale: https://www.swpc.noaa.gov/noaa-scales-explanation

Possible values: [0, 5] if gScale else [0, 9]
Arguments
gScale - Boolean
moon - Int!

Moon phase.

Possible values: [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,
  "maxKpIndex": 123.45,
  "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
accumulatedPrec - Float!

Total amount of precipitation in this hour.

Units: mm Possible values: [0, +Infinity)

cloudiness - Cloudiness! Cloudiness for this hour.
cloudinessOnHeight - CloudinessWithHeight Cloud cover [%] at the closest to the given height (in meters). from the ground surface. Use height: 0 if you need total cloud cover. Read more about levels (low, middle or high): https://www.metoffice.gov.uk/weather/learn-about/weather/types-of-weather/clouds/
Arguments
height - Int!
condition - Condition! The general weather condition that fits to cloudiness, isThunder, precStrength and precType.
dewPoint - Float The dew point value in the shade at a height of 2 meters from the ground surface.
Arguments
unit - TemperatureUnit
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.

Units: mm Possible values: [0, +Infinity)

heatIndex - Float! An index that combines air temperature and relative humidity, in shaded areas, to posit a human-perceived equivalent temperature. More information: https://www.wpc.ncep.noaa.gov/html/heatindex_equation.shtml
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.

Units: % Possible values: [0, 100]

iceAreaFraction - Float

Sea ice area fraction.

Possible values: [0, 1]
iceThickness - Float

Ice thickness.

Units: m Possible values: [0, +Infinity)

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.
kpIndex - Float

Planetary K-index. More information: https://www.swpc.noaa.gov/phenomena/geomagnetic-storms If gScale true scale K-index to NOAA Space Weather Scales. More information about G-Scale: https://www.swpc.noaa.gov/noaa-scales-explanation

Possible values: [0, 5] if gScale else [0, 9]
Arguments
gScale - Boolean
leafWetnessIndex - Boolean Indicates whether there is moisture on leaves (true) or not (false). This value is calculated based on factors such as precipitation, air temperature, surface temperature, and dew point.
meanSeaLevelPressure - Int! Atmospheric pressure on mean sea level for this hour.
Arguments
unit - PressureUnit
oceanTide - Float

The height of the ocean water level relative to the specified datum in centimeters.

Units: cm Possible values: (-Infinity, +Infinity)

Arguments
datum - Datum
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 Atmospheric composition forecast for this hour.
prec - Float!

Average amount of precipitation in this hour. For total amount use accumulatedPrec.

Units: mm Possible values: [0, +Infinity)

precProbability - Float

The probability of precipitation for this hour.

Possible values: [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
pressureInHg - Float! Atmospheric pressure for this hour in inHg.
referenceEvapotranspiration - Float

Preceding 1h or 3h evaporative water flux sum.

Units: mm/h Possible values: [0, +Infinity)

seaCurrentAngle - Int

Sea current angle from.

Units: degrees Possible values: [0, 360)

seaCurrentDirection - SeaCurrentDirection Sea current direction from.
seaCurrentSpeed - Float

Sea current speed.

Units: cm/s Possible values: [0, +Infinity)

seaSalinity - Float

Sea water salinity.

Units: PSU Possible values: [0, 1000]

surfaceTemperature - Int The temperature of the surface of the Earth for this hour.
Arguments
unit - TemperatureUnit
snowDepth - Int

Snow depth.

Units: mm Possible values: [0, +Infinity)

soilMoisture - Float

The fraction of all soil moisture to dry soil.

Possible values: [0, 1]
soilTemperature - Int Soil temperature at a depth of 7 cm.
Arguments
unit - TemperatureUnit
solarIrradiation - Float Average direct solar irradiation on the horizontal plane https://en.wikipedia.org/wiki/Solar_irradiance
Arguments
unit - SolarIrradiationUnit
swellAngle - Int

Mean primary swell wave angle from.

Units: degrees Possible values: [0, 360)

swellDirection - SwellDirection Mean primary swell wave direction from.
swellHeight - Float

Spectral significant primary swell wave height.

Units: m Possible values: [0, +Infinity)

swellPeriod - Int

Spectral moments (0, 1) primary swell wave period.

Units: s Possible values: [0, +Infinity)

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.
uv - Int

The level of solar radiation on the Earth's surface. Open-ended version of uvIndex parameter.

Possible values: [0, +Infinity)
uvIndex - Int

The level of solar radiation on the Earth's surface.

Possible values: [0, 11]
visibility - Int

Visibility.

Units: m Possible values: [0, 10000]

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.

Units: ° Possible values: [0, 359]

waveDirection - WaveDirection The direction in which the primary wave is moving.
waveHeight - Float

Significant height of combined wind waves and swell surface.

Units: m Possible values: [0, +Infinity)

waveMaxHeight - Float

Maximum height of combined wind waves and swell surface.

Units: m Possible values: [0, +Infinity)

wavePeriod - Int

Primary wave mean period surface.

Units: s Possible values: [0, +Infinity)

windAngle - Int!

The angle of the wind direction.

Units: ° Possible values: [0, 359]

windAngleOnHeight - WindAngleWithHeight The angle of the wind direction in degrees at the closest to the given height (in meters).
Arguments
height - Int!
windChill - Float! The air temperature feels like to the human skin due to the combination of cold temperatures and winds blowing on exposed skin. If temperature is above 10°C or windSpeed is less than or equal to 3 mph then temperature value will be returned. More information: https://www.weather.gov/safety/cold-wind-chill-chart
Arguments
unit - TemperatureUnit
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
{
  "accumulatedPrec": 47.27319717,
  "cloudiness": "CLEAR",
  "cloudinessOnHeight": CloudinessWithHeight,
  "condition": "CLEAR",
  "dewPoint": 987.65,
  "feelsLike": 15,
  "freshSnow": 10.1,
  "heatIndex": 987.65,
  "humidity": 82,
  "iceAreaFraction": 987.65,
  "iceThickness": 987.65,
  "icon": "skc_d",
  "isThunder": true,
  "kpIndex": 2,
  "leafWetnessIndex": false,
  "meanSeaLevelPressure": 987,
  "oceanTide": 20,
  "phenomCondition": "BLOWING_SNOW",
  "phenomIcon": "skc_d",
  "pollution": Pollution,
  "prec": 10.1,
  "precProbability": 82,
  "precStrength": "ZERO",
  "precType": "NO_TYPE",
  "pressure": 762,
  "pressureInHg": 762,
  "referenceEvapotranspiration": 987.65,
  "seaCurrentAngle": 987,
  "seaCurrentDirection": "CALM",
  "seaCurrentSpeed": 987.65,
  "seaSalinity": 987.65,
  "surfaceTemperature": 10,
  "snowDepth": 987,
  "soilMoisture": 20,
  "soilTemperature": 10,
  "solarIrradiation": 987.65,
  "swellAngle": 987,
  "swellDirection": "CALM",
  "swellHeight": 987.65,
  "swellPeriod": 987,
  "temperature": 15,
  "temperatureOnHeight": 15,
  "time": "2022-10-26T12:37:53.528758212+03:00",
  "timestamp": "1666778972",
  "uv": 987,
  "uvIndex": 2,
  "visibility": 987,
  "waterTemperature": 10,
  "waveAngle": 145,
  "waveDirection": "CALM",
  "waveHeight": 20,
  "waveMaxHeight": 20,
  "wavePeriod": 20,
  "windAngle": 145,
  "windAngleOnHeight": 145,
  "windChill": 987.65,
  "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
987

Language

Description

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

Values
Enum Value Description

BE

BG

DE

EN

ES

ES_LA

 use ES_419

ES_419

FR

HI

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.
dewPoint - Float The dew point value in the shade at a height of 2 meters from the ground surface.
Arguments
unit - TemperatureUnit
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
heatIndex - Float! An index that combines air temperature and relative humidity, in shaded areas, to posit a human-perceived equivalent temperature. More information: https://www.wpc.ncep.noaa.gov/html/heatindex_equation.shtml
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.

Units: % Possible values: [0, 100]

iceAreaFraction - Float

Sea ice area fraction.

Possible values: [0, 1]
iceThickness - Float

Ice thickness.

Units: m Possible values: [0, +Infinity)

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).
kpIndex - Float

Planetary K-index. More information: https://www.swpc.noaa.gov/phenomena/geomagnetic-storms If gScale true scale K-index to NOAA Space Weather Scales. More information about G-Scale: https://www.swpc.noaa.gov/noaa-scales-explanation

Possible values: [0, 5] if gScale else [0, 9]
Arguments
gScale - Boolean
leafWetnessIndex - Boolean Indicates whether there is moisture on leaves (true) or not (false). This value is calculated based on factors such as precipitation, air temperature, surface temperature, and dew point.
meanSeaLevelPressure - Int! Current atmospheric pressure on mean sea level.
Arguments
unit - PressureUnit
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: [0, 1]
precStrength - PrecStrength! Current value of precipitation strength.
precType - PrecType! Current type of precipitation.
pressure - Int! Current atmospheric pressure.
Arguments
unit - PressureUnit
pressureInHg - Float! Current atmospheric pressure in inHg.
seaCurrentAngle - Int

Sea current angle from.

Units: degrees Possible values: [0, 360)

seaCurrentDirection - SeaCurrentDirection Sea current direction from.
seaCurrentSpeed - Float

Sea current speed.

Units: cm/s Possible values: [0, +Infinity)

season - Season! Current time of year.
snowDepth - Int

Snow depth.

Units: mm Possible values: [0, +Infinity)

soilMoisture - Float

The fraction of all soil moisture to dry soil.

Possible values: [0, 1]
soilTemperature - Int Soil temperature at a depth of 7 cm.
Arguments
unit - TemperatureUnit
space - Space Space weather
swellAngle - Int

Mean primary swell wave angle from.

Units: degrees Possible values: [0, 360)

swellDirection - SwellDirection Mean primary swell wave direction from.
swellHeight - Float

Spectral significant primary swell wave height.

Units: m Possible values: [0, +Infinity)

swellPeriod - Int

Spectral moments (0, 1) primary swell wave period.

Units: s Possible values: [0, +Infinity)

temperature - Int! The temperature value in the shade at a height of 2 meters from the ground surface.
Arguments
unit - TemperatureUnit
uv - Int

The level of solar radiation on the Earth's surface. Open-ended version of uvIndex parameter.

Possible values: [0, +Infinity)
uvIndex - Int

The level of solar radiation on the Earth's surface.

Possible values: [0, 11]
visibility - Int

Visibility.

Units: m Possible values: [0, 10000]

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.

Units: ° Possible values: [0, 359]

waveDirection - WaveDirection The direction in which the primary wave is moving.
waveHeight - Float

Significant height of combined wind waves and swell surface.

Units: m Possible values: [0, +Infinity)

waveMaxHeight - Float

Maximum height of combined wind waves and swell surface.

Units: m Possible values: [0, +Infinity)

wavePeriod - Int

Primary wave mean period surface.

Units: s Possible values: [0, +Infinity)

windAngle - Int!

The angle of the wind direction.

Units: ° Possible values: [0, 359]

windChill - Float! The air temperature feels like to the human skin due to the combination of cold temperatures and winds blowing on exposed skin. If temperature is above 10°C or windSpeed is less than or equal to 3 mph then temperature value will be returned. More information: https://www.weather.gov/safety/cold-wind-chill-chart
Arguments
unit - TemperatureUnit
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",
  "dewPoint": 987.65,
  "feelsLike": 15,
  "heatIndex": 123.45,
  "humidity": 82,
  "iceAreaFraction": 123.45,
  "iceThickness": 987.65,
  "icon": "skc_d",
  "isThunder": true,
  "kpIndex": 2,
  "leafWetnessIndex": true,
  "meanSeaLevelPressure": 987,
  "phenomCondition": "BLOWING_SNOW",
  "phenomIcon": "skc_d",
  "pollution": Pollution,
  "precProbability": 82,
  "precStrength": "ZERO",
  "precType": "NO_TYPE",
  "pressure": 762,
  "pressureInHg": 762,
  "seaCurrentAngle": 123,
  "seaCurrentDirection": "CALM",
  "seaCurrentSpeed": 123.45,
  "season": "SPRING",
  "snowDepth": 123,
  "soilMoisture": 20,
  "soilTemperature": 10,
  "space": Space,
  "swellAngle": 123,
  "swellDirection": "CALM",
  "swellHeight": 123.45,
  "swellPeriod": 123,
  "temperature": 15,
  "uv": 123,
  "uvIndex": 2,
  "visibility": 987,
  "waterTemperature": 10,
  "waveAngle": 145,
  "waveDirection": "CALM",
  "waveHeight": 20,
  "waveMaxHeight": 20,
  "wavePeriod": 20,
  "windAngle": 145,
  "windChill": 987.65,
  "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! For hourly precipitation will have the value true.
isLongtermCfs - Boolean! For 6-hour precipitation will have the value true.
prec - Float

Intensity of precipitation per hour.

Units: mm/h Possible values: [0, +Infinity)

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,
  "isLongtermCfs": -119.7085724,
  "prec": 10.1,
  "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.

Units: cm Possible values: (-Infinity, +Infinity)

type - OceanTideExtremumType! Extemum type.
Example
{"timestamp": "1666778972", "value": 123.45, "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://www.airnow.gov/aqi/aqi-basics/

Possible values: [0, 500]
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://www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health

Units: µg⋅m⁻³ Possible values: [0, +Infinity)

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. See more here https://www.airnow.gov/aqi/aqi-basics/
density - Float!

The density of air or atmospheric density, is the mass per unit volume of Earth's atmosphere.

Units: kg⋅m⁻³ Possible values: [0, +Infinity)

dustStormStrength - DustStormStrength! Strength of a duststorm. Based on wind speed and amount of dust particles in the atmosphere.
iaqi - Int!

The individual AQI for a specific pollutant. See more here https://www.airnow.gov/aqi/aqi-basics/

You can request multiple values of this field, using following syntax:

coIAQI: iaqi(pollutant: CO)

Possible values: [0, 500]
Arguments
pollutant - Pollutant!
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://www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health

Units: µg⋅m⁻³ Possible values: [0, +Infinity)

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://www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health

Units: µg⋅m⁻³ Possible values: [0, +Infinity)

pm10 - Float!

PM2.5 is a fine particulate matter, with a diameter of 2.5 micrometers (microns) or less. See more here https://www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health

Units: µg⋅m⁻³ Possible values: [0, +Infinity)

pm2p5 - Float!

PM10 is a suspended large solid particles, with a diameter of 10 micrometers (microns) or less. See more here https://www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health

Units: µg⋅m⁻³ Possible values: [0, +Infinity)

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://www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health

Units: µg⋅m⁻³ Possible values: [0, +Infinity)

Example
{
  "aqi": 31,
  "co": 132,
  "dominant": "CO",
  "density": 1.2,
  "dustStormStrength": "ZERO",
  "iaqi": 123,
  "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).
minAqi - Int! Min air quality index (AQI).
Example
{"maxAqi": 987, "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

IN_HG

inches of mercury (in Hg)

Possible values: [20, 40]

MBAR

millibars (mbar)

Possible values: [800, 1200]

MM_HG

millimeters of mercury (mm Hg)

Possible values: [600, 900]

PASCAL

hectopascals (hPa)

Possible values: [800, 1200]
Example
"IN_HG"

Resolution

Description

Resolution of the image with data. Measured in degrees.

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

SeaCurrentDirection

Description

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

Values
Enum Value Description

CALM

NORTH

NORTH_EAST

EAST

SOUTH_EAST

SOUTH

SOUTH_WEST

WEST

NORTH_WEST
Example
"CALM"

Season

Description

Represents the time of the year.

Values
Enum Value Description

SPRING

SUMMER

AUTUMN

WINTER
Example
"SPRING"

SolarIrradiationUnit

Description

Represents the units of measurement of the solar radiation value. Can be used to convert to convenient units of measurement. Default unit for this API is WATTS_PER_SQUARE_METER.

Values
Enum Value Description

WATTS_PER_SQUARE_METER

W⋅m⁻²

Possible values: [0, +Infinity)

MEGAJOULES_PER_SQUARE_METER_PER_HOUR

MJ⋅m⁻²⋅h

Possible values: [0, +Infinity)
Example
"WATTS_PER_SQUARE_METER"

Space

Description

Space weather vars obtained with NOAA SWPC

Fields
Field Name Description
solarWindSpeed - Float! Solar wind speed in km/sec. More information: https://www.swpc.noaa.gov/phenomena/solar-wind
solarWindDensity - Float! Solar wind density in p/cm3. More information: https://www.swpc.noaa.gov/phenomena/solar-wind
imfBx - Float! Interplanetary Magnetic Field in nT. Bx axis. More information: https://www.spaceweatherlive.com/en/help/the-interplanetary-magnetic-field-imf.html
imfBy - Float! Interplanetary Magnetic Field in nT. By axis. More information: https://www.spaceweatherlive.com/en/help/the-interplanetary-magnetic-field-imf.html
imfBz - Float! Interplanetary Magnetic Field in nT. Bz axis. More information: https://www.spaceweatherlive.com/en/help/the-interplanetary-magnetic-field-imf.html
imfBt - Float! Interplanetary Magnetic Field in nT. Bt - the total strength of the IMF. More information: https://www.spaceweatherlive.com/en/help/the-interplanetary-magnetic-field-imf.html
Example
{
  "solarWindSpeed": 987.65,
  "solarWindDensity": 123.45,
  "imfBx": 123.45,
  "imfBy": 123.45,
  "imfBz": 987.65,
  "imfBt": 123.45
}

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": 123,
  "code": "abc123",
  "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": 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
}

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
"abc123"

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}

SwellDirection

Description

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

Values
Enum Value Description

CALM

NORTH

NORTH_EAST

EAST

SOUTH_EAST

SOUTH

SOUTH_WEST

WEST

NORTH_WEST
Example
"CALM"

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

Celsius degree.

Possible values: [-273.15, +Infinity)

FAHRENHEIT

Fahrenheit degree.

Possible values: [-459,67, +Infinity)
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": 987}

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.

Units: ° Possible values: [0, 359]

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": 987}

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

KNOTS

 nautical miles per hour (knots)

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": 123}
Previous
Geosuggest
Next
All parameters