O/D Analysis

Create your first analysis

The process begins with selections on the New report dialog, then everything is configured on a single page.

New report dialog

Select Flow Matrix as Report type, then fill in the Report name field.

The New report dialog
The New report dialog

Left panel - report configuration

The left panel is where you configure every part of the report — dates, times, regions, filters and settings.

The left panel right after creating a new Flow Matrix report
The left panel right after creating a new Flow Matrix report

Report name

The header of the left panel displays the report name and lets you edit it. The API button lets you get the current analysis parameters as a request in .json format, which can be posted directly to the API. The icons on the right let you Collapse/Expand all sections and Collapse/Expand panel.

The left panel header, with the report name and its API and collapse icons
The left panel header, with the report name and its API and collapse icons

Dates section

Add a date range by clicking Create new date, or reuse a saved one with Add from template. Use the weekday buttons for a quick selection of Everyday, Weekdays, or Weekend, or click individual days directly on the calendar to exclude them from the range.

Creating a date range, with weekday exclusions selected
Creating a date range, with weekday exclusions selected

Click the calendar icon in the From or To field to open a calendar popover for quickly jumping to a specific month or year, instead of paging through months one at a time.

Quickly jumping to a specific month in the date field's calendar popover
Quickly jumping to a specific month in the date field’s calendar popover
Quickly jumping to a specific year in the date field's calendar popover
Quickly jumping to a specific year in the date field’s calendar popover

Once dates are added, the Dates section shows an overview where you can edit, delete or save date ranges as a template, or remove every range at once with Delete all in the section header.

The Dates section overview, with two date ranges added
The Dates section overview, with two date ranges added

Times section

Define time ranges using Add new time range.

Adding a new time range
Adding a new time range

Alternatively, pick a previously saved time range from Add from template.

Picking a time range from a saved template
Picking a time range from a saved template

You can also generate a full set at once with the Time ranges component — pick a bucket size and click Generate.

Generating a full set of time ranges from a bucket size
Generating a full set of time ranges from a bucket size

Regions

To define analysis regions, either draw them on the map using any of the Drawing tools (see Drawing tools) or use the Upload button.

If you only need Origin-Destination pairs and don’t need Via information, turn on the Origin - Destination only toggle — this also raises your region limit, multiplied by 3 (default: 1,800).

The Regions section before any region has been added
The Regions section before any region has been added

The list of added regions shows their total count, editable names, area size and delete icons. Click a region name to change it. While editing, use the arrow up/down keys to move to the previous/next region.

Editable regions show an edit-shape icon in the list, which also appears as the cursor when hovering the region on the map. Click the icon, or click the region on the map, to reshape it — see Editing a region’s shape.

Use the button below the region list to download your regions as a GeoJSON .json file.

The Regions section with a list of added regions
The Regions section with a list of added regions

Filters

Use the Vehicle types filter to limit the analysis to specific vehicle categories.

The Filters section
The Filters section

Settings

Use this section to disable Trip statistics and reduce processing time for large analyses, if you don’t need them. The Timezone selector lets you change the timezone, which is automatically derived from the analysis region geometries.

The Settings section
The Settings section

Report validation

If any report parameters are invalid, you’ll see a banner at the bottom of the left panel explaining what’s wrong. When the issue comes from a specific section, that section’s header also shows an error icon with a tooltip explaining why.

A validation banner shown after the drawn regions exceed the area limit
A validation banner shown after the drawn regions exceed the area limit

Map area - region selection

Map controls

Use the controls in the top-right corner of the map area to:

  • Search for a coordinate or address
  • Read and change the current map zoom
  • Select the base map style
  • Center the map view on drawn regions
  • Take a screenshot of the current map canvas
The map style menu, with Street dark selected
The map style menu, with Street dark selected

Drawing tools

Use the Drawing tools in the top-left corner of the map to draw or select analysis regions. Choose from a circle, rectangle, polygon, (freehand) shape painter, a grid (square or hexagonal cells), an administrative area, or select a road segment directly from the road network.

For administrative areas, choose the data source: Default, Overture Maps, or, for the UK only, UK Ordnance Survey.

While drawing, keyboard shortcuts are also supported: Escape cancels the shape, Backspace removes its last point, and Enter confirms it.

Selecting an administrative area as a region using the Drawing tools
Selecting an administrative area as a region using the Drawing tools

Editing a region’s shape

Click an editable region on the map, or its edit-shape icon in the region list, to adjust its shape. Drag a corner to move it, drag the midpoint of an edge to insert a new corner there, or drag the region’s center to move it around the map. Click the region again, or click elsewhere on the map, to stop editing.

A drawn region in edit mode, with corner handles shown for reshaping it
A drawn region in edit mode, with corner handles shown for reshaping it

Map version selector

Use the Map version selector to change the map version used for map matching. The recommended map version is selected based on the chosen date ranges and geometries. The Road network of the selected map version toggle shows or hides the road network, visible from zoom 13-20. Its legend is shown in the bottom-right corner of the map area.

The expanded map version selector
The expanded map version selector

Map matching is disabled once the regions’ convex hull exceeds 3,000 km², and the map version selector shows a warning.

The map version selector disabled, with the convex hull boundary shown on the map
The map version selector disabled, with the convex hull boundary shown on the map

Bottom bar - status and actions

The bottom bar shows the report’s status, usage limits and creation actions throughout the configuration process.

Information icon

The information icon’s tooltip explains the next steps in the creation process.

The information icon's tooltip
The information icon’s tooltip

Report limits

The bottom bar shows gauges for your report’s usage limits, so you can see at a glance how close you are to each limit while configuring the report.

The report limit gauges in the bottom bar
The report limit gauges in the bottom bar

Pricing coverage

Current pricing coverage information is displayed in the middle of the bar. If it exceeds the limit, the bar turns red. Clicking Preview shows the buffer of roads used to calculate the report’s price.

This buffer of roads is not related to counting trips at all. It’s only for informative purposes, to calculate the price of your report based on Functional Road Classes (FRC) from 0 to 5 and the regions defined in your analysis. Each region also includes a buffer of at most 10 km around its boundary. When regions or their buffers overlap or sit close together, shared roads are only counted once, so the total is not simply the sum of each region on its own.

Pricing coverage does not change with the number of date ranges or time sets in your report — it depends only on the regions you select. This is the coverage for a single report — how coverage across multiple reports is billed depends on your pricing model and contract.

Previewing the pricing coverage buffer on the map
Previewing the pricing coverage buffer on the map

Actions

The right side of the bottom bar lets you Cancel the creation process, Save as draft, or Generate report.

The Cancel, Save as draft and Generate report actions
The Cancel, Save as draft and Generate report actions

Resuming a report

If a previous report creation was interrupted by closing the page, the application offers to restore its dates, times and regions the next time you open the creation dialog.

The prompt offering to restore a previous report's dates, times and regions
The prompt offering to restore a previous report’s dates, times and regions