Docs
OpenWeather data connector
The free current weather API of OpenWeather is used to fetch weather data for your subject(s). Please follow the instructions below to enable the connector.
Step 1: Send us an email
Send the following to support@blockbax.com:
- Your free API key from OpenWeather (sign up here). This is where you can find the API key after signing up:
- A Blockbax access key with only send measurements rights.
- Your Blockbax project ID, found here:
- The desired data interval. Choose between 1 minute and 24 hours.
That’s all and to make it even easier, here is an example that you can copypaste:
Hi Blockbax Support,
Here is the information to enable the weather connector:
- OpenWeather API key: [ONE TIME LINK TO YOUR KEY]
- Blockbax API key: [ONE TIME LINK TO YOUR KEY]
- Blockbax project ID: [PROJECT ID]
- Data interval: Every 15 minutes
Please let me know when the integration is running.
Blockbax Support will come back to you as soon as possible to provide you with the fee for running, maintaining, updating, and monitoring the weather connector for your subjects. The cost for this connector starts at €50/month, varying based on the number of subjects for which weather data is retrieved.
Step 2: Configure subject type
- Create or edit a subject type and set the primary location:
- If the primary location is set to
Property
, the location is derived from the subject’s property. - If the primary location is set to
Metric
, the latest location measurement of the subject is used.
- If the primary location is set to
If no location is linked to the subject, the subject will be skipped, and no data will be ingested.
- Add one or multiple of the following metrics:
Metric name Data type Unit External ID Note Feels like temperature Number °C openweathermap_feels_like
Humidity Number % openweathermap_humidity
Atmospheric pressure Number hPa openweathermap_pressure
Rain Volume (last hour) Number mm/h openweathermap_rain_one_hour
Where available Snow Volume (last hour) Number mm/h openweathermap_snow_one_hour
Where available Current temperature Number °C openweathermap_temp
Visibility Number meter openweathermap_visibility
Cloudiness Number % openweathermap_cloudiness
Weather description Text N/A openweathermap_weather_description
Wind direction Number ° openweathermap_wind_deg
Wind gust speed Number meter/sec openweathermap_wind_gust
Wind speed Number meter/sec openweathermap_wind_speed
Metric names can be arbitrarily chosen but the External ID should always be selected from the required format.
Step 3: Check if data is ingested
- Wait for a email from Blockbax Support that the integration is running.
- Check if the data is ingested correctly. Please contact us via support@blockbax.com if you find any issues.
Good luck with driving value from the weather data!