All routesrequirethe following parameters:
lat
lng
And they all accept the following optional parameters:
limit
maxDistanceKm
maxDistanceMiles
Note that limit
applies to each each location type returned by the /near-me/
api.
source
(e.g. 'airnow','wrcc', etc.)/near-me/aq-monitors?lat=48.0&lng=-122.1
{
"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
}
]
}
/near-me/purple-air?lat=48.0&lng=-122.1&limit=1
{
"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
}
]
}
/near-me/fires?lat=36.8080988&lng=-102.8047927,14.54&limit=1
{
"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
}
]
}
/near-me/nifc?lat=36.8080988&lng=-102.8047927,14.54&limit=1
{
"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
}
]
}
/near-me/raws-stations?lat=36.8080988&lng=-102.8047927,14.54&limit=1
{
"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
}
]
}
source
(e.g. 'airnow','wrcc', etc.; only applies to AQ monitors)/near-me/?lat=45&lng=-123&maxDistanceMiles=2
{
"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":[]
}