Flow Layer
The Flow Layer is an effective way of visualizing origin-destination movement patterns. Flows are a great choice for analyzing traffic flows, commute patterns, and migrations.

An example of a Flow Layer.
Create a Flow Layer
To create a Flow Layer, create a new layer, then select Flow Layer.
The following columns are used to create a Flow layer:
Column | Type | Description |
---|---|---|
Source Lat | number | Required. The latitude of source/origin points. |
Source Lng | number | Required. The longitude of source/origin points. |
Target Lat | number | Required. The latitude of target/destination points. |
Target Lng | number | Required. The longitude of target/destination points. |
Count | number | A count of trips between source/target pairs. Count is the weight value for all flows. If not defined, each row containing a source/target pair is counted as one trip. |
Source Name | string | The name/label for source points. Appears in tooltips and cluster names. If not defined, the latitude and longitude of the source points are used. |
Target Name | string | The name/label for target points. Appears in tooltips and cluster names. If not defined, the latitude and longitude of the target points are used. |
Creation with H3 Data
The Flow Layer also supports H3 data for source/target locations.
Column | Type | Description |
---|---|---|
Source H3 | number | Required. The H3 indexes of source/origin points. |
Target H3 | number | Required. The h3 indexes of target/destination points. |
Count | number | A count of trips between source/target pairs. Count is the weight value for all flows. If not defined, each row containing a source/target pair is counted as one trip. |
Source Name | string | The name/label for source points. Appears in tooltips and cluster names. If not defined, the latitude and longitude of the source points are used. |
Target Name | string | The name/label for target points. Appears in tooltips and cluster names. If not defined, the latitude and longitude of the target points are used. |
Layer Attributes
Flow Layer attributes include Color, Fade, and Display.
Color
Color properties:
-
Color palette - Select a color palette to color the Flow Layer.
Colors are mapped to the number of flow counts between a source and target point. (See Count in the table above.)
-
Dark base map - Enable/Disable dark base map mode.
Toggle on if using a dark base map or toggle off if using a light base map to improve the clarity of flows.
-
Opacity slider - Slide to increase/decrease the opacity of the Flow Layer.
Suggestion: Use May Overlay Blending to improve the visibility of base map features such as labels and roads.
Fade
Fade properties:
- Fade toggle - Enable/Disable fading of flows.
- Fade slider - Slide to fade flows with smaller Count values.

Left: Fade = 0; Right: Fade = 30.
Display
Display properties:
- Animation toggle - Enable/Disable animated flows.

Flow Layer animation.
-
Clustering toggle - Enable/Disable clustering of flows.
Clustering groups nearby source/target points to increase visibility, and adapts as you zoom in and out.

Left: Clustering off; Right: Clustering on.
-
Location Totals toggle - Enable/Disable location total circles.
The size of the location total circles is based on the number of flows in and out of the location.

Left: Location totals off; Right: Location totals on.
-
Adaptive Scales toggle - Enable/Disable adaptive scaling for flows.
Adaptive scaling adjusts flow thickness based on flows inside the current viewport. When disabled, flow thickness is based on all flows on the map.
-
Max Top Flows to Show slider - Slide to increase/decrease the max number of flows displayed.
Properties
For details on how to programmatically specify layer properties, refer to the Layer Configuration specification.
Charts
The Flow Layer supports Tooltip Charts. Using the Tooltip Chart with the Flow Layer, you can display chart metrics in the mouse-over tooltip. This allows users to interactively explore the top origins and destinations for any given point on the map.
Follow these steps to create a Flow Layer chart:
1. Create a Flow Layer, then click Show Charts.
2. Click Add Chart, then select Tooltip Chart.
3. A chart of the flows will automatically generate. Click Chart Settings to configure the Tooltip Chart.

A Flow Chart showing Chicago rideshare data.
The charts will update to the viewport when zooming to show the clustered locations for the current zoom level.
Chart Settings
Options | Description |
---|---|
Title | Title of the Tooltip Chart. |
Layer | Layer to represent in the chart. |
Field and Aggregation | The type of information to display (based on the layer selected). |
Show in Tooltip | If enabled, displays chart metrics in the mouse-over tooltip. |
Include Internal Flows | If enabled, includes internal flow data in the chart metrics. |
Updated about 2 months ago