Queries

serverTime

Description

Current time on the server.

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 -
maxLat -
minLon -
maxLon -
language -

Example

Query
query stations(
$minLat: Float!,$maxLat: Float!,
$minLon: Float!,$maxLon: Float!,
$language: Language ) { stations( minLat:$minLat,
maxLat: $maxLat, minLon:$minLon,
maxLon: $maxLon, language:$language
) {
id
code
name
lat
lon
time
timestamp
cloudiness
condition
distance
feelsLike
humidity
icon
isThunder
phenomCondition
phenomIcon
prec
precProbability
precStrength
precType
pressure
temperature
waterTemperature
windAngle
windDirection
windSpeed
}
}

Variables
{
"minLat": 47.27319717,
"maxLat": 47.27319717,
"minLon": -119.7085724,
"maxLon": -119.7085724,
"language": "EN"
}

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


stationsByTimeRange

Description

List of weather stations values by time range.

Response

Returns [Station!]!

Arguments
Name Description
request -
timeRange -

Example

Query
query stationsByTimeRange(
$request: PointInput!,$timeRange: TimeRange!
) {
stationsByTimeRange(
request: $request, timeRange:$timeRange
) {
id
code
name
lat
lon
time
timestamp
cloudiness
condition
distance
feelsLike
humidity
icon
isThunder
phenomCondition
phenomIcon
prec
precProbability
precStrength
precType
pressure
temperature
waterTemperature
windAngle
windDirection
windSpeed
}
}

Variables
{
"request": PointInput,
"timeRange": TimeRange
}

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


tiles

Description

Timelines for tiled data.

Returns a Tiles!

Arguments
Name Description
request -

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 -
language -

Example

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

Variables
{"request": PointInput, "language": "EN"}

Response
{
"data": {
"weatherByPoint": {
"climate": Climate,
"forecast": Forecast,
"location": Location,
"now": Now,
"nowcast": NowcastTimeline,
"url": "https://meteum.ai/london"
}
}
}


Types

Boolean

Description

The Boolean scalar type represents true or false.

Example
true


Bounds

Description

Rectangle where data is available.

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


BoundsRange

Description

The range of coordinates for one of the dimensions.

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


Climate

Description

Average weather statistics for 10 years.

Fields
Field Name Description
days - 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 - 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 - 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 - Climate zone description.
Example
{
"days": [ClimateDay],
"weeks": [ClimateWeek],
"months": [ClimateMonth],
"zone": ClimateZone
}


ClimateDay

Description

Statistics for one day.

Fields
Field Name Description
cloudiness - Average cloudiness for this day.
condition - The general weather condition that fits to cloudiness, precStrength and precType.
feelsLike - 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 - 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 - Icon describing the general weather condition for this day. Fits to the cloudiness, precStrength and precType.
Arguments
theme - IconTheme
maxDayTemperature - The highest temperature for this day.
Arguments
unit - TemperatureUnit
maxWindSpeed - The highest wind speed for this day.
Arguments
unit - WindSpeedUnit
minNightTemperature - The lowest temperature for this day.
Arguments
unit - TemperatureUnit
minWindSpeed - The lowest wind speed for this day.
Arguments
unit - WindSpeedUnit
prec - Total amount of precipitation in this day. Measured in millimeters.
precProbability - The probability of precipitation for this day. Possible values are in [0, 1].
precStrength - The highest strength of precipitation for this day.
precType - Precipitation corresponding to the precipitation strength.
pressure - Atmospheric pressure for this day.
Arguments
unit - PressureUnit
waterTemperature - The water surface temperature for this day. Exists only for cities that are located near large bodies of water.
Arguments
unit - TemperatureUnit
windAngle - The angle of the wind direction in degrees.
windDirection - Average wind direction for this day.
Example
{
"cloudiness": "CLEAR",
"condition": "CLEAR",
"feelsLike": 15,
"humidity": 82,
"icon": "skc_d",
"maxDayTemperature": 15,
"maxWindSpeed": 3.5,
"minNightTemperature": 15,
"minWindSpeed": 3.5,
"prec": 10.1,
"precProbability": 82,
"precStrength": "ZERO",
"precType": "NO_TYPE",
"pressure": 762,
"waterTemperature": 10,
"windAngle": 145,
"windDirection": "CALM"
}


ClimateMonth

Description

Statistics for one month.

Fields
Field Name Description
avgDayTemperature - Average daily temperature for this month.
Arguments
unit - TemperatureUnit
humidity - 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 - The highest daily temperature for this month.
Arguments
unit - TemperatureUnit
minNightTemperature - The lowest night temperature for this month.
Arguments
unit - TemperatureUnit
overcastDays - The number of cloudy days for this month.
prec - Total amount of precipitation for this month. Measured in millimeters.
precDays - The number of days with precipitation for this month.
pressure - Average atmospheric pressure for this month.
Arguments
unit - PressureUnit
sunnyDays - Number of sunny days for this month.
waterTemperature - Average water surface temperature for this month. Exists only for cities that are located near large bodies of water.
Arguments
unit - TemperatureUnit
windAngle - Average angle of the wind direction in degrees.
windDirection - Average wind direction for this month.
windSpeed - Average wind speed for this month.
Example
{
"avgDayTemperature": 15,
"humidity": 82,
"maxDayTemperature": 15,
"minNightTemperature": 15,
"overcastDays": 10,
"prec": 10.1,
"precDays": 10,
"pressure": 762,
"sunnyDays": 10,
"waterTemperature": 10,
"windAngle": 145,
"windDirection": "CALM",
"windSpeed": 3.5
}


ClimateWeek

Description

Statistics for one week.

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


ClimateZone

Description

Climate zone description.

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


ClimateZoneCode

Description

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

Values
Enum Value Description

None

Af

Am

Aw

BWh

BWk

BSh

BSk

Csa

Csb

Csc

Cwa

Cwb

Cwc

Cfa

Cfb

Cfc

Dsa

Dsb

Dsc

Dsd

Dwa

Dwb

Dwc

Dwd

Dfa

Dfb

Dfc

Dfd

ET

EF

Example
"None"


Cloudiness

Description

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

Values
Enum Value Description

CLEAR

PARTLY

SIGNIFICANT

CLOUDY

OVERCAST

Example
"CLEAR"


CloudinessLevel

Description

Cloud cover level.

Values
Enum Value Description

LOW

MIDDLE

HIGH

TOTAL

Example
"LOW"


Condition

Description

Represents the general weather conditions.

Values
Enum Value Description

CLEAR

PARTLY_CLOUDY

CLOUDY

OVERCAST

LIGHT_RAIN

RAIN

HEAVY_RAIN

SHOWERS

SLEET

LIGHT_SNOW

SNOW

SNOWFALL

HAIL

THUNDERSTORM

THUNDERSTORM_WITH_RAIN

THUNDERSTORM_WITH_HAIL

Example
"CLEAR"


Datum

Description

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

Values
Enum Value Description

MSL

LAT

MLLW

Example
"MSL"


Daypart

Description

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

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


Dayparts

Description

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

Fields
Field Name Description
night - 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 - Morning aggregations.
day - Afternoon aggregations.
evening - Evening aggregations
Example
{
"night": Daypart,
"morning": Daypart,
"day": Daypart,
"evening": Daypart
}


Daytime

Description

Represents the time of day.

Values
Enum Value Description

DAY

NIGHT

Example
"DAY"


Float

Description

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

Example
987.65


Forecast

Description

The main weather forecast.

Fields
Field Name Description
days - 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 - 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 - Magnetic field Kp-index. Possible values are in [0, 10].
moon - Moon phase. Possible values are in [0, 15].
oceanTideExtremums - The ocean water level maximums and minimums in day
Arguments
datum - Datum
parts - Dayparts aggregations for this day.
polar - Indicates the polar day or polar night. Skipped when the day is normal.
summary - Summary aggregations for this day.
sunrise - Sunrise time in format hh:mm. use sunriseTime field
sunriseTime - Sunrise time.
sunriseTimestamp - Sunrise time.
sunriseBegin - Start time of the sunrise in format hh:mm. use sunriseBeginTime field
sunriseBeginTime - Start time of the sunrise.
sunriseBeginTimestamp - Start time of the sunrise.
sunset - Sunset time in format hh:mm. use sunsetTime field
sunsetTime - Sunset time.
sunsetTimestamp - Sunset time.
sunsetEnd - End time of the sunset in format hh:mm. use sunsetEndTime field
sunsetEndTime - End time of the sunset.
sunsetEndTimestamp - End time of the sunset.
time - Start time of the day.
timestamp - Start time of the day.
Example
{
"hours": [ForecastHour],
"kpIndex": 2,
"moon": 2,
"oceanTideExtremums": [OceanTideExtremumItem],
"parts": Dayparts,
"polar": "DAY",
"summary": Summary,
"sunrise": "10:30",
"sunriseTime": "2022-10-26T12:37:53.528758212+03:00",
"sunriseTimestamp": "1666778972",
"sunriseBegin": "10:30",
"sunriseBeginTime": "2022-10-26T12:37:53.528758212+03:00",
"sunriseBeginTimestamp": "1666778972",
"sunset": "10:30",
"sunsetTime": "2022-10-26T12:37:53.528758212+03:00",
"sunsetTimestamp": "1666778972",
"sunsetEnd": "10:30",
"sunsetEndTime": "2022-10-26T12:37:53.528758212+03:00",
"sunsetEndTimestamp": "1666778972",
"time": "2022-10-26T12:37:53.528758212+03:00",
"timestamp": "1666778972"
}


ForecastHour

Description

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

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


IconFormat

Description

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

Values
Enum Value Description

CODE

PNG_24

PNG_32

PNG_48

PNG_64

PNG_96

PNG_112

PNG_128

SVG

Example
"CODE"


IconTheme

Description

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

Values
Enum Value Description

BLACK

CIRCLE

DARK

FLAT

LIGHT

OUTLINE

Example
"BLACK"


Int

Description

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

Example
123


Language

Description

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

Values
Enum Value Description

BE

DE

EN

ES

ES_LA

FR

HU

ID

IT

KK

MK

PL

PT

PT_BR

RO

RU

SR

TR

TT

UK

UZ

Example
EN


Location

Description

All information about requested location or point.

Fields
Field Name Description
altitude - Altitude of this location from topography data source.
lat - Latitude of this location.
lon - Longitude of this location.
pressureNorm - Info about normal pressure values for this location.
Arguments
unit - PressureUnit
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 - Current value of cloudiness.
condition - Current general weather condition that fits to cloudiness, isThunder, precStrength and precType.
daytime - Indicates the presence of the sun right now.
feelsLike - 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 - The percentage of the mass fraction of water vapor in the air to the maximum possible at the current temperature.
icon - Icon describing the general weather condition. Fits to the cloudiness, isThunder, precStrength and precType.
Arguments
theme - IconTheme
isThunder - Flag showing the presence of a thunder right now (or for some short time period).
phenomCondition - Current phenomenon. Skipped when weather conditions are normal.
phenomIcon - Icon of the phenomenon. Skipped when weather conditions are normal.
Arguments
theme - IconTheme
pollution - The current composition of the atmosphere.
precProbability - Current probability of precipitation. Possible values are in [0, 1].
precStrength - Current value of precipitation strength.
precType - Current type of precipitation.
pressure - Current atmospheric pressure.
Arguments
unit - PressureUnit
season - Current time of year.
soilMoisture - The percentage of all soil moisture to dry soil.
soilTemperature - Soil temperature at a depth of 7 cm.
Arguments
unit - TemperatureUnit
temperature - The temperature value in the shade at a height of 2 meters from the ground surface.
Arguments
unit - TemperatureUnit
uvIndex - The level of solar radiation on the Earth's surface. Possible values are in [0, 13].
visibility - Visibility in meters.
waterTemperature - The water surface temperature. Exists only for cities that are located near large bodies of water.
Arguments
unit - TemperatureUnit
waveAngle - The angle in which the primary wave is moving. Measured in degrees.
waveDirection - The direction in which the primary wave is moving.
waveHeight - Significant height of combined wind waves and swell surface. Measured in meters.
wavePeriod - Primary wave mean period surface. Measured in seconds.
windAngle - The angle of the wind direction in degrees.
windDirection - Current wind direction.
windGust - The speed of wind gusts.
Arguments
unit - WindSpeedUnit
windSpeed - Wind speed at a height of 10 meters from the ground surface.
Example
{
"cloudiness": "CLEAR",
"condition": "CLEAR",
"daytime": "DAY",
"feelsLike": 15,
"humidity": 82,
"icon": "skc_d",
"isThunder": true,
"phenomCondition": "BLOWING_SNOW",
"phenomIcon": "skc_d",
"pollution": Pollution,
"precProbability": 82,
"precStrength": "ZERO",
"precType": "NO_TYPE",
"pressure": 762,
"season": "SPRING",
"soilMoisture": 20,
"soilTemperature": 10,
"temperature": 15,
"uvIndex": 2,
"visibility": 123,
"waterTemperature": 10,
"waveAngle": 145,
"waveDirection": "CALM",
"waveHeight": 20,
"wavePeriod": 20,
"windAngle": 145,
"windDirection": "CALM",
"windGust": 3.5,
"windSpeed": 3.5
}


NowcastTimeline

Description

Weather precipitations nowcast timeline.

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


NowcastTimelineStep

Description

One step of nowcast timeline.

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


OceanTideExtremumItem

Description

Ocean tide timeline point.

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


OceanTideExtremumType

Description

Ocean tide extremum type.

Values
Enum Value Description

MAX

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

MIN

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

USUAL

Just local extremum.
Example
"MAX"


PhenomCondition

Description

Represents the phenomenon weather conditions.

Values
Enum Value Description

BLOWING_SNOW

CONTINUOUS_HEAVY_RAIN

DRIFTING_SNOW

DRIZZLE

DUST

DUSTSTORM

DUST_SUSPENSION

FOG

FREEZING_RAIN

ICE_PELLETS

MIST

MODERATE_RAIN

SMOKE

THUNDERSTORM_WITH_DUSTSTORM

TORNADO

VOLCANIC_ASH

Example
"BLOWING_SNOW"


PointInput

Description

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

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


PollutionDaypart

Description

Atmospheric composition forecasts aggregated for one time of day .

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


PrecStrength

Description

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

Values
Enum Value Description

ZERO

WEAK

AVERAGE

STRONG

VERY_STRONG

Example
"ZERO"


PrecType

Description

Represents the type of precipitations.

Values
Enum Value Description

NO_TYPE

RAIN

SLEET

SNOW

HAIL

Example
"NO_TYPE"


PressureUnit

Description

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

Values
Enum Value Description

MBAR

millibar (mbar)

MM_HG

millimeters of mercury (mm Hg)

PASCAL

pascal (Pa)
Example
"MBAR"


Resolution

Description

Resolution of the image with data. Measured in degrees.

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


Season

Description

Represents the time of the year.

Values
Enum Value Description

SPRING

SUMMER

AUTUMN

WINTER

Example
"SPRING"


Station

Description

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

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


String

Description

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

Example
"xyz789"


Summary

Description

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

Fields
Field Name Description
night - 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 - Aggregations for the entire civil day.
Example
{"night": Daypart, "day": Daypart}


TemperatureUnit

Description

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

Values
Enum Value Description

CELSIUS

degrees Celsius

FAHRENHEIT

Fahrenheit degree
Example
"CELSIUS"


TemperatureWithHeight

Description

Response of temperatureOnHeight function.

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


Tiles

Description

Timelines for tiled data.

Fields
Field Name Description
humidity -
prec -
pressureMm -
snowDepth -
soilMoisture -
soilTemperature -
surfaceTemperature -
temperature -
waterTemperature -
windSpeed -
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 - 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 -
to -
Example
{"from": "1666778972", "to": "1666778972"}


TimelineStep

Description

One step of timeline.

Fields
Field Name Description
bounds - Rectangle where data is available.
genTime - Data generation time. Used for synchronization when requesting tile data.
resolution - Resolution of the image with data. Measured in degrees.
time - Timeline step time.
timestamp - Timeline step time.
value - 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 - A well-known abbreviation.
dst - Indicates that the timezone is currently daylight saving time (DST).
name - Name from IANA time zone database.
offset - 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, 180SOUTH. 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 - Average weather statistics for 10 years.
forecast - The main weather forecast.
location - All information about requested location or point.
now - Weather now.
nowcast - Weather precipitations nowcast timeline.
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 - Wind angle at the provided height.
height - 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, 180SOUTH. 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 - Wind direction at the provided height.
height - The closest to the specified height.
Example
{"windDirection": "CALM", "height": 123}


WindSpeedUnit

Description

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

Values
Enum Value Description

KILOMETERS_PER_HOUR

kilometers per hour

METERS_PER_SECOND

meters per second

MILES_PER_HOUR

miles per hour
Example
"KILOMETERS_PER_HOUR"


WindSpeedWithHeight

Description

Response of windSpeedOnHeight function.

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