Background
To upload a PWS observation, you make a standard HTTP GET request with the weather conditions as the GET parameters.
Endpoint
The GET message should be directed to the local Weather Service server and with the same endpoint as used by legacy Weather Underground service:
http://<Local Weather Service IP:Port>/weatherstation/updateweatherstation.php
GET Parameters
The following fields are required:
Field Name | Format | Description |
---|---|---|
tempf | 55.6 | Outdoor temperature in fahrenheit |
humidity | 0-100 | Outdoor humidity as a percentage |
rainin | 0.34 | Accumulated rainfall in inches over the last 60 min |
dailyrainin | 1.45 | Accumulated rainfall in inches for the current day (in local time) |
dateutc | 2019-03-12 07:45:10 | Time in UTC as YYYY-MM-DD HH:MM:SS (not local time) |
IMPORTANT all fields must be url escaped. For example, if the current time in utc is "2019-01-01 10:32:35
" then the dateutc field should be sent as "2019-01-01+10%3A32%3A35
". For reference see http://www.w3schools.com/tags/ref_urlencode.asp.
[To Do: If the weather station is not capable of producing a timestamp then either omit the field or set the field value to "now
"]
Example GET Message
Here is an example of a full URL:
https://<Local Weather Service IP:Port>/weatherstation/updateweatherstation.php?tempf=70.5&humidity=90&rainin=0&dailyrainin=0.54&dateutc=2000-01-01+10%3A32%3A35
The response text from the Weather Service server will be either "success
" or an error message.