You can learn about updates to the app in the https://bannisterlake.atlassian.net/wiki/spaces/ST/pages/3104866309 page.

This app connects to data made available via the APIs https://apidev.accuweather.com/developers with purchase options.

This weather reader supports the following forecast types

Forecast Data Type	V1

Forecast Data Type	V1
Location Search	✔
Current Conditions	✔
Daily Forecasts	✔
Hourly Forecasts	✔

Data Caching

When data is pulled from the API - it has an associated Expires value. The data is cached locally in the reader memory to be reused until the expiry is passed. At that point new data will be pulled from the API the next time it is needed.

Setup

Changes made will apply the next time the reader runs. The main piece of setup you need to do is to apply your API key and then select the language and units. The language option affects the text fields. The primary fields are converted to the default units specified in Flow for Chameleon.

(Not supported yet - The units field will control what units are applied to the extra data field values.)

API Host Name

The API Host name selection list allows you to choose which API service to use to connect to when reading the weather data. Your API key may work with one or more of the options.

api - use to access Production data with an Enterprise license API Key
apidev - use to access Development and Testing data with an Enterprise license API Key
dataservice - use to access developer data with a free developer API key

Licensed Days

The licensed days drop down allows you to select the correct number of daily forecasts you want to use and your API license allows.

Options

The day names options allow you to change how the day of the week name is saved in the data.

The abbreviated checkbox can either change the day name to it’s abbreviation or leave it as its full description. The Case drop down list allows you to select from:

Source (don’t change the data)
UPPER (convert to all upper case)
lower (convert to all lower case)
Title (first character is upper case and the rest is lower case)

Day Name Option Examples	Result

Day Name Option Examples	Result
	Monday, Tuesday, Wednesday
	MON, TUE, WED
	monday, tuesday, wednesday

Locations

You add and remove locations to be updated by the reader using the Locations tab.

Adding Locations

To add a new location you can search using:

City or town name (Atlanta, GA)
Geocode (latitude, longitude) (33.74,-84.39)

Type the city name or geocode into the search box
Press the Search button or the Enter key.
The reader will lookup a list of possible matches and display them in the dropdown list below the search box.
Select the appropriate location and click on the Add Location button.
1. it will insert the location
2. it will retrieve current forecast data for the new item

Removing Locations

To remove locations from the reader you:

Select the location(s) you want to remove.
Right-click to activate the popup menu.
Click on Remove to proceed.
You will be prompted to confirm the removal.

If you remove a location from the reader it will no longer be available for use in Chameleon.
It will be removed from all playlists and rundowns.

You can multi-select using the Shift and/or CTRL keys when clicking on locations in the list.

Logging Options

If you need to know more about the inner workings of the reader or check for errors - you can view log files.

View Logs

To view the logs click on

Help menu
- Logs menu
  - Show Current Log menu item

To find the log file location - after you open the log file simply select File menu, Save As….
The dialogue box should default to the folder of the current log file.

Performance Logging

If you want to check how long parts of the reading process are taking you can enable the Performace Logging option in the Help - Logs menu option. This will add extra details to the logs. This setting is saved.

Check for Updates

Use this menu option to check for and download any new updates for the reader.

Chameleon

AccuWeather Reader