action meteosource_point_point_get {
label: "Returns weather data for a single point (geographic name or GPS)"
description: "## Current weather and forecast for single location\n\n### Location specification\nThe location of the weather data is the only parameter that is required and must be specified. There are two ways to do this:\n1. Specify the GPS coordinates of the location using the parameters `lat` and `lon`.\n2. **OR** specify the name of the place using the parameter `place_id`. To obtain the `place_id` for the location you want, please use endpoints `/find_places_prefix` (search by prefix) or `/find_places` (search by full name).\n\n*Note: For mountains, it is usually better to specify the `place_id` rather than the `lat` and `lon`. When you use `place_id`, you are guaranteed to receive forecasts for the precise elevation of the peak. When you specify the coordinates, the elevation can be less precise.*\n\n### Sections\nThe endpoint can return multiple sections of data. To obtain the best performance, we advise only requesting the sections you actually need. The available sections are as follows:\n\n* Current weather situation\n* Hourly forecast (for 24/48/96/168 hours, depending on the tier)\n* Daily forecast (for 7/10/30 days, depending on the tier)\n* Minutely precipitation forecast (for 60 minutes in the following hour, only for higher tiers)\n* Weather alerts (only for higher tiers)\n\nBy default, only the current and hourly sections are returned. The division into daily parts (morning, afternoon and evening) is only available for the first 7 days of the forecast. For details regarding available parameters, see the parameter description below.\n\n### Notes\n* **For a detailed description of variables (e.g. icons), please consult ⚠️ description of variables ⚠️ in Documentation or `Schema` of the response (link next to Example value in the Responses section below).**\n* Variables can be instantaneous, averaged, or accumulated over certain time. For example, `precipitation` forecast provides the precipitation accumulated until the next hour (data with timestamp as `12:00:00` is rain accumulated from `12:00:00` to `13:00:00`).\n* Do **not** make any assumptions about the number and ordering of the variables. New variables and sections may be introduced in the future. Always check the data are present before you try to use them.\n* The response contains an `Expires` header, which defines the point at which the API response will not change for the same request. We highly recommend using this to avoid unnecessary requests and **increase the performance of your app**.\n* Meteosource API supports HTTP compression. To enable it, simply add an `Accept-Encoding: gzip` header to your request.\n* When daylight saving time starts, one hourly record will be missing (typically `2:00:00 AM`). When daylight saving time ends, the hourly forecast will contain two records with duplicate times (typically `2:00:00 AM`).\n* The detailed description of weather alerts is only available in English. The alert category is translated into selected language.\n"
provider: meteosource
method: GET
path: "/point"
encoding: json
input: {
type: "object"
properties: {
key: {
type: "string"
description: "Your unique API key. You can either specify it in this parameter, or set it in `X-API-Key` header."
}
language: {
description: "The language of text summaries and place names (variable names are never translated). Available languages are:\n\n * ``en``: English\n * ``es``: Spanish\n * ``fr``: French\n * ``de``: German\n * ``pl``: Polish\n * ``pt``: Portuguese\n * ``cs``: Czech\n"
type: "object"
}
lat: {
type: "string"
description: "Latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.4"
}
lon: {
type: "string"
description: "Longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.4"
}
place_id: {
type: "string"
description: "Identifier of a place. To obtain the `place_id` for the location you want, please use endpoints `/find_places_prefix` (search by prefix) or `/find_places` (search by full name)."
}
sections: {
type: "string"
description: "Sections to be included in the response. You can specify more section by separating the values with a comma. The available values are:\n\n* ``current``: Current weather situation\n* ``daily``: Forecasts for each whole day, without the daily parts\n* ``daily-parts``: Forecasts for each whole day, morning, afternoon and evening\n * Important: forecast for the morning, afternoon and evening is available only for the first\n 7 days in the forecast\n* ``hourly``: Forecasts with hourly resolution\n* ``minutely``: Precipitation forecast with 1 minute resolution\n* ``alerts``: The weather alerts\n* ``all``: All sections\n"
}
timezone: {
type: "string"
description: "Timezone to be used for the date fields. If not specified, local timezone of the forecast location will be used.\nThe format is according to the tzinfo database, so values like `Europe/Prague` or `UTC` can be used.\nAlternatively you may use the value ``auto`` in which case the local timezone of the location is used.\nThe full list of valid timezone strings can be found [here](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List).\n"
}
units: {
description: "Unit system to be used. The available values are:\n\n* `auto`: Select the system automatically, based on the forecast location.\n* `metric`: Metric (SI) units (`°C`, `mm/h`, `m/s`, `cm`, `km`, `hPa`).\n* `us`: Imperial units (`°F`, `in/h`, `mph`, `in`, `mi`, `Hg`).\n* `uk`: Same as ``metric``, except that visibility is in `miles` and wind speeds are in `mph`.\n* `ca`: Same as ``metric``, except that wind speeds are in `km/h` and pressure is in `kPa`.\n"
type: "object"
}
}
additionalProperties: false
}
output: {
type: "object"
required: ["alerts", "elevation", "lat", "lon", "units"]
properties: {
alerts: {
type: "object"
properties: {
data: {
type: "string"
}
}
}
current: {
type: "object"
required: ["precipitation", "wind"]
properties: {
cloud_cover: {
type: "number"
description: "Percentage of sky covered by clouds.\nUnit: \\%"
}
dew_point: {
type: "number"
description: "Current dew point temperature.\nUnits: metric = °C, us = °F, uk = °C, ca = °C"
}
feels_like: {
type: "number"
description: "Feels like temperature.\nUnits: metric = °C, us = °F, uk = °C, ca = °C"
}
humidity: {
type: "integer"
description: "Relative humidity.\nUnit: \\%"
}
icon: {
type: "string"
description: "String identifier of current weather icon, e.g. `light_rain`."
}
icon_num: {
type: "integer"
description: "Numeric identifier of current weather icon. The following values can appear:\n\n* 1 - Not available\n* 2 - Sunny\n* 3 - Mostly sunny\n* 4 - Partly sunny\n* 5 - Mostly cloudy\n* 6 - Cloudy\n* 7 - Overcast\n* 8 - Overcast with low clouds\n* 9 - Fog\n* 10 - Light rain\n* 11 - Rain\n* 12 - Possible rain\n* 13 - Rain shower\n* 14 - Thunderstorm\n* 15 - Local thunderstorms\n* 16 - Light snow\n* 17 - Snow\n* 18 - Possible snow\n* 19 - Snow shower\n* 20 - Rain and snow\n* 21 - Possible rain and snow\n* 22 - Rain and snow\n* 23 - Freezing rain\n* 24 - Possible freezing rain\n* 25 - Hail\n* 26 - Clear (night)\n* 27 - Mostly clear (night)\n* 28 - Partly clear (night)\n* 29 - Mostly cloudy (night)\n* 30 - Cloudy (night)\n* 31 - Overcast with low clouds (night)\n* 32 - Rain shower (night)\n* 33 - Local thunderstorms (night)\n* 34 - Snow shower (night)\n* 35 - Rain and snow (night)\n* 36 - Possible freezing rain (night)\n\nUnit: weather_ico0_36"
}
irradiance: {
type: "number"
description: "Global downward short-wave radiation flux.\nUnit: W/m2"
}
ozone: {
type: "number"
description: "Total column of ozone.\nUnit: Dobson"
}
precipitation: {
type: "object"
properties: {
total: {
type: "number"
description: "Current amount of precipitation.\nUnits: metric = mm/h, us = inches per hour, uk = mm/h, ca = mm/h"
}
type: {
type: "string"
format: "binary"
description: "Precipitation type, may be one of:\n\n* `none`, it there is no precipitation\n* `rain`\n* `snow`\n* `rain_snow`\n* `ice pellets`\n* `frozen rain`\n\nUnit: prec_str"
}
}
}
pressure: {
type: "number"
description: "Atmospheric pressure at mean sea level.\nUnits: metric = hPa, us = Hg, uk = hPa, ca = kPa"
}
summary: {
type: "string"
description: "Short text summary of current weather, e.g. `Light rain`."
}
temperature: {
type: "number"
description: "Current temperature 2 metres above ground.\nUnits: metric = °C, us = °F, uk = °C, ca = °C"
}
uv_index: {
type: "number"
description: "UV index, values from zero (low risk of harm) to 11+ (extreme risk of harm).\nUnit: uv_index"
}
visibility: {
type: "number"
description: "Visibility.\nUnits: metric = km, us = mi, uk = mi, ca = km"
}
wind: {
type: "object"
properties: {
angle: {
type: "number"
description: "Wind direction angle in degrees, 180° means wind from the south.\nUnit: degrees"
}
dir: {
type: "string"
format: "binary"
description: "Wind direction in `N`, `NNE`, `NE`, ..., `NNW` format.\nUnit: 16dir"
}
gusts: {
type: "number"
description: "Wind gust speed.\nUnits: metric = m/s, us = mph, uk = mph, ca = km/h"
}
speed: {
type: "number"
description: "Wind speed 10 metres above the ground.\nUnits: metric = m/s, us = mph, uk = mph, ca = km/h"
}
}
}
wind_chill: {
type: "number"
description: "Windchill temperature.\nUnits: metric = °C, us = °F, uk = °C, ca = °C"
}
}
}
daily: {
type: "object"
required: ["data"]
properties: {
data: {
type: "array"
items: {
type: "object"
required: ["all_day", "astro", "statistics"]
properties: {
afternoon: {
type: "object"
required: ["wind", "cloud_cover", "precipitation", "probability"]
properties: {
cloud_cover: {
type: "object"
properties: {
high: {
type: "number"
description: "Percentage of sky covered by high clouds. (afternoon avg)\nUnit: \\%"
}
low: {
type: "number"
description: "Percentage of sky covered by low clouds. (afternoon avg)\nUnit: \\%"
}
middle: {
type: "number"
description: "Percentage of sky covered by middle clouds. (afternoon avg)\nUnit: \\%"
}
total: {
type: "number"
description: "Percentage of sky covered by clouds. (afternoon avg)\nUnit: \\%"
}
}
}
dew_point: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
feels_like: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
humidity: {
type: "integer"
description: "Relative humidity. (afternoon avg)\nUnit: \\%"
}
icon: {
type: "integer"
description: "Afternoon umeric identifier of the weather icon. The following values can appear:\n\n* 1 - Not available\n* 2 - Sunny\n* 3 - Mostly sunny\n* 4 - Partly sunny\n* 5 - Mostly cloudy\n* 6 - Cloudy\n* 7 - Overcast\n* 8 - Overcast with low clouds\n* 9 - Fog\n* 10 - Light rain\n* 11 - Rain\n* 12 - Possible rain\n* 13 - Rain shower\n* 14 - Thunderstorm\n* 15 - Local thunderstorms\n* 16 - Light snow\n* 17 - Snow\n* 18 - Possible snow\n* 19 - Snow shower\n* 20 - Rain and snow\n* 21 - Possible rain and snow\n* 22 - Rain and snow\n* 23 - Freezing rain\n* 24 - Possible freezing rain\n* 25 - Hail\n* 26 - Clear (night)\n* 27 - Mostly clear (night)\n* 28 - Partly clear (night)\n* 29 - Mostly cloudy (night)\n* 30 - Cloudy (night)\n* 31 - Overcast with low clouds (night)\n* 32 - Rain shower (night)\n* 33 - Local thunderstorms (night)\n* 34 - Snow shower (night)\n* 35 - Rain and snow (night)\n* 36 - Possible freezing rain (night)\n\nUnit: icon"
}
ozone: {
type: "number"
description: "Total column of ozone. (afternoon avg)\nUnit: Dobson"
}
precipitation: {
type: "object"
properties: {
total: {
type: "number"
description: "Total precipitation amount accumulated since last hour. (afternoon sum)\nUnits: metric = mm/h, us = inches per hour, uk = mm/h, ca = mm/h"
}
type: {
type: "string"
format: "binary"
description: "Precipitation type, may be one of:\n\n* `none`, it there is no precipitation\n* `rain`\n* `snow`\n* `rain_snow`\n* `ice pellets`\n* `frozen rain`\n\nUnit: precipitation type"
}
}
}
pressure: {
type: "number"
description: "Atmospheric pressure at mean sea level. (afternoon avg)\nUnits: metric = hPa, us = Hg, uk = hPa, ca = kPa"
}
probability: {
type: "object"
properties: {
freeze: {
type: "number"
description: "Probability the temperature drops below 0 °C. (afternoon avg)\nUnit: %"
}
precipitation: {
type: "integer"
description: "Probability of non-zero precipitation.\nUnit: \\%"
}
storm: {
type: "number"
description: "Total precipitation amount accumulated since last hour.\nUnit: mm/h"
}
}
}
snow_depth: {
type: "number"
description: "Snow depth. (afternoon avg)\nUnits: metric = cm, us = inch, uk = cm, ca = cm"
}
soil_temperature: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
surface_temperature: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
temperature: {
type: "number"
description: "Temperature 2 metres above ground. (afternoon avg)\nUnits: metric = °C, us = °F, uk = °C, ca = °C"
}
visibility: {
type: "number"
description: "Visibility. (afternoon avg)\nUnits: metric = km, us = mi, uk = mi, ca = km"
}
weather: {
type: "string"
description: "Afternoon day string identifier of the weather icon, e.g. `light_rain`."
}
wind: {
type: "object"
properties: {
angle: {
type: "number"
description: "Afternoon wind direction angle in degrees, 180° means wind from the south.\nUnit: degrees"
}
dir: {
type: "string"
format: "binary"
description: "Afternoon wind direction in `N`, `NNE`, `NE`, ..., `NNW` format.\nUnit: 16dir"
}
gusts: {
type: "number"
description: "Wind gust speed. (afternoon max)\nUnits: metric = m/s, us = mph, uk = mph, ca = km/h"
}
speed: {
type: "number"
description: "Units: metric = m/s, us = mph, uk = mph, ca = km/h"
}
}
}
wind_chill: {
type: "number"
description: "Temperature 2 metres above ground. (afternoon avg)\nUnits: metric = °C, us = °F, uk = °C, ca = °C"
}
}
}
all_day: {
type: "object"
required: ["wind", "cloud_cover", "precipitation", "probability"]
properties: {
cloud_cover: {
type: "object"
properties: {
high: {
type: "number"
description: "Percentage of sky covered by high clouds. (allday avg)\nUnit: \\%"
}
low: {
type: "number"
description: "Percentage of sky covered by low clouds. (allday avg)\nUnit: \\%"
}
middle: {
type: "number"
description: "Percentage of sky covered by middle clouds. (allday avg)\nUnit: \\%"
}
total: {
type: "number"
description: "Percentage of sky covered by clouds. (allday avg)\nUnit: \\%"
}
}
}
dew_point: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
dew_point_max: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
dew_point_min: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
feels_like: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
feels_like_max: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
feels_like_min: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
humidity: {
type: "integer"
description: "Relative humidity. (allday avg)\nUnit: \\%"
}
icon: {
type: "integer"
description: "Numeric identifier of the weather icon. The following values can appear:\n\n* 1 - Not available\n* 2 - Sunny\n* 3 - Mostly sunny\n* 4 - Partly sunny\n* 5 - Mostly cloudy\n* 6 - Cloudy\n* 7 - Overcast\n* 8 - Overcast with low clouds\n* 9 - Fog\n* 10 - Light rain\n* 11 - Rain\n* 12 - Possible rain\n* 13 - Rain shower\n* 14 - Thunderstorm\n* 15 - Local thunderstorms\n* 16 - Light snow\n* 17 - Snow\n* 18 - Possible snow\n* 19 - Snow shower\n* 20 - Rain and snow\n* 21 - Possible rain and snow\n* 22 - Rain and snow\n* 23 - Freezing rain\n* 24 - Possible freezing rain\n* 25 - Hail\n* 26 - Clear (night)\n* 27 - Mostly clear (night)\n* 28 - Partly clear (night)\n* 29 - Mostly cloudy (night)\n* 30 - Cloudy (night)\n* 31 - Overcast with low clouds (night)\n* 32 - Rain shower (night)\n* 33 - Local thunderstorms (night)\n* 34 - Snow shower (night)\n* 35 - Rain and snow (night)\n* 36 - Possible freezing rain (night)\n\nUnit: icon"
}
ozone: {
type: "number"
description: "Total column of ozone. (allday avg)\nUnit: Dobson"
}
precipitation: {
type: "object"
properties: {
total: {
type: "number"
description: "Total precipitation amount accumulated since last hour. (allday sum)\nUnits: metric = mm/h, us = inches per hour, uk = mm/h, ca = mm/h"
}
type: {
type: "string"
format: "binary"
description: "Precipitation type, may be one of:\n\n* `none`, it there is no precipitation\n* `rain`\n* `snow`\n* `rain_snow`\n* `ice pellets`\n* `frozen rain`\n\nUnit: precipitation type"
}
}
}
pressure: {
type: "number"
description: "Atmospheric pressure at mean sea level. (allday avg)\nUnits: metric = hPa, us = Hg, uk = hPa, ca = kPa"
}
probability: {
type: "object"
properties: {
freeze: {
type: "number"
description: "Probability the temperature drops below 0 °C. (allday avg)\nUnit: %"
}
precipitation: {
type: "integer"
description: "Probability of non-zero precipitation.\nUnit: \\%"
}
storm: {
type: "number"
description: "Total precipitation amount accumulated since last hour.\nUnit: mm/h"
}
}
}
snow_depth: {
type: "number"
description: "Snow depth. (allday avg)\nUnits: metric = cm, us = inch, uk = cm, ca = cm"
}
soil_temperature: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
soil_temperature_max: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
soil_temperature_min: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
surface_temperature: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
surface_temperature_max: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
surface_temperature_min: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
temperature: {
type: "number"
description: "Temperature 2 metres above ground. (allday avg)\nUnits: metric = °C, us = °F, uk = °C, ca = °C"
}
temperature_max: {
type: "number"
description: "Temperature 2 metres above ground. (allday max)\nUnits: metric = °C, us = °F, uk = °C, ca = °C"
}
temperature_min: {
type: "number"
description: "Temperature 2 metres above ground. (allday min)\nUnits: metric = °C, us = °F, uk = °C, ca = °C"
}
visibility: {
type: "number"
description: "Visibility. (allday avg)\nUnits: metric = km, us = mi, uk = mi, ca = km"
}
weather: {
type: "string"
description: "All day string identifier of the weather icon, e.g. `light_rain`."
}
wind: {
type: "object"
properties: {
angle: {
type: "number"
description: "All day wind direction angle in degrees, 180° means wind from the south.\nUnit: degrees"
}
dir: {
type: "string"
format: "binary"
description: "All day wind direction in `N`, `NNE`, `NE`, ..., `NNW` format.\nUnit: 16dir"
}
gusts: {
type: "number"
description: "Wind gust speed. (allday max)\nUnits: metric = m/s, us = mph, uk = mph, ca = km/h"
}
speed: {
type: "number"
description: "Units: metric = m/s, us = mph, uk = mph, ca = km/h"
}
}
}
wind_chill: {
type: "number"
description: "Temperature 2 metres above ground. (allday avg)\nUnits: metric = °C, us = °F, uk = °C, ca = °C"
}
wind_chill_max: {
type: "number"
description: "Temperature 2 metres above ground. (allday max)\nUnits: metric = °C, us = °F, uk = °C, ca = °C"
}
wind_chill_min: {
type: "number"
description: "Temperature 2 metres above ground. (allday min)\nUnits: metric = °C, us = °F, uk = °C, ca = °C"
}
}
}
astro: {
type: "object"
required: ["sun", "moon"]
properties: {
moon: {
type: "object"
properties: {
always_down: {
type: "boolean"
description: "True if the moon never rises on given day, false otherwise."
}
always_up: {
type: "boolean"
description: "True if the moon never sets on given day, false otherwise."
}
phase: {
type: "string"
format: "binary"
description: "Name of the moon phase, one of 'new_moon', 'first_quarter', 'full_moon', 'last_quarter'."
}
rise: {
type: "string"
format: "date-time"
description: "Datetime of the moonrise or null if the moon does not rise on given day."
}
set: {
type: "string"
format: "date-time"
description: "Datetime of the moonset or null if the moon does not set on given day."
}
}
}
sun: {
type: "object"
properties: {
always_down: {
type: "boolean"
description: "True if the sun never rises on given day (polar night), false otherwise."
}
always_up: {
type: "boolean"
description: "True if the sun never sets on given day (polar day), false otherwise."
}
rise: {
type: "string"
format: "date-time"
description: "Datetime of the sunrise or null during polar day/night."
}
set: {
type: "string"
format: "date-time"
description: "Datetime of the sunset or null during polar day/night."
}
}
}
}
}
day: {
type: "string"
format: "binary"
description: "Datetime in YYYY-MM-DDTHH:MM:SS format."
}
evening: {
type: "object"
required: ["wind", "cloud_cover", "precipitation", "probability"]
properties: {
cloud_cover: {
type: "object"
properties: {
high: {
type: "number"
description: "Percentage of sky covered by high clouds. (evening avg)\nUnit: \\%"
}
low: {
type: "number"
description: "Percentage of sky covered by low clouds. (evening avg)\nUnit: \\%"
}
middle: {
type: "number"
description: "Percentage of sky covered by middle clouds. (evening avg)\nUnit: \\%"
}
total: {
type: "number"
description: "Percentage of sky covered by clouds. (evening avg)\nUnit: \\%"
}
}
}
dew_point: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
feels_like: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
humidity: {
type: "integer"
description: "Relative humidity. (evening avg)\nUnit: \\%"
}
icon: {
type: "integer"
description: "Evening numeric identifier of the weather icon. The following values can appear:\n\n* 1 - Not available\n* 2 - Sunny\n* 3 - Mostly sunny\n* 4 - Partly sunny\n* 5 - Mostly cloudy\n* 6 - Cloudy\n* 7 - Overcast\n* 8 - Overcast with low clouds\n* 9 - Fog\n* 10 - Light rain\n* 11 - Rain\n* 12 - Possible rain\n* 13 - Rain shower\n* 14 - Thunderstorm\n* 15 - Local thunderstorms\n* 16 - Light snow\n* 17 - Snow\n* 18 - Possible snow\n* 19 - Snow shower\n* 20 - Rain and snow\n* 21 - Possible rain and snow\n* 22 - Rain and snow\n* 23 - Freezing rain\n* 24 - Possible freezing rain\n* 25 - Hail\n* 26 - Clear (night)\n* 27 - Mostly clear (night)\n* 28 - Partly clear (night)\n* 29 - Mostly cloudy (night)\n* 30 - Cloudy (night)\n* 31 - Overcast with low clouds (night)\n* 32 - Rain shower (night)\n* 33 - Local thunderstorms (night)\n* 34 - Snow shower (night)\n* 35 - Rain and snow (night)\n* 36 - Possible freezing rain (night)\n\nUnit: icon"
}
ozone: {
type: "number"
description: "Total column of ozone. (evening avg)\nUnit: Dobson"
}
precipitation: {
type: "object"
properties: {
total: {
type: "number"
description: "Total precipitation amount accumulated since last hour. (evening sum)\nUnits: metric = mm/h, us = inches per hour, uk = mm/h, ca = mm/h"
}
type: {
type: "string"
format: "binary"
description: "Precipitation type, may be one of:\n\n* `none`, it there is no precipitation\n* `rain`\n* `snow`\n* `rain_snow`\n* `ice pellets`\n* `frozen rain`\n\nUnit: precipitation type"
}
}
}
pressure: {
type: "number"
description: "Atmospheric pressure at mean sea level. (evening avg)\nUnits: metric = hPa, us = Hg, uk = hPa, ca = kPa"
}
probability: {
type: "object"
properties: {
freeze: {
type: "number"
description: "Probability the temperature drops below 0 °C. (evening avg)\nUnit: %"
}
precipitation: {
type: "integer"
description: "Probability of non-zero precipitation.\nUnit: \\%"
}
storm: {
type: "number"
description: "Total precipitation amount accumulated since last hour.\nUnit: mm/h"
}
}
}
snow_depth: {
type: "number"
description: "Snow depth. (evening avg)\nUnits: metric = cm, us = inch, uk = cm, ca = cm"
}
soil_temperature: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
surface_temperature: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
temperature: {
type: "number"
description: "Temperature 2 metres above ground. (evening avg)\nUnits: metric = °C, us = °F, uk = °C, ca = °C"
}
visibility: {
type: "number"
description: "Visibility. (evening avg)\nUnits: metric = km, us = mi, uk = mi, ca = km"
}
weather: {
type: "string"
description: "Evening day string identifier of the weather icon, e.g. `light_rain`."
}
wind: {
type: "object"
properties: {
angle: {
type: "number"
description: "Evening wind direction angle in degrees, 180° means wind from the south.\nUnit: degrees"
}
dir: {
type: "string"
format: "binary"
description: "Evening wind direction in `N`, `NNE`, `NE`, ..., `NNW` format.\nUnit: 16dir"
}
gusts: {
type: "number"
description: "Wind gust speed. (evening max)\nUnits: metric = m/s, us = mph, uk = mph, ca = km/h"
}
speed: {
type: "number"
description: "Units: metric = m/s, us = mph, uk = mph, ca = km/h"
}
}
}
wind_chill: {
type: "number"
description: "Temperature 2 metres above ground. (evening avg)\nUnits: metric = °C, us = °F, uk = °C, ca = °C"
}
}
}
icon: {
type: "integer"
description: "Numeric identifier of the weather icon. The following values can appear:\n\n* 1 - Not available\n* 2 - Sunny\n* 3 - Mostly sunny\n* 4 - Partly sunny\n* 5 - Mostly cloudy\n* 6 - Cloudy\n* 7 - Overcast\n* 8 - Overcast with low clouds\n* 9 - Fog\n* 10 - Light rain\n* 11 - Rain\n* 12 - Possible rain\n* 13 - Rain shower\n* 14 - Thunderstorm\n* 15 - Local thunderstorms\n* 16 - Light snow\n* 17 - Snow\n* 18 - Possible snow\n* 19 - Snow shower\n* 20 - Rain and snow\n* 21 - Possible rain and snow\n* 22 - Rain and snow\n* 23 - Freezing rain\n* 24 - Possible freezing rain\n* 25 - Hail\n* 26 - Clear (night)\n* 27 - Mostly clear (night)\n* 28 - Partly clear (night)\n* 29 - Mostly cloudy (night)\n* 30 - Cloudy (night)\n* 31 - Overcast with low clouds (night)\n* 32 - Rain shower (night)\n* 33 - Local thunderstorms (night)\n* 34 - Snow shower (night)\n* 35 - Rain and snow (night)\n* 36 - Possible freezing rain (night)\n\nUnit: icon"
}
morning: {
type: "object"
required: ["wind", "cloud_cover", "precipitation", "probability"]
properties: {
cloud_cover: {
type: "object"
properties: {
high: {
type: "number"
description: "Percentage of sky covered by high clouds. (morning avg)\nUnit: \\%"
}
low: {
type: "number"
description: "Percentage of sky covered by low clouds. (morning avg)\nUnit: \\%"
}
middle: {
type: "number"
description: "Percentage of sky covered by middle clouds. (morning avg)\nUnit: \\%"
}
total: {
type: "number"
description: "Percentage of sky covered by clouds. (morning avg)\nUnit: \\%"
}
}
}
dew_point: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
feels_like: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
humidity: {
type: "integer"
description: "Relative humidity. (morning avg)\nUnit: \\%"
}
icon: {
type: "integer"
description: "Morning numeric identifier of the weather icon. The following values can appear:\n\n* 1 - Not available\n* 2 - Sunny\n* 3 - Mostly sunny\n* 4 - Partly sunny\n* 5 - Mostly cloudy\n* 6 - Cloudy\n* 7 - Overcast\n* 8 - Overcast with low clouds\n* 9 - Fog\n* 10 - Light rain\n* 11 - Rain\n* 12 - Possible rain\n* 13 - Rain shower\n* 14 - Thunderstorm\n* 15 - Local thunderstorms\n* 16 - Light snow\n* 17 - Snow\n* 18 - Possible snow\n* 19 - Snow shower\n* 20 - Rain and snow\n* 21 - Possible rain and snow\n* 22 - Rain and snow\n* 23 - Freezing rain\n* 24 - Possible freezing rain\n* 25 - Hail\n* 26 - Clear (night)\n* 27 - Mostly clear (night)\n* 28 - Partly clear (night)\n* 29 - Mostly cloudy (night)\n* 30 - Cloudy (night)\n* 31 - Overcast with low clouds (night)\n* 32 - Rain shower (night)\n* 33 - Local thunderstorms (night)\n* 34 - Snow shower (night)\n* 35 - Rain and snow (night)\n* 36 - Possible freezing rain (night)\n\nUnit: icon"
}
ozone: {
type: "number"
description: "Total column of ozone. (morning avg)\nUnit: Dobson"
}
precipitation: {
type: "object"
properties: {
total: {
type: "number"
description: "Total precipitation amount accumulated since last hour. (morning sum)\nUnits: metric = mm/h, us = inches per hour, uk = mm/h, ca = mm/h"
}
type: {
type: "string"
format: "binary"
description: "Precipitation type, may be one of:\n\n* `none`, it there is no precipitation\n* `rain`\n* `snow`\n* `rain_snow`\n* `ice pellets`\n* `frozen rain`\n\nUnit: precipitation type"
}
}
}
pressure: {
type: "number"
description: "Atmospheric pressure at mean sea level. (morning avg)\nUnits: metric = hPa, us = Hg, uk = hPa, ca = kPa"
}
probability: {
type: "object"
properties: {
freeze: {
type: "number"
description: "Probability the temperature drops below 0 °C. (morning avg)\nUnit: %"
}
precipitation: {
type: "integer"
description: "Probability of non-zero precipitation.\nUnit: \\%"
}
storm: {
type: "number"
description: "Total precipitation amount accumulated since last hour.\nUnit: mm/h"
}
}
}
snow_depth: {
type: "number"
description: "Snow depth. (morning avg)\nUnits: metric = cm, us = inch, uk = cm, ca = cm"
}
soil_temperature: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
surface_temperature: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
temperature: {
type: "number"
description: "Temperature 2 metres above ground. (morning avg)\nUnits: metric = °C, us = °F, uk = °C, ca = °C"
}
visibility: {
type: "number"
description: "Visibility. (morning avg)\nUnits: metric = km, us = mi, uk = mi, ca = km"
}
weather: {
type: "string"
description: "Morning day string identifier of the weather icon, e.g. `light_rain`."
}
wind: {
type: "object"
properties: {
angle: {
type: "number"
description: "Morning wind direction angle in degrees, 180° means wind from the south.\nUnit: degrees"
}
dir: {
type: "string"
format: "binary"
description: "Morning wind direction in `N`, `NNE`, `NE`, ..., `NNW` format.\nUnit: 16dir"
}
gusts: {
type: "number"
description: "Wind gust speed. (morning max)\nUnits: metric = m/s, us = mph, uk = mph, ca = km/h"
}
speed: {
type: "number"
description: "Units: metric = m/s, us = mph, uk = mph, ca = km/h"
}
}
}
wind_chill: {
type: "number"
description: "Temperature 2 metres above ground. (morning avg)\nUnits: metric = °C, us = °F, uk = °C, ca = °C"
}
}
}
predictability: {
type: "integer"
description: "Weather predictability. Values from 1 (very high predictability) to 5 (very low predictability).\nUnit: 1-5"
}
statistics: {
type: "object"
required: ["temperature", "wind", "precipitation"]
properties: {
precipitation: {
type: "object"
properties: {
avg: {
type: "number"
description: "Long-term average daily precipitation amount.\nUnits: metric = mm/day, us = inches per day, uk = mm/day, ca = mm/day"
}
probability: {
type: "integer"
description: "Long-term average precipitation probability.\nUnit: \\%"
}
}
}
temperature: {
type: "object"
properties: {
avg: {
type: "number"
description: "Long-term temperature average.\nUnits: metric = °C, us = °F, uk = °C, ca = °C"
}
avg_max: {
type: "number"
description: "Long-term daily maximum temperature average.\nUnits: metric = °C, us = °F, uk = °C, ca = °C"
}
avg_min: {
type: "number"
description: "Long-term daily minimum temperature average.\nUnits: metric = °C, us = °F, uk = °C, ca = °C"
}
record_max: {
type: "number"
description: "Historical daily maximum.\nUnits: metric = °C, us = °F, uk = °C, ca = °C"
}
record_min: {
type: "number"
description: "Historical daily minimum temperature.\nUnits: metric = °C, us = °F, uk = °C, ca = °C"
}
}
}
wind: {
type: "object"
properties: {
avg_angle: {
type: "number"
description: "Long-term average wind angle.\nUnit: deg"
}
avg_dir: {
type: "string"
format: "binary"
description: "Long-term average wind direction in 'N', 'NNE', 'NE', ... 'NNW' format.\nUnit: 16dir"
}
avg_speed: {
type: "number"
description: "Long-term average wind speed.\nUnits: metric = m/s, us = mph, uk = mph, ca = km/h"
}
max_gust: {
type: "number"
description: "Historical daily maximum wind gust speed.\nUnits: metric = m/s, us = mph, uk = mph, ca = km/h"
}
max_speed: {
type: "number"
description: "Historical daily maximum wind speed.\nUnits: metric = m/s, us = mph, uk = mph, ca = km/h"
}
}
}
}
}
summary: {
type: "string"
description: "Short text summary of the weather, e.g. `Light rain`."
}
weather: {
type: "string"
description: "All day string identifier of the weather icon, e.g. `light_rain`."
}
}
}
}
}
}
elevation: {
type: "integer"
description: "Elevation above sea level in metres (for units 'metric', 'uk', 'ca') or feet (for units 'us')"
}
hourly: {
type: "object"
required: ["data"]
properties: {
data: {
type: "array"
items: {
type: "object"
required: ["wind", "cloud_cover", "precipitation", "probability"]
properties: {
cape: {
type: "number"
description: "Convective available potential energy.\nUnit: J/kg"
}
cloud_cover: {
type: "object"
properties: {
high: {
type: "number"
description: "Percentage of sky covered by high clouds.\nUnit: \\%"
}
low: {
type: "number"
description: "Percentage of sky covered by low clouds.\nUnit: \\%"
}
middle: {
type: "number"
description: "Percentage of sky covered by middle clouds.\nUnit: \\%"
}
total: {
type: "number"
description: "Unit: \\%"
}
}
}
date: {
type: "string"
format: "date-time"
description: "Datetime in YYYY-MM-DDTHH:MM:SS format."
}
dew_point: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
evaporation: {
type: "number"
description: "Evaporation of liquid water into water vapor.\nUnit: mm/h"
}
feels_like: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
humidity: {
type: "integer"
description: "Relative humidity.\nUnit: \\%"
}
icon: {
type: "integer"
description: "Numeric identifier of the weather icon. The following values can appear:\n\n* 1 - Not available\n* 2 - Sunny\n* 3 - Mostly sunny\n* 4 - Partly sunny\n* 5 - Mostly cloudy\n* 6 - Cloudy\n* 7 - Overcast\n* 8 - Overcast with low clouds\n* 9 - Fog\n* 10 - Light rain\n* 11 - Rain\n* 12 - Possible rain\n* 13 - Rain shower\n* 14 - Thunderstorm\n* 15 - Local thunderstorms\n* 16 - Light snow\n* 17 - Snow\n* 18 - Possible snow\n* 19 - Snow shower\n* 20 - Rain and snow\n* 21 - Possible rain and snow\n* 22 - Rain and snow\n* 23 - Freezing rain\n* 24 - Possible freezing rain\n* 25 - Hail\n* 26 - Clear (night)\n* 27 - Mostly clear (night)\n* 28 - Partly clear (night)\n* 29 - Mostly cloudy (night)\n* 30 - Cloudy (night)\n* 31 - Overcast with low clouds (night)\n* 32 - Rain shower (night)\n* 33 - Local thunderstorms (night)\n* 34 - Snow shower (night)\n* 35 - Rain and snow (night)\n* 36 - Possible freezing rain (night)\n\nUnit: weather_ico0_36"
}
irradiance: {
type: "number"
description: "Global downward short-wave radiation flux.\nUnit: W/m2"
}
lftx: {
type: "number"
description: "Surface lifted index.\nUnit: K"
}
ozone: {
type: "number"
description: "Total column of ozone.\nUnit: Dobson"
}
precipitation: {
type: "object"
properties: {
convective: {
type: "number"
description: "Total precipitation amount accumulated since last hour.\nUnits: metric = mm/h, us = inches per hour, uk = mm/h, ca = mm/h"
}
rainspot: {
type: "string"
format: "binary"
description: "Precipitation in the surrounding of queried location. The data is 7x7 ASCII art string, queried location being in the center. Character `#` means there is precipitation, `.` means no precipitation. The distance between neighboring cells is 0.25°.\nUnit: rainspot"
}
total: {
type: "number"
description: "Total precipitation amount accumulated since last hour.\nUnits: metric = mm/h, us = inches per hour, uk = mm/h, ca = mm/h"
}
type: {
type: "string"
format: "binary"
description: "Precipitation type, may be one of:\n\n* `none`, it there is no precipitation\n* `rain`\n* `snow`\n* `rain_snow`\n* `ice pellets`\n* `frozen rain`\n\nUnit: precipitation type"
}
}
}
pressure: {
type: "number"
description: "Atmospheric pressure at mean sea level.\nUnits: metric = hPa, us = Hg, uk = hPa, ca = kPa"
}
probability: {
type: "object"
properties: {
freeze: {
type: "number"
description: "Unit: \\%"
}
precipitation: {
type: "integer"
description: "Probability of non-zero precipitation.\nUnit: \\%"
}
storm: {
type: "number"
description: "Total precipitation amount accumulated since last hour.\nUnit: mm/h"
}
}
}
snow_depth: {
type: "number"
description: "Snow depth.\nUnits: metric = cm, us = inch, uk = cm, ca = cm"
}
soil_temperature: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
summary: {
type: "string"
description: "Short text summary of the weather, e.g. `Light rain`."
}
sunshine_duration: {
type: "number"
description: "Sunshine duration since start of previous hour.\nUnit: s"
}
surface_temperature: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
temperature: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
uv_index: {
type: "number"
description: "UV index, values from zero (low risk of harm) to 11+ (extreme risk of harm).\nUnit: uv_index"
}
visibility: {
type: "number"
description: "Visibility.\nUnits: metric = km, us = mi, uk = mi, ca = km"
}
weather: {
type: "string"
description: "String identifier of the weather icon, e.g. `light_rain`."
}
wind: {
type: "object"
properties: {
angle: {
type: "number"
description: "Wind direction angle in degrees, 180° means wind from the south.\nUnit: degrees"
}
dir: {
type: "string"
format: "binary"
description: "Wind direction in `N`, `NNE`, `NE`, ..., `NNW` format.\nUnit: 16dir"
}
gusts: {
type: "number"
description: "Units: metric = m/s, us = mph, uk = mph, ca = km/h"
}
speed: {
type: "number"
description: "Units: metric = m/s, us = mph, uk = mph, ca = km/h"
}
}
}
wind_chill: {
type: "number"
description: "Units: metric = °C, us = °F, uk = °C, ca = °C"
}
}
}
}
}
}
lat: {
type: "string"
description: "Latitude of the point, always in the format , for example ``23.5S``"
}
lon: {
type: "string"
description: "Longitude of the point, always in the format , for example ``23.5W``"
}
minutely: {
type: "object"
required: ["data"]
properties: {
data: {
type: "array"
items: {
type: "object"
properties: {
date: {
type: "string"
format: "date-time"
description: "Datetime in YYYY-MM-DDTHH:MM:SS format."
}
precipitation: {
type: "number"
description: "Minutely precipitation amount (per hour). For the startup tier, showing one value per 10 minutes.\nFor other tiers, showing one value per each minute.\n\nUnit: mm/h"
}
}
}
}
summary: {
type: "string"
description: "Text summary about upcoming precipitation.\nUnit: summary"
}
}
}
timezone: {
type: "string"
description: "Name of the timezone in format like 'Europe/London'. Available only when the place is specified through place ID."
}
units: {
type: "string"
description: "Unit system (metric, uk, ca or us)"
}
}
}
}