Skip to content
background-image background-image

OpenWeather Current Data Reader

[ | version 3.0]

Connector

The connector is permitted for use of the platform background agent.

Connector processing type: Row by row!

The open weather current data reader connector enables the reading of current weather forecasts from the popular weather server openweathermap.org. Our platform connector simplifies access to the world weather data by providing an easy configuration option where you just need to provide the location data represented by Longitude and Latitude coordinates as input and set the configuration by providing an access token and defining temperature units and the language. Based on applied settings, the connector reads the weather data easily instead of the complicated API settings.

Data returned by the connector will give you complex information about the current weather in the specified location including weather description, main weather information (temperature, real feel, pressure, humidity), visibility, wind information, and precipitation information. For a detailed overview of the returned data, see the output schemas here.

Input data format

The geo-location input data must be provided in the format of decimal latitude and longitude coordinates (not sexagesimal degrees and degrees and decimal minutes).

Sample of the output data:

OpenWeather Current data reader output

Configuration

OpenWeather connection configuration

API token

Provide API token from the openweathermap.org user registration. Register yourself on the open weather map portal. See the billing plans on the portal to understand the potential connected costs. The free plan includes up to 60 calls per minute and 1000 calls per day.

Open weather map API key

Units

Select the temperature measuring unit to display temperature values in the output.

OpenWeather Map Temperature units

Allowed types:

  • Temperature in Kelvin
  • Temperature in Fahrenheit
  • Temperature in Celsius

Language

Select the language for culture-based output data.

Timeout

The number of seconds to wait before terminating the request. The default value is set to 100 seconds.

Input & Output Schema

Input

OpenWeather current data input (ver. 1.0.0)

Column Data type Allow null Description
Longitude double No Longitude in decimal format
Latitude double No Latitude in decimal format

Output

OpenWeather current data output (ver. 1.0.0)

Column Data type Allow null Description
CityId integer Yes City ID corresponding to geo coordinates
CityName string Yes Name of the city corresponding to geo coordinates
Longitude double No Longitude in decimal format
Latitude double No Latitude in decimal format
Weather OpenWeather current data weather 1.0.0 No
MainInfo OpenWeather current data main info 1.0.0 No
Visibility integer No Average visibility distance in meters (max. 10km)
Wind OpenWeather current data wind 1.0.0 No
Cloudiness integer No Cloudiness v %
Rain OpenWeather current data precipitations 1.0.0 No
Snow OpenWeather current data precipitations 1.0.0 No
Sunrise DateTime Yes Sunrise
Sunset DateTime Yes Sunset
DataCalculation DateTime No Data calculation timestamp

OpenWeather current data weather (ver. 1.0.0)

Column Data type Allow null Description
Id integer No Weather condition id
Main string No Group of weather parameters (Rain, Snow, Extreme etc.)
Description string No Weather conditions within the group full list of weather conditions. You can get the output in your language.

OpenWeather current data main info (ver. 1.0.0)

Column Data type Allow null Description
Temperature double No Temperature. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
FeelsLike double No Temperature. This temperature parameter accounts for the human perception of weather. Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
Pressure integer No Atmospheric pressure (on the sea level, if there is no AtmosphericPressureSeaLevel or AtmosphericPressureGroundLevel data filled), hPa
Humidity integer No Humidity, %
TempMin double Yes Minimum temperature at the moment. This is the minimal currently observed temperature (within large megalopolises and urban areas). Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
TempMax double Yes Maximum temperature at the moment. This is the maximal currently observed temperature (within large megalopolises and urban areas). Unit Default: Kelvin, Metric: Celsius, Imperial: Fahrenheit.
AtmosphericPressureSeaLevel integer Yes Atmospheric pressure on the sea level, hPa
AtmosphericPressureGroundLevel integer Yes Atmospheric pressure on the ground level, hPa

OpenWeather current data wind (ver. 1.0.0)

Column Data type Allow null Description
Speed double No Wind speed. Unit Default: meter/sec, Metric: meter/sec, Imperial: miles/hour.
DirectionDegrees integer No Wind direction, degrees (meteorological)
GustSpeed double Yes Wind gust. Unit Default: meter/sec, Metric: meter/sec, Imperial: miles/hour

Release notes

3.0.0

  • First release