PURPOSE

NWS hourly raindata from anywhere

STATUS

Beta

OPTIONS

Three ways to provide station:

URL Sample

https://api.synopticdata.com/v2/stations/timeseries?stid=SFOC1&start=202303300701&end=202304010659&precip=1&units=english&obtimezone=local&token=79608f479e304314b32360afafabf841

STATIONS

https://api.synopticdata.com/v2/stations/metadata?&token={Your API Token}&obrange=20150101,20150501&county=san francisco&status=active&country=us&state=ca

JSON

{"UNITS":{"precipitation":"Inches"},"STATION":[{"STATUS":"ACTIVE","MNET_ID":"106","PERIOD_OF_RECORD":{"start":"2007-03-23T00:00:00Z","end":"2021-12-10T17:43:00Z"},"ELEVATION":"150","NAME":"SAN FRANCISCO DOWNTOWN","STID":"SFOC1","ELEV_DEM":"157.5","LONGITUDE":"-122.42694","STATE":"CA","OBSERVATIONS":{"precipitation":[{"count":1,"first_report":"2021-12-03T04:43:00-0800","interval":1,"report_type":"precip_accum","last_report":"2021-12-03T04:43:00-0800","total":0.0}, {"count":1,"first_report":"2021-12-03T05:43:00-0800","interval":2,"report_type":"precip_accum","last_report":"2021-12-03T05:43:00-0800","total":0.0}, {"count":1,"first_report":"2021-12-03T06:43:00-0800","interval":3,"report_type":"precip_accum","last_report":"2021-12-03T06:43:00-0800","total":0.0}, ... ... {"count":1,"first_report":"2021-12-10T02:43:00-0800","interval":167,"report_type":"precip_accum","last_report":"2021-12-10T02:43:00-0800","total":0.0}, {"count":1,"first_report":"2021-12-10T03:43:00-0800","interval":168,"report_type":"precip_accum","last_report":"2021-12-10T03:43:00-0800","total":0.0}]}, "RESTRICTED":false,"LATITUDE":"37.77056","TIMEZONE":"America\/Los_Angeles","ID":"21034"}], "SUMMARY":{"DATA_QUERY_TIME":8.5589885712,"RESPONSE_CODE":1,"RESPONSE_MESSAGE":"OK","METADATA_RESPONSE_TIME":"1.64604187012 ms", "NUMBER_OF_OBJECTS":1,"PRECIP_DATA_TIME":28.7299156189,"DATA_PARSE_TIME":20.1499462128}}

DEVELOPER

There are limitations to synaptic API using free tier token. Refrain from designing unnecessary or duplicative calls during API development. Limitations for number of API calls is 2000, and number of Service Units is 2 million. When either of these limits is reached, data stops. The response looks like:
{"SUMMARY": {"RESPONSE_CODE": 20, "RESPONSE_MESSAGE": "Account usage has exceeded the free tier. Please see https://synopticdata.com/pricing/ for more options.", "RESPONSE_TIME": "0 ms"}}

The url requires UTC time. Convert local date to UTC. But returned date can be local.

Unused meso.any_county() to map other CA counties stations

REFERENCES

UPDATES

BS 2023 MAR

BS 2022 JAN

BS 2021 DEC