Get Started

Map Clusters & Markers

2 min read

Table of contents

Engage+

When you open Map View, you don't see one marker per carrier — you see groups. Clusters combine nearby leads into a single circle with a count, then split apart as you zoom in. This article covers how clusters work, what colors mean what, and how to actually drill down to a specific carrier.

Why Cluster At All? #

A pipeline with a few hundred carriers in one metro area would render as a wall of overlapping markers — useless for anything. Clustering keeps the map readable at every zoom level by collapsing nearby markers into one circle that says "42 carriers in this area." Zoom in and the cluster splits.

Cluster Sizes & Colors #

The cluster bubble's size and color reflect how many carriers it contains:
Small clusters

Under 10 leads. 40px bubble in DOT Lead Scout's primary blue.

Medium clusters

10 to 49 leads. 50px bubble in amber. These are usually city-level groupings.

Large clusters

50+ leads. 60px red bubble. Major metro areas with dense carrier populations.

How Clustering Works Technically #

Clustering is powered by the Supercluster library, which builds a spatial index of every marker once and queries it as you pan and zoom:
SettingValueWhat it means
Cluster radius80 pixelsMarkers within 80px of each other on screen group together.
Min cluster size2 markersA single marker never becomes a cluster of one.
Max cluster zoom15Beyond zoom level 15, clusters always split into individuals.
Re-render triggerMap idleClusters recompute after you finish a pan or zoom action.

Clicking a Cluster #

Click the bubble

Map zooms in 2 levels and re-centers on the cluster.

Cluster sidebar opens

A panel slides in from the left with every lead in that cluster.

Sorted by quality

Leads in the sidebar are ordered by quality score (highest first), then by name.

Search within

Use the sidebar's search box to filter the list by carrier name, city, or DOT number.

Pick a lead from the sidebar

Clicking a lead in the cluster sidebar centers the map on that exact carrier and opens the full lead detail panel — same panel you'd see from the pipeline list.

Individual Lead Markers #

Once you're zoomed in past a cluster, you see one circle per carrier. Marker colors are coded by the carrier's highest-priority badge:
ColorMarker typeMeaning
RedHotAudit deadline approaching
GreenHigh ValueDriver-to-truck ratio at or above 1.5x
BlueNew EntrantAuthority granted in the last 18 months
OrangeAt RiskConditional safety rating
PinkHAZMATAuthorized for hazardous materials
PurpleStandardDefault lead with no priority badge
Carriers with multiple badges

If a carrier qualifies for more than one badge (e.g. Hot AND HAZMAT), the marker uses the higher-priority color. The full list of badges still shows in the marker info popup.

Clicking an Individual Marker #

Single-click any individual marker to open a quick-info popup. It shows:
  • Company name
  • City and state
  • Phone number (if on file)
  • Driver and power-unit counts
  • Quality score with color-coded label (Excellent / Good / Average / Low)
  • Safety rating if known
  • Badge icons for any active priority badges
  • "View Full Details" button — opens the same lead detail panel you'd see from anywhere else in the portal

Clinic Markers #

Your clinic locations also appear on the map, but they look and behave differently from lead markers:
  • Pin shape — not a circle. Looks like a Google-Maps-style location pin in DOT Lead Scout's navy color.
  • Always on top — clinic markers have a high z-index, so they're never hidden behind clusters or lead markers.
  • Don't cluster — clinic pins are always individually visible, even at far-out zoom levels.
  • Click to see clinic info — popup shows the clinic name and a Primary badge if it's your primary location.
Updated on April 29, 2026
Was it helpful ?