Full GraphQL specification - Available data

Useful links
Queries
Types

Queries

serverTime

Example

Query

query serverTime {
  serverTime
}

Response

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

serverTimestamp

Example

Query

query serverTimestamp {
  serverTimestamp
}

Response

{"data": {"serverTimestamp": "1666778972"}}

stations

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

stationsByTimeRange

Description

List of weather stations values by time range.

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

tiles

Description

Timelines for tiled data for point with lat and lon coordinates.

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.

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
      icon
      isThunder
      kpIndex
      leafWetnessIndex
      meanSeaLevelPressure
      phenomCondition
      phenomIcon
      pollution {
        ...PollutionFragment
      }
      precProbability
      precStrength
      precType
      pressure
      pressureInHg
      seaCurrentAngle
      seaCurrentDirection
      seaCurrentSpeed
      season
      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

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

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

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

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

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

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]`
`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)`
`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
`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": 987,
  "cloudiness": "CLEAR",
  "condition": "CLEAR",
  "daytime": "DAY",
  "feelsLike": 15,
  "freshSnow": 10.1,
  "humidity": 82,
  "icon": "skc_d",
  "leafWetnessPercent": 123,
  "maxDewPoint": 123.45,
  "maxKpIndex": 987.65,
  "maxSoilTemperature": 10,
  "maxTemperature": 15,
  "meanSeaLevelPressure": 987,
  "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": 987.65,
  "soilMoisture": 20,
  "soilTemperature": 10,
  "swellDirection": "CALM",
  "swellHeight": 987.65,
  "swellPeriod": 123,
  "temperature": 15,
  "uvIndex": 2,
  "visibility": 987,
  "waterTemperature": 10,
  "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

Values

Enum Value	Description
`DAY`
`NIGHT`

Example

"DAY"

DustStormStrength

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

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

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]`. Use maximum of `dayparts.maxKpIndex`
`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,
  "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]`
`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)`
`surfaceTemperature` - Int	The temperature of the surface of the Earth for this hour.
Arguments `unit` - TemperatureUnit
`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,
  "icon": "skc_d",
  "isThunder": true,
  "kpIndex": 2,
  "leafWetnessIndex": true,
  "meanSeaLevelPressure": 123,
  "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": 123.45,
  "seaCurrentAngle": 123,
  "seaCurrentDirection": "CALM",
  "seaCurrentSpeed": 987.65,
  "surfaceTemperature": 10,
  "soilMoisture": 20,
  "soilTemperature": 10,
  "solarIrradiation": 123.45,
  "swellAngle": 123,
  "swellDirection": "CALM",
  "swellHeight": 123.45,
  "swellPeriod": 123,
  "temperature": 15,
  "temperatureOnHeight": 15,
  "time": "2022-10-26T12:37:53.528758212+03:00",
  "timestamp": "1666778972",
  "uv": 123,
  "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.

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]`
`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.
`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": 123.45,
  "feelsLike": 15,
  "heatIndex": 123.45,
  "humidity": 82,
  "icon": "skc_d",
  "isThunder": false,
  "kpIndex": 2,
  "leafWetnessIndex": true,
  "meanSeaLevelPressure": 123,
  "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",
  "soilMoisture": 20,
  "soilTemperature": 10,
  "space": Space,
  "swellAngle": 123,
  "swellDirection": "CALM",
  "swellHeight": 123.45,
  "swellPeriod": 123,
  "temperature": 15,
  "uv": 123,
  "uvIndex": 2,
  "visibility": 123,
  "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": "abc123",
  "steps": [NowcastTimelineStep]
}

NowcastTimelineStep

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`.
`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,
  "precStrength": "ZERO",
  "precType": "NO_TYPE",
  "resolution": Resolution,
  "time": "2022-10-26T12:37:53.528758212+03:00",
  "timestamp": "1666778972"
}

OceanTideExtremumItem

Fields

Field Name Description

timestamp - Timestamp! Tide timestamp.

Field Name	Description
`timestamp` - Timestamp!	Tide timestamp.
`value` - Float!	Tide value. Units: `cm` Possible values: `(-Infinity, +Infinity)`
`type` - OceanTideExtremumType!	Extemum type.

value - Float!

Tide value.

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

type - OceanTideExtremumType! Extemum type.

Example

{"timestamp": "1666778972", "value": 123.45, "type": "MAX"}

OceanTideExtremumType

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

Values

Enum Value	Description
`CO`
`O3`
`PM10`
`PM2p5`
`SO2`
`NO2`

Example

"CO"

Pollution

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

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

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

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

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)`

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": 987.65,
  "imfBx": 987.65,
  "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": 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": 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
}

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

Enum Value	Description
`CELSIUS`	Celsius degree. Possible values: `[-273.15, +Infinity)`
`FAHRENHEIT`	Fahrenheit degree. Possible values: `[-459,67, +Infinity)`

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": 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.

Units: ° Possible values: [0, 359]

height - Int! The closest to the specified height.

Example

{"windAngle": 145, "height": 123}

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"

Field Name	Description
`windDirection` - WindDirection!	Wind direction at the provided height.
`height` - Int!	The closest to the specified height.

Example

{"windDirection": "CALM", "height": 123}

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"

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}

Useful linksUseful links

QueriesQueries

serverTimeserverTime

DescriptionDescription

ResponseResponse

ExampleExample

QueryQuery

ResponseResponse

serverTimestampserverTimestamp

DescriptionDescription

ResponseResponse

ExampleExample

QueryQuery

ResponseResponse

stationsstations

DescriptionDescription

ResponseResponse

ArgumentsArguments

ExampleExample

QueryQuery

VariablesVariables

ResponseResponse

stationsByTimeRangestationsByTimeRange

DescriptionDescription

ResponseResponse

ArgumentsArguments

ExampleExample

QueryQuery

VariablesVariables

ResponseResponse

tilestiles

DescriptionDescription

ResponseResponse

ArgumentsArguments

ExampleExample

QueryQuery

VariablesVariables

ResponseResponse

weatherByPointweatherByPoint

DescriptionDescription

ResponseResponse

ArgumentsArguments

ExampleExample

QueryQuery

VariablesVariables

ResponseResponse

TypesTypes

BooleanBoolean

DescriptionDescription

ExampleExample

BoundsBounds

DescriptionDescription

FieldsFields

ExampleExample

BoundsRangeBoundsRange

DescriptionDescription

FieldsFields

ExampleExample

ClimateClimate

DescriptionDescription

FieldsFields

Arguments

offset - Int

limit - Int

loop - Boolean

Arguments

offset - Int

limit - Int

loop - Boolean

Arguments

offset - Int

limit - Int

loop - Boolean

ExampleExample

ClimateDayClimateDay

DescriptionDescription

FieldsFields

Arguments

unit - TemperatureUnit

Arguments

Useful links

Queries

serverTime

Description

Response

Example

Query

Response

serverTimestamp

Description

Response

Example

Query

Response

stations

Description

Response

Arguments

Example

Query

Variables

Response

stationsByTimeRange

Description

Response

Arguments

Example

Query

Variables

Response

tiles

Description

Response

Arguments

Example

Query

Variables

Response

weatherByPoint

Description

Response

Arguments

Example

Query

Variables

Response

Types

Boolean

Description

Example

Bounds

Description

Fields

Example

BoundsRange

Description

Fields

Example

Climate

Description

Fields

`offset` - Int

`limit` - Int

`loop` - Boolean

`offset` - Int

`limit` - Int

`loop` - Boolean

`offset` - Int

`limit` - Int

`loop` - Boolean

Example

ClimateDay

Description

Fields

`unit` - TemperatureUnit

`format` - IconFormat!

`theme` - IconTheme

`unit` - TemperatureUnit

`unit` - WindSpeedUnit

`unit` - TemperatureUnit