Near Me Web Service

Request Parameters

All routesrequirethe following parameters:

And they all accept the following optional parameters:

Note that limit applies to each each location type returned by the /near-me/ api.

Endpoints

AQ Monitors

Additional parameters
  • source (e.g. 'airnow','wrcc', etc.)
Example request
/near-me/aq-monitors?lat=48.0&lng=-122.1
Example reponse
{ "query":{ "lat":"48.0", "lng":"-122.1", "limit":"1" }, "params":{ "nearByType":"aq-monitors" }, "aqMonitors":[ { "unit_id":"1b6a36f981c2e241_840530611007", "lat":48.0543, "lng":-122.1715, "site_name":"Marysville-7th Ave", "utc_ts":"2022-12-14T19:00:00+00:00", "local_ts":"2022-12-14T12:00:00+00:00", "timezone":"America/Los_Angeles", "source":"AirNow", "deployment_type": "Permanent", "device_type": "Monitor", "raw_pm25":7, "distanceMiles":5, "direction":"NE", "bearing":37.59086697483516 } ] }

Purple Air Sensors

Example request
/near-me/purple-air?lat=48.0&lng=-122.1&limit=1
Example reponse
{ "query":{ "lat":"48.0", "lng":"-122.1", "limit":"1" }, "params":{ "nearByType":"purple-air" }, "purpleAir":[ { "unit_id":"164581", "lat":48.027775, "lng":-122.07493, "utc_ts":"2022-12-14T22:00:00+00:00", "local_ts":"2022-12-14T15:00:00+00:00", "timezone":"America/Los_Angeles", "raw_pm25":8.6, "corrected_pm25":5.3, "nowcast":5.5, "distanceMiles":2.2, "direction":"NNW", "bearing":330.9545067719408 } ] }

Satellite Detections

Example request
/near-me/fires?lat=36.8080988&lng=-102.8047927,14.54&limit=1
Example reponse
{ "query":{ "lat":"36.8080988", "lng":"-102.8047927,14.54", "limit":"1" }, "params":{ "nearByType":"fires" }, "fires":[ { "lat":45.793989, "lng":-72.422495, "source":"ANALYSIS", "satellite":"NOAA 20", "frp":-999, "yearday":2022348, "ecosys":55, "time":620, "distanceMiles":null, "bearing":null } ] }

NIFC

Example request
/near-me/nifc?lat=36.8080988&lng=-102.8047927,14.54&limit=1
Example reponse
{ "query":{ "lat":"36.8080988", "lng":"-102.8047927,14.54", "limit":"1" }, "params":{ "nearByType":"nifc" }, "nifc":[ { "lat":45.89847, "lng":-93.35657, "irwinID":"b48bf14d-060f-4093-aa93-40a9dd91a6bb", "incidentName":"312105", "dailyAcres":0.6, "percentContained":null, "fireCause":null, "uniqueFireIdentifier":"2022-MNMNS-312105", "createdOn":"2022-11-03T13:22:13+00:00", "modifiedOn":"2022-11-03T13:22:13+00:00", "distanceMiles":null, "bearing":null } ] }

RAWS Stations

Example request
/near-me/raws-stations?lat=36.8080988&lng=-102.8047927,14.54&limit=1
Example reponse
{ "query":{ "lat":"36.8080988", "lng":"-102.8047927,14.54", "limit":"1" }, "params":{ "nearByType":"raws-stations" }, "rawsStations":[ { "lat":46.45805556, "lng":-85.62722222, "stationId":"201302", "siteName":"SPINCICH LAKE", "elevation":896, "distanceMiles":null, "bearing":null } ] }

Everything (AQ monitors, Purple Air Sensors, etc.)

Additional parameters
  • source (e.g. 'airnow','wrcc', etc.; only applies to AQ monitors)
Example request
/near-me/?lat=45&lng=-123&maxDistanceMiles=2
Example reponse
{ "query":{ "lat":"45", "lng":"-123", "maxDistanceMiles":"2" }, "aqMonitors":[ { "lat":44.9766, "lng":-122.9763, "monitorId":"971dc2efb0ce14d2_840410470022", "siteName":"Salem Chemeketa Community College", "timezone":"America/Los_Angeles", "source":"AirNow", "lastValidUTCTime":"2022-12-21T22:00:00+00:00", "pm25":2.9, "distanceMiles":2, "direction":"SSE", "bearing":150.96249517656287 } ], "rawsStations":[], "purpleAir":[ { "lat":45.01753, "lng":-123.01664, "sensorIndex":"15143", "ts":"2022-12-22T00:00:00+00:00", "timezone":"America/Los_Angeles", "pm25":2.2, "epaPm25":4.4, "nowcast":3.9, "distanceMiles":1.5, "direction":"NNW", "bearing":334.23045898808414 },{ "lat":45.005024, "lng":-123.04028, "sensorIndex":"20823", "ts":"2022-12-22T00:00:00+00:00", "timezone":"America/Los_Angeles", "pm25":6, "epaPm25":4.6, "nowcast":4.7, "distanceMiles":2, "direction":"WNW", "bearing":284.39072055804826 } ], "fires":[], "nifc":[] }