Skip to content

OpenWeatherMap Cloud Integrations

Matt Magoffin edited this page Nov 6, 2024 · 2 revisions

OpenWeatherMap Cloud Integrations

This page descirbes the Cloud Integrations support for OpenWeatherMap. See the OpenWeatherMap documentation site for information about their APIs.

OpenWeatherMap Integration service

The OpenWeatherMap integration service identifier is s10k.c2c.i9n.owm. The following service properties are supported:

Property Description
apiKey The OpenWeatherMap API key to use for authentication
baseUrl An optional alternate URL to use to access the cloud service

OpenWeatherMap Datum Stream services

The OpenWeatherMap integration supports the following Cloud Datum Stream Service implementations:

Service Identifier Description
OpenWeatherMap Day s10k.c2c.ds.owm.day Polling datum stream using the OpenWeatherMap API for day (sunrise, sunset, etc.) data
OpenWeatherMap Forecast s10k.c2c.ds.owm.forecast Polling datum stream using the OpenWeatherMap API for weather forecast data
OpenWeatherMap Weather s10k.c2c.ds.owm.weather Polling datum stream using the OpenWeatherMap API for weather observation data

☝️ Note that these services are geared towards collecting Location Datum streams. That means an appropriate location datum stream (location ID and source ID) must be configured before setting up an OpenWeatherMap Cloud Datum Stream. The Location Request API can be used to submit requests for new location streams, if one does not already exist.

The datum stream services also automatically collect datum using SolarNetwork standardized properties and no Cloud Datum Stream Mapping Property entities are required (a Cloud Datum Stream Mapping entity is still required, but does not need any Property entities associated with it).

Datum Import support

These services do not support the Cloud Datum Stream import service.

OpenWeatherMap Datum Stream Service common properties

The OpenWeatherMap Datum Stream Service implementations all support the following common service properties:

Property Description
lat The GPS decimal latitude to query
lon The GPS decimal longitude to query
locId An OpenWeatherMap location (city) identifier to use, instead of GPS coordinates

☝️ If a locId property is configured then lat and lon are ignored. See OpenWeatherMap's city.list.json resource for the list of supported values.

OpenWeatherMap Day Datum Stream Service

The OpenWeatherMap Day datum stream service identifier is s10k.c2c.ds.owm.day. This service accesses the Current Weather API to collect basic day-level information such as sunrise and sunset times.

The common service properties are supported. No Data Filters are supported.

OpenWeatherMap Forecast Datum Stream Service

The OpenWeatherMap Day datum stream service identifier is s10k.c2c.ds.owm.forecast. This service accesses the Forecast API to collect future-dated weather forecast information, such as temperature, wind, and sky conditions.

The common service properties are supported. No Data Filters are supported.

OpenWeatherMap Weather Datum Stream Service

The OpenWeatherMap Day datum stream service identifier is s10k.c2c.ds.owm.weather. This service accesses the Current Weather API to collect current weather observation information, such as temperature, wind, and sky conditions.

The common service properties are supported. No Data Filters are supported.

Clone this wiki locally