Skip to main content

Crash Query - Build Your First Query

Build your first crash query step by step: filter crashes, view a crash, use metrics, save, and download a report.

Written by Lauren Miller

New to Crash Query? In this tutorial, you'll build your first crash query from start to finish: find the fatal and serious injury crashes in one county, look at a single crash, spot a pattern in the metrics, save your query, and download a report.
​

The examples use Dane County, Wisconsin. Follow along with a county you work on; the steps are the same.

ℹ️ Note: The fields, values, and colors you see depend on your organization's configuration, so your screen may look a little different.

Open Crash Query

Open Crash Query from the apps menu. A new query opens with the Filter Bar across the top, the map in the middle, and the Sidebar on the right.
​

A new Crash Query with the Filter Bar, date range, map, and Sidebar outlined in green

(A new query)
​

If your organization adds default filters to every new query, you'll already see them in the Filter Bar. You can keep or remove them.

Filter Crashes

Start by narrowing the map to the crashes you care about.
​

Filter to One County

  1. Click Add Filter.

  2. Type County in the search box and choose your county field. In this example, it's County (Crash Report).

  3. Type your county's name, check it, and click Apply.

County (Crash Report) filter with Dane checked and the Apply button outlined in green

(Choosing a county)
​

💡 Tip: The County (Crash Report) field uses the county written in the crash report. A geo filter, such as County Geo-Located (Geo), uses the crash's location on the map instead, so the two can return different counts. Geo filters have (Geo) in their names. See Location Filters - Geo vs. Non-Geo Filters to choose the right one.

Add Crash Severity

  1. Click Add Filter again, type Severity, and choose your crash severity field. In this example, it's Crash Injury Severity.

  2. Check the fatal and serious injury values (here, Fatal Injury (K) and Suspected Serious Injury (A)), then click Apply.

Crash Injury Severity filter with Fatal Injury (K) and Suspected Serious Injury (A) checked and the Apply button outlined in green

(Choosing crash severities)
​

The map, crash count, and metrics in the Sidebar update right away.
​

Filter Bar with the County (Crash Report) and Crash Injury Severity filters and the crash count outlined in green

(Both filters applied)
​

💡 Tip: A crash has to match every filter in the Filter Bar (County and Crash Injury Severity), but only one of the values you checked in a filter (Fatal Injury or Suspected Serious Injury). Learn more in How Filters Work Together.

Check the Date Range

The date range at the top right sets which crashes are included by date. Click it to change the dates.

View a Crash

  1. Zoom in on the map until you see numbered crash clusters. The number is how many crashes the cluster holds.

  2. Click a cluster to break it apart. Zoom in more if the crashes are still grouped.

  3. Click a single crash. The Crash Flyout opens on the right.

A selected crash on the map, outlined in green, with the Crash Flyout open on the right

(The Crash Flyout)
​

The details you see depend on your organization's configuration. Click the X at the top right of the flyout to close it. If a crash doesn't belong in your query, you can exclude it from the flyout.

Use Metrics

The Metrics tab in the Sidebar breaks your filtered crashes down by attribute, with counts and percentages. Use it to spot patterns.

  1. Scroll through the metrics and find one that stands out, such as Manner of Collision.

  2. Hover over a value, such as Front To Rear. If + Add a filter shows below it, you can filter by it. Not every metric can be a filter.

  3. Click the value to add it as a filter. The map and metrics now show only those crashes.

Front To Rear in the Manner of Collision metric, with + Add a filter below it, outlined in green

(Adding a filter from Metrics)
​

To go back, click the X on that filter in the Filter Bar.

Save a Query

  1. Click Save at the top right.

  2. Type a name, such as My First Query. Choose a category, or leave it blank to use Uncategorized.

  3. Click Save.

Save Crash Query window with the name My First Query and the Save button outlined in green

(Saving the query)
​

Your filters, date range, metrics, and exclusions are saved with the query. To open it later, click Home at the top left and find it in your library.
​

Home button outlined in green at the top left of Crash Query

(Home opens your saved queries)
​

Download a Report

Finish by downloading a PDF report of your query to share.

  1. Click Download at the top right, next to the date range.

  2. Choose Summary.

Report window with the Summary report outlined in green

(Choosing a report)
​

3. Type a report title, and add who requested it if you like. Then click Create Report.
​

Report Options window with Report Title, Requested By, and the Create Report button outlined in green

(Report options)
​

4. A preview of the report opens. Click Save & Download at the top right.
​

Crash Summary Report preview titled My First Query, with the Back and Save & Download buttons outlined in green

(The report preview)
​

The PDF downloads to your computer and is saved in Reports > Archives, where you can download it again. The report uses your current filters and date range. To export the crash records as a spreadsheet instead, use the Raw Table tab in the Sidebar.
​
Click Back to go back to your query.
​

Next Steps

You've built your first crash query, saved it, and downloaded a report. When you're ready for more, try these:

Did this answer your question?