Helios APIs: Alerts (Search)
To return a list of alerts near a given location, we can query the Search method in the Alerts API using a variety of query parameter options, depending on our particular needs.
To search for alerts located near Phoenix, AZ using a bounding box our API request looks like this:
We can also search for alerts in the same area using a latitude, longitude, and radius:
If we need more precision on the area of interest where we want to search, we can query using a polygon:
https://api.helios.earth/v1/alerts?polygon=-113.835 32.412,-113.835 34.473,-110.374 34.473,-110.374 32.412,-113.835 32.412
We can identify all of the alerts in the entire state of Arizona using the state query parameter:
When requesting route information from services like Google Maps or Mapbox Directions, the route is often provided as an encoded polyline. We can used this polyline to perform a polygon search around the given route. To search for alerts along of a stretch of Interstate 10 in Phoenix, AZ our query looks like this:API documentation for more information on specifying different values for the polyline precision and radius used to compute the search polygon.