Weather Feeds
This document illustrates the weather feeds data request parameters, endpoint and the data returned.
API Call
Base Url: https://weather-feeds.gora.io
Get Weather: GET /api/v1/weather
Parameters - Get current weather by address:
Name | Type | Description | Description |
---|---|---|---|
area | string | (Required if latitude and longitude are not passed)Area of interest. This can be a town, a city or any administrative area | Ruiru |
state | string | (Required if latitude and longitude are not passed) State, province or county of interest | Kiambu |
country | string | (Required if latitude and longitude are not passed) Country where the area of interest is. | Kenya |
unitOfMeasure | string | The system of units for the returned weather data points. Available options are | metric |
key | string | (required) Key provided by GoraNetwork. When using node runner set the key as ##signKey | ##signKey |
Example Call
Parameters - Get weather forecast by address and date:
Name | Type | Description | Description |
---|---|---|---|
area | string | (Required)Area of interest. This can be a town, a city or any administrative area | Ruiru |
state | string | (Required) State, province or county of interest | Kiambu |
country | string | (Required) Country where the area of interest is. | Kenya |
dateTime | string | (Required) Date to get the weather data. Date format is YYYY-MM-DDTHH:mm:ss | 2023-07-13T08:00:00 |
unitOfMeasure | string | The system of units for the returned weather data points. Available options are | metric |
key | string | (required) Key provided by GoraNetwork. When using node runner set the key as ##signKey | ##signKey |
Example Call
Parameters - Get weather forecast by geo-location and date:
Name | Type | Description | Description |
---|---|---|---|
latitude | string | (Required) Latitude geo-postion of the area of interest. | Ruiru |
longitude | string | (Required) Longitude geo-position of the area of interest. | Kiambu |
dateTime | string | (Required) Date to get the weather data. Date format is YYYY-MM-DDTHH:mm:ss | 2023-07-13T08:00:00 |
unitOfMeasure | string | The system of units for the returned weather data points. Available options are | metric |
key | string | (required) Key provided by GoraNetwork. When using node runner set the key as ##signKey | ##signKey |
Example Call
Example Response (JSON)
Results Schema
Name | Type | Description |
---|---|---|
temperature | number | Temperature in the selected unit of measure. Degrees for metric, Fahrenheit for imperial |
precProbability | number | Probability of precipitation level as a percentage, |
precipitation | number | Precipitation level in the selected unit of measure. Millimeters for metric, |
feelsLike | number | ‘Feels like’ temperature in the selected unit of measure. Degrees for metric, Fahrenheit for imperial |
high | number | Highest temperature recorded/expected on that day in the selected unit of measure. Degrees for metric, Fahrenheit for imperial |
low | number | Lowest temperature recorded/expected on that day in the selected unit of measure. Degrees for metric, Fahrenheit for imperial |
twentyFourHourRain | number | mount of rainfall in |
visibility | number | Visible distance in the selected unit of measure. km for metric, m for imperial |
cloudCover | number | Cloud cover in percentage |
humidity | number | Humidity level in percentage |
windSpeed | number | Wind speed in the selected unit of measure. km/h for metric, m/h for imperial |
windGust | number | Wind gust in the selected unit of measure. km/h for metric, m/h for imperial |
windDir | number | Direction the wind originates from in compass degrees |
snow | number | The amount of new snow that has fallen in the selected metric. |
solarRadiation | number | The amount of solar radiation per unit area in the selected unit of measure. |
solarEnergy | number | The enegy emitted by the sun in the selected unit of measure. |
uvIndex | number | Ultraviolet radiation at ground level or sea level. |
pressure | number | Atmospheric pressure in the selected unit of measure. |
sunset | number | Sunset time in Unix timestamp |
sunrise | number | Sunrise time in Unix timestamp |
Last updated