This guide walks you through how to create, configure, run, and view a Patrols Workflow in Ecoscope. This workflow is used to visualize and analyze patrol movement and related events from your connected data source.
 

Results Dashboard

When a Patrols Workflow is successfully run, it produces a dashboard with multiple components tailored to the configuration choices you made. The dashboard helps you visualize and explore patrol routes, patrol activity, and related events.

The dashboard is the full results page generated by your workflow. It’s made up of maps, charts, or metrics that update based on the data you selected in your configuration.
 

The Dashboard May Display (depending on configuration):

Summary Metrics: These provide a quick snapshot of Patrol activity over the selected time range. These metrics can be affected by the view selected. 

• Total Patrols – Number of patrols included in the results.
• Total Time – Combined duration of all patrols.
• Total Distance – Combined distance covered by patrols.
• Average Speed – Average movement speed across all patrols.
• Max Speed – Highest recorded speed among all patrols.
  
  Map Widgets
  • Trajectories & Patrol Events Map: Displays patrol tracks, styled according to your trajectory styling choice (e.g., patrol type or status), with related events plotted on the same map.
  • Time Density Map: Displays a heatmap showing where patrols spent the most time.
     

• Chart Widgets
  • Patrol Events Pie Chart: Shows the proportion of different Event Types recorded during Patrols.
  • Patrol Events Bar Chart: Shows the number of Patrol-related Events over time.

• Dashboard Features
  • Filter results based on grouping criteria you defined during configuration.
  • Rearrange dashboard widgets to suit your preferred layout.
  • Save the current view of any map or chart as a PNG image using the camera icon in its panel. The saved image reflects exactly what is visible in the widget at that moment, including any zoom, pan, or resizing you’ve applied.
     

Configure New Workflow

To create a Patrols Workflow, go to Workflow Templates from the top navigation and select Patrols Workflow.

Data Sources

Select a Data Source from the dropdown. If only one data source is configured, it will be selected automatically and you will be shown the Workflow Configuration page. 
Note: You won’t be able to proceed unless at least one data source has been connected.

Workflow Details

This section allows you to name and describe your workflow so that it’s easy to find and identify your workflow. Especially if you’re managing multiple workflows across projects and data sources.

• Workflow Name: This must be unique. If you try to submit a name that has already been used, you’ll receive a validation error.
• Workflow Description: This is optional. The description will be displayed on the dashboard to help you or your team remember the configuration context or analytical purpose of the workflow.

Time Range

This section defines the time window of the data you want to analyze. The selected time range determines how much data will be pulled from your data source and directly impacts what’s displayed on your dashboard. 
You will configure:

Since: Start date and time
Until: End date and time
Timezone - Required to provide fidelity over precise time selection 

Patrol and Event Types

Use these settings to decide which patrols and events are included in your analysis. Leaving fields blank will include all available data for that category.

• Patrol Types: Select one or more Patrol Types to analyze. Leave empty to include all Patrol Types.
• Event Types: Select one or more Event Types to analyze. Leave empty to include all Event Types. (Note: only V1 event types are supported at this time.)

Include Events Without Geometry – Enable this checkbox to include Events that do not have location data (no point or polygon). 

Advanced Configuration

Patrol Status: Narrow the analysis to patrols with a specific status. If left empty, patrols of all statuses are included.

Group Data 

Organize Patrol data into different views within a single dashboard.

• Group by Category: Options include patrol type, patrol status, patrol subject, patrol serial number.
• Group by Time: Options include year, month, year/month, day of year, day of month, day of week, hour, or date.
  
  When you switch between views, dashboard widgets (maps, charts, counts) update to show only that filtered data.
  Adding many groupings can slow processing; keep them focused on your analysis needs.

Trajectory Category

Choose how to color patrol tracks on the map. Ecoscope assigns a unique color to each Patrol based on the category you select, making it easier to compare and distinguish between them.
Options include: 

• Patrol Type
• Patrol Status
• Patrol Subject
• Patrol Serial Number

Patrol Events Bar Chart 

The Patrol Events Bar chart summarizes how many Patrol-related Events occurred over time, helping you identify trends, spikes, or gaps in patrol activity.

You can control how the data is grouped along the x-axis by selecting a time interval:

• Time Interval: Year, Month, Week, Day, Hour
• Shorter intervals (like hour or day) give more detailed views, while longer intervals (like month or year) are better for seeing big-picture trends.

Advanced Configuration Options

The sections that follow — Trajectory Segment Filter, Patrol Event Location Filter, Map Base Layers, and Time Density Map — appear after the required workflow settings and are optional configurations.

Trajectory Segment Filter

Use this filter to clean up Patrol tracks by removing segments that are too short, too long, too slow, or too fast to represent meaningful movement. This helps reduce GPS noise and ensures that only realistic patrol trajectories appear on your dashboard.

To configure, set the acceptable ranges for patrol track segments:

• Minimum and Maximum Segment Length 
• Minimum and Maximum Segment Duration
• Minimum and Maximum Segment Speed

Patrol Event Location Filter

This advanced configuration allows you to filter which events are included in the workflow based on their geographic location. It’s useful for narrowing down analysis to a specific area of interest.

Apply Coordinate Filter:

• Bounding Box: Filter events to inside the specified coordinates.
  • Min Latitude, Max Latitude, Min Longitude, Max Longitude
  • Default: (-90, 90, -180, 180)
  • Note: By applying a bounding box, events recorded outside this area will be excluded from the workflow results.
• Filter Point Coordinates: If you need even more precise control, specify exact latitude and longitude values. Events that do not match the specified coordinates will be excluded.

Map Base Layers 

This section controls the map layers displayed on your Trajectories & Events Map and Time Density Map.
Note that adding more than one map will result in the first basemap being drawn first, then the other basemaps layered on top with the last basemap being the topmost layer. Use the opacity to adjust how these interact.

• Default: Terrain base layer with Satellite overlay at 50% opacity.
• Other options: OpenStreetMap, Roadmap, Satellite, LandDx, USGS Hillshade, or Custom Layer.

For each basemap, you can:

• Adjust Layer Order (first is drawn first, last is topmost)
• Adjust Layer Opacity (1 = fully visible, 0 = hidden)

Time Density Map (Optional)

Use these settings to create a heatmap that highlights where Patrols spent the most time.

• Auto Scale: EcoScope optimizes grid resolution automatically.
• Custom: Define your own grid cell size (resolution in meters per pixel).

Once all required fields are complete, click Submit.

Run the Workflow

After submission, you’ll be returned to the My Workflows view. Your new workflow will appear in the list with: 

In the table, your workflow will show:

• Status: Ready
• No values yet for Last Run Start or Last Run Duration
• A Run button will be available

Click Run to process the workflow.

Note: Processing time depends on the time range and the amount of event data. Large queries may take up to 10 minutes. 

If the workflow fails, the status will show Failed. Refer to the Common Errors and Causes in case this happens to you. 

View the Dashboard

Once the workflow finishes (status: Success), click the workflow name to open the dashboard.

Explore your maps, toggle between grouped views, and download PNGs of any map or chart for reports or presentations.