WxYo- an APRS Weather Forecast Auto Responder

WXYO is a fork of WXBOT an APRS-IS listener app that listens for messages and responds with a brief weather forecast using Open Weather API and can be used word wide also using and CWOP are the only useful queries.

A big difference to WXBOT is that WXYO doesn’t recognize the words with “day”(Sunday, tomorrow, today, Sunday, etc). A day has 24 hours and in my opinion is too big for a forecast and is more simple to enter 2 digits for number of hours.

How to use:

Send an APRS message to WXYO and receive back a weather forecast for your nearest location. 

Optionally, you can specify "where" "when" and "what"

The "where" can take the following form:

• Any callsign with SSID received by APRS-IS with position report.
• lat/lon  Using decimal degrees I.E. 41.123/-122.1123
• City,ST (NOTE: City,ST from Romania and must be the first part of the message.  City and state must be separated by a comma: Example: Cotnari, IS)
• CWOP station id (I.E. DW6273)
• 4 or 6 character Maidenhead Grid. (cn81, or cn81uh)
• 4 character ICAO station (KJFK KSFO etc...) returns METAR report.
• 3 character IATA station (SFO, LAX etc) returns METAR report.

When an ICAO station is given, the default "what" is changed to METAR.  (You can specify full, or brief along with the ICAO station to get a normal forecast instead of the METAR report.)

The "When" can be a number (of hours) multiple of 3 and not greater then 36. Is used to indicate the forecast.  Abbreviations for days of the week are NOT recognized

The "What" can be:

    brief -- default.  Short forecast. Usually a single APRS Message.

    full  -- multi line more complete forecast.

    current -- Returns current conditions from the nearest NWS station.

    metar -- Returns the current conditions from the specified. ICAO station in METAR form.

            If an ICAO station is not specified, the nearest ICAO station to the given location is used.

    cwop -- Returns weather report from the CWOP station nearest to the given location.

            If no location was given, it assumes your location.

            If a callsign was given, it returns results from the CWOP station nearest to the location of the callsign

    help or ? -- Return a help message

Examples

Example forecast request messages sent to WXYO

Any message that is not according to the format

    Returns a brief forecast for the current location of the sending station.

An integer number multiple of 3 and not greater than 36

Returns the forecast for the current location of the sending station for that number of hours sent in the message:

Any Callsign-SSID

    Returns a brief forecast for the last location received from that CallSign with that SSID:

Cotnari, IS 3 full

    Returns full forecast for 3hours for Cotnari, Iasi . Works for Romania’s country

KM30 cwop or 41.123/-122.1123 cwop

    Returns  the current conditions as reported by the nearest CWOP station to that location

KN20ZZ full

Returns the forecast for the center of maidenhead grid KN20ZZ

41.123/121.334

    Returns the full forecast for Lattitude 41.123N, Longitude 121.334E, use “-“ for S and W

current

    Returns the current conditions

cwop

    Returns the current conditions as reported by the nearest CWOP (Citizen's Weather Observer Program) station.

"CWOP Station ID" (i.e. DW6273)

    Returns the current conditions as reported by the specified CWOP station.

'CALLSIGN' cwop

    Returns the current conditions from the CWOP station nearest to 'CALLSIGN'.

Messages are "Acked" if requested.  The program understands and uses "Reply Acks" if the originating station supports them.  

If the originating station sends an unnumbered message, then the reply will be unnumbered.  However, the program DOES NOT attempt to resend un-acknowledged messages.  

If you didn't get a forecast, send the request again.  

73 de Florin, YO8SDE

Credits and Thanks

• This program is a fork of WXBOT write by Martin Nile (KI6WJP).
  
• This program uses the aprs.fi api to collect the latitude and longitude of the requesting station. Special thanks to Heikki Hannikainen for his wonderful website and the api to access the data.
  
• CWOP weather is extracted from findu.com. Thanks to Steve Dimse for all of your work.
  
• The forecast data is extracted from the use forecast data from openweathermap.org.
  
• The program is single threaded and can handle a single forecast request at a time. It is running on a Raspberry Pi.