Weather

Weather engine in action

The Weather engine displays current weather conditions for a location in the style of the WeatherSTAR 4000. It can use automatic location lookup when available, fixed coordinates, or provider-specific location queries.

weather:
    provider: usa
    units: imperial
  latitude: 40.7128
  longitude: -74.0060

weather:
  provider: wttr.in
  query: London
  units: metric

weather:
  provider: weatherapi.com
  apiKey: your_api_key_here
  query: 94103
  logo: /content/images/my-station-logo.png

Properties

`latitude`

Type: number

Description: Latitude of the location to fetch weather for. If not provided, TVS will try to determine the location automatically when possible.

`longitude`

Type: number

Description: Longitude of the location to fetch weather for. If not provided, TVS will try to determine the location automatically when possible.

If automatic lookup fails, see the Weather Location Error troubleshooting page.

`logo`

Type: string

Description: URL of an optional logo to display in the upper-left corner of the weather screen.

`units`

Type: metric | imperial

Default: metric

Description: Units used for weather values.

`provider`

Type: usa | weatherapi.com | wttr.in

Default: usa

Description: Weather provider to use.

usa: Uses the built-in USA provider. Available since TVS 2.0.0.
weatherapi.com: Uses the WeatherAPI.com provider. Available since TVS 5.10.0.
wttr.in: Uses the wttr.in provider. Available since TVS 5.10.0.

`apiKey`

Type: string

Since: TVS 5.10.0

Description: API key for the selected weather provider. This is not required for usa or wttr.in, but it is required for weatherapi.com.

`query`

Type: string

Since: TVS 5.10.0

Description: Query string for providers that support named or special location lookups. This is supported by wttr.in and weatherapi.com.

Examples include London, 94103, @github.com, and ~Eiffel Tower.