This tutorial explains how to use the Alerts feature to enable an alert for a data type based on user-configurable conditions such as date and time, location, and any other data-specific field.
At the end of this tutorial, you’ll be able to
- Create a custom alert
- Group data fields together to create a multi-line chart
- Export the Alerts data
1. Creating Alerts
To create an alert, navigate to the insights page and then select explore on the data type you'd like to create an alert on. For this example, we're going to create an alert on Building Demolitions in Detroit and compare demolitions with the locations of a murals created in a community dataset by the Detroit Mural Project. This will create an alert anytime a demolition in Detroit occurs on a mural location.
Alerts Manager Page with no alerts created
Once at this page, select create an alert. On the following page, you'll name and describe your alert and customize the conditions for your alert to fire. To customize the conditions, select a list of data fields to match. In this example, we're going to use the locations of murals as a condition to create an alert. To do this, we exported a GeoJSON of murals and then drag and dropped the GeoJSON file on the demolitions location filter.
Location alert on mural locations
After setting your conditions, you can select a time interval to trigger the alert. This is configurable from milliseconds to days. Select save once you're satisfied with the alert. After you save out, you'll be taken back to the alert manager page for that data type. If you have multiple alerts on the same data type, they'll show up here as well along with a number that shows the amount of alerts generated.
2. Analyzing alerts with charts
Once your alert has fired, a line chart will auto-generate with the alerts created over time. You can modify what fields you'd like to group on the chart by selecting group by, as well as changing the time interval by selecting the dropdown labeled "by hour". Below is a separate example showing illegal parking, grouped by reason for violation.
Alerts for vehicles parked illegally, grouped by reason for citation
3. Export your results
To export your alert results, select the export dropdown and then select from either CSV, JSON, or GeoJSON.
“Every generation must build its own city.”
Antonio Sant'Ella, Manifesto of Futurist Architecture
Have any questions or running into issues with this feature?
Reach us at: firstname.lastname@example.org