Open Weather API — Documentation | Datamatic Software Plugins

Setup Instructions

This are step-by-step instructions on how to get the plugin working on any Bubble App.

[ml][ol][li indent=0 align=left]Add this plugin to your application.[/li][li indent=0 align=left]Go to [color=rgb(0, 102, 204)][url=https://openweathermap.org/price]https://openweathermap.org/price[/url][/color] and get an API Key.[/li][li indent=0 align=left]In the Bubble Editor, select an Element that can receive a Data Source (for instance Repeating Group). Select as Data Source -> Get Data from External API and on API Provider choose the best option that suits you (for example Weather Data By City). [/li][li indent=0 align=left]Fill in the requested propiertes (for example units refer to Units of measurement: standard, metric and imperial units are available. If you do not use the units parameter, standard units will be applied by default).[/li][li indent=0 align=left]Write the name of the city (for example Manhattan)[/li][li indent=0 align=left]Select your output language (default is english). [/li][li indent=0 align=left]Finally place your API Key where it is asked for. [/li][/ol][/ml]

Documentation

This plugin works with API Calls. For API Calls to work you need a working API Key from [color=rgb(0, 102, 204)][url=https://openweathermap.org/price]Open Weather[/url][/color]. The plugin contains the following Data Calls:

[h3][u]Current Weather by City[/u][/h3] Call current weather by city name (for example Manhattan).

[h3]Path Parameters[/h3] [ml][ul][li indent=0 align=left][b]city name:[/b] the name of the city[/li][li indent=0 align=left][b]units:[/b] units of measurement. standard, metric and imperial units are available. If you do not use the units parameter, standard units will be applied by default.[color=rgb(72, 72, 74)] [/color][color=rgb(0, 102, 204)][url=https://openweathermap.org/current#data]Learn more[/url][/color][/li][li indent=0 align=left][b]language:[/b] you can use this parameter to get the output in your language.[color=rgb(0, 102, 204)] [/color][color=rgb(0, 102, 204)][url=https://openweathermap.org/current#multi]Learn more[/url][/color][/li][li indent=0 align=left][b]API Key:[/b] your unique API key (you can always find it on your account page under the [color=rgb(0, 102, 204)][url=https://home.openweathermap.org/api_keys]API key tab[/url][/color])[/li][/ul][/ml] [h3]API Response[/h3] Refer to [color=rgb(0, 102, 204)][url=https://openweathermap.org/current#parameter]https://openweathermap.org/current#parameter[/url][/color] for more information.

[h3][u]Current Weather by ZIP Code[/u][/h3] Call current weather by zip code. Please note if country is not specified then the search works for USA as a default.

[h3]Path Parameters[/h3] [ml][ul][li indent=0 align=left][b]zip:[/b] zip code.[/li][li indent=0 align=left][b]country code:[/b] the code of the country. [color=rgb(72, 72, 74)] [/color]Please, refer to [color=rgb(0, 102, 204)][url=https://www.iso.org/obp/ui/#search]ISO 3166[/url][/color] for the country codes.[/li][li indent=0 align=left][b]units:[/b] units of measurement. standard, metric and imperial units are available. If you do not use the units parameter, standard units will be applied by default.[color=rgb(72, 72, 74)] [/color][url=https://openweathermap.org/current#data]Learn more[/url][/li][li indent=0 align=left][b]language:[/b] you can use this parameter to get the output in your language.[color=rgb(0, 102, 204)] [/color][url=https://openweathermap.org/current#multi]Learn more[/url][/li][li indent=0 align=left][b]API Key:[/b] your unique API key (you can always find it on your account page under the [color=rgb(0, 102, 204)][url=https://home.openweathermap.org/api_keys]API key tab[/url][/color])[/li][/ul][/ml] [h3]API Response[/h3] Refer to [color=rgb(0, 102, 204)][url=https://openweathermap.org/current#parameter]https://openweathermap.org/current#parameter[/url][/color][color=rgb(0, 102, 204)] [/color]for more information.

[h3][u]Current Weather for Multiple Cities[/u][/h3] Call returns data from cities laid within definite circle that is specified by center point (latitude, longitude) and expected number of cities (number of cities) around this point.

[h3]Path Parameters[/h3] [ml][ul][li indent=0 align=left][b]latitude:[/b] geographical coordinates (latitude)[/li][li indent=0 align=left][b]longitude:[/b] geographical coordinates (longitude)[/li][li indent=0 align=left][b]number of cities:[/b] Number of cities around the point that should be returned. The default number of cities is 5, the maximum is 50.[/li][li indent=0 align=left][b]units:[/b] units of measurement. standard, metric and imperial units are available. If you do not use the units parameter, standard units will be applied by default.[color=rgb(72, 72, 74)] [/color][url=https://openweathermap.org/current#data]Learn more[/url][/li][li indent=0 align=left][b]language:[/b] you can use this parameter to get the output in your language.[color=rgb(0, 102, 204)] [/color][url=https://openweathermap.org/current#multi]Learn more[/url][/li][li indent=0 align=left][b]API Key:[/b] your unique API key (you can always find it on your account page under the [url=https://home.openweathermap.org/api_keys]API key tab[/url])[/li][/ul][/ml] [h3]API Response[/h3] Refer to [color=rgb(0, 102, 204)][url=https://openweathermap.org/current#parameter]https://openweathermap.org/current#parameter[/url][/color] for more information.

[h3][u]Forecast Weather Data[/u][/h3] 5-day forecast available with data every 3 hours by city name, state code and country code.

[h3]Path Parameters[/h3] [ml][ul][li indent=0 align=left][b]city name:[/b] the name of the city.[/li][li indent=0 align=left][b]state code: [/b]the code of the state. Please, refer to [url=https://www.iso.org/obp/ui/#search]ISO 3166[/url] for the state codes.[/li][li indent=0 align=left][b]country code:[/b] the code of the country. [color=rgb(72, 72, 74)] [/color]Please, refer to [url=https://www.iso.org/obp/ui/#search]ISO 3166[/url] for the country codes.[/li][li indent=0 align=left][b]units:[/b] units of measurement. standard, metric and imperial units are available. If you do not use the units parameter, standard units will be applied by default.[color=rgb(72, 72, 74)] [/color][url=https://openweathermap.org/current#data]Learn more[/url][/li][li indent=0 align=left][b]language:[/b] you can use this parameter to get the output in your language.[color=rgb(0, 102, 204)] [/color][url=https://openweathermap.org/current#multi]Learn more[/url][/li][li indent=0 align=left][b]API Key:[/b] your unique API key (you can always find it on your account page under the [url=https://home.openweathermap.org/api_keys]API key tab[/url])[/li][/ul][/ml] [h3]API Response[/h3] Refer to [color=rgb(0, 102, 204)][url=https://openweathermap.org/forecast5#parameter]https://openweathermap.org/forecast5#parameter[/url][/color] for more information.

[h3][u]Forecast Weather Data by Coordinates[/u][/h3] 5-day forecast available with data every 3 hours by geographic coordinates

[h3]Path Parameters[/h3] [ml][ul][li indent=0 align=left][b]latitude:[/b] geographical coordinates (latitude)[/li][li indent=0 align=left][b]longitude:[/b] geographical coordinates (longitude)[/li][li indent=0 align=left][b]units:[/b] units of measurement. standard, metric and imperial units are available. If you do not use the units parameter, standard units will be applied by default.[color=rgb(72, 72, 74)] [/color][url=https://openweathermap.org/current#data]Learn more[/url][/li][li indent=0 align=left][b]language:[/b] you can use this parameter to get the output in your language.[color=rgb(0, 102, 204)] [/color][url=https://openweathermap.org/current#multi]Learn more[/url][/li][li indent=0 align=left][b]API Key:[/b] your unique API key (you can always find it on your account page under the [url=https://home.openweathermap.org/api_keys]API key tab[/url])[/li][/ul][/ml] [h3]API Response[/h3] Refer to [color=rgb(0, 102, 204)][url=https://openweathermap.org/forecast5#parameter]https://openweathermap.org/forecast5#parameter[/url][/color] for more information.

[h3][u]Historical Weather Data[/u][/h3] Historical weather data for the previous 5 days with data every 1 hour.

[h3]Path Parameters[/h3] [ml][ul][li indent=0 align=left][b]latitude:[/b] geographical coordinates (latitude)[/li][li indent=0 align=left][b]longitude:[/b] geographical coordinates (longitude)[/li][li indent=0 align=left][b]time:[/b] date from the previous five days (Unix time, UTC time zone), e.g. time=1626125456[/li][li indent=0 align=left][b]units:[/b] units of measurement. standard, metric and imperial units are available. If you do not use the units parameter, standard units will be applied by default.[color=rgb(72, 72, 74)] [/color][url=https://openweathermap.org/current#data]Learn more[/url][/li][li indent=0 align=left][b]language:[/b] you can use this parameter to get the output in your language.[color=rgb(0, 102, 204)] [/color][url=https://openweathermap.org/current#multi]Learn more[/url][/li][li indent=0 align=left][b]API Key:[/b] your unique API key (you can always find it on your account page under the [url=https://home.openweathermap.org/api_keys]API key tab[/url])[/li][/ul][/ml] [h3]API Response[/h3] Refer to [color=rgb(0, 102, 204)][url=https://openweathermap.org/api/one-call-api#hist_parameter]https://openweathermap.org/api/one-call-api#hist_parameter[/url][/color] for more information.

Setup Instructions

This are step-by-step instructions on how to get the plugin working on any Bubble App.

Documentation

[h3][u]Current Weather by City[/u][/h3] Call current weather by city name (for example Manhattan).

[h3][u]Current Weather by ZIP Code[/u][/h3] Call current weather by zip code. Please note if country is not specified then the search works for USA as a default.

[h3][u]Forecast Weather Data[/u][/h3] 5-day forecast available with data every 3 hours by city name, state code and country code.

[h3][u]Forecast Weather Data by Coordinates[/u][/h3] 5-day forecast available with data every 3 hours by geographic coordinates

[h3]Path Parameters[/h3] [ml][ul][li indent=0 align=left][b]latitude:[/b] geographical coordinates (latitude)[/li][li indent=0 align=left][b]longitude:[/b] geographical coordinates (longitude)[/li][li indent=0 align=left][b]units:[/b] units of measurement. standard, metric and imperial units are available. If you do not use the units parameter, standard units will be applied by default.[color=rgb(72, 72, 74)] [/color][url=https://openweathermap.org/current#data]Learn more[/url][/li][li indent=0 align=left][b]language:[/b] you can use this parameter to get the output in your language.[color=rgb(0, 102, 204)] [/color][url=https://openweathermap.org/current#multi]Learn more[/url][/li][li indent=0 align=left][b]API Key:[/b] your unique API key (you can always find it on your account page under the [url=https://home.openweathermap.org/api_keys]API key tab[/url])[/li][/ul][/ml] [h3]API Response[/h3] Refer to [color=rgb(0, 102, 204)][url=https://openweathermap.org/forecast5#parameter]https://openweathermap.org/forecast5#parameter[/url][/color] for more information.

[h3][u]Historical Weather Data[/u][/h3] Historical weather data for the previous 5 days with data every 1 hour.

[h3]Path Parameters[/h3] [ml][ul][li indent=0 align=left][b]latitude:[/b] geographical coordinates (latitude)[/li][li indent=0 align=left][b]longitude:[/b] geographical coordinates (longitude)[/li][li indent=0 align=left][b]time:[/b] date from the previous five days (Unix time, UTC time zone), e.g. time=1626125456[/li][li indent=0 align=left][b]units:[/b] units of measurement. standard, metric and imperial units are available. If you do not use the units parameter, standard units will be applied by default.[color=rgb(72, 72, 74)] [/color][url=https://openweathermap.org/current#data]Learn more[/url][/li][li indent=0 align=left][b]language:[/b] you can use this parameter to get the output in your language.[color=rgb(0, 102, 204)] [/color][url=https://openweathermap.org/current#multi]Learn more[/url][/li][li indent=0 align=left][b]API Key:[/b] your unique API key (you can always find it on your account page under the [url=https://home.openweathermap.org/api_keys]API key tab[/url])[/li][/ul][/ml] [h3]API Response[/h3] Refer to [color=rgb(0, 102, 204)][url=https://openweathermap.org/api/one-call-api#hist_parameter]https://openweathermap.org/api/one-call-api#hist_parameter[/url][/color] for more information.