Configuring Weather API via WWO
Overview
For the Appspace weather widget, the default service provider is Weather Decision Technology (WDT).
Note
Weather Decision Technology is only capable of delivering information for the North American region.
In order to obtain weather information for regions other than North America, you will need to properly configure and use World Weather Online (WWO) as a weather service provider. This guide outlines the steps to acquire a new API via the WWO website and importing the API key into Appspace for proper deployment in weather widgets.
Warning
This guide applies to Appspace on-premise installations only.
Obtaining the WWO API Key
Step 1
Begin by visiting http://www.worldweatheronline.com/api/ and clicking on the ‘FREE SIGNUP’ button near the bottom of the page.
Step 2
Complete the registration process as well as the e-mail verification steps (clicking on a verification link included in the WWO system generated e-mail). When finished, you should then be able to access your WWO account and be given the option to ‘Get a new key for this API’.
Step 3
Enter the required information regarding the usage of this API key and click the Save changes button.
Note
WWO free access accounts can only have 1 API key generated and active at a time per account.
Step 4
Your API key should be listed and available on the screen. You can now copy + paste this key to be saved and used at a later point in the Appspace configuration process.
Importing the WWO API Key Into Appspace
Step 1
Once you have logged into your on-premise Appspace instance, click the user icon and select System from the drop-down menu.
Step 2
Select the Weather tab and proceed to configure the Weather Provider by selecting (WWO) World Weather Online from the drop-down menu. Enter the API key that you obtained from the WWO site previously and click Save to confirm your settings.
Step 3
At the Confirmation window, click Yes to save your entries/changes.
Step 4
The system should automatically detect a change to the Appspace settings and prompt you with a notification at the top of the page. Click on the “Click Here” link.
Step 5
You will automatically be taken to the Apply Configuration tab. To finish applying the changes to the system settings, enter your Windows server credentials and click Apply.
Warning
The username and password should be your Windows server administrator credentials or an account with local administrator privileges to make and apply changes to server settings. This is NOT your Appspace server administrator credentials or your Appspace Cloud user credentials.
Step 6
At the Confirmation window, click Yes to restart your Appspace server.
You should see a message indicating the Appspace server’s restart progress.
If successful, you should be presented with an Information dialog window confirming the update. Click OK to complete the process.
Applying the WWO API Into the Weather Widget
Step 1
Navigate to the desired application that contains the weather widget in which to implement the WWO API. Select the Edit tab and click on the (Visual Editor) icon.
Step 2
From the Visual Editor interface, select the weather widget from the WIDGETS list. Click on the Properties button to continue.
Step 3
Under PROPERTIES, find the Provider drop-down menu. Select the World Weather Online option and also update the weather location(s) appropriately. Click Apply to complete the process. The weather widget should now be able to access and display weather information from locations outside the North American region.
