Map reports

Plot requests as bubbles sized by count, on an OpenStreetMap-backed Leaflet map. Replaced the previous “Heatmap” rendering in v1.51 — bubbles read better at small data sizes.

Who this is for: Owners and Admins, and anyone granted the Organization Insights capability (reports_manage).

How it works

• Each request row stores latitude + longitude if its Recipient Location could be geocoded.
• New requests geocode automatically on save.
• Existing rows (before the geocoding feature shipped) need a one-time backfill.
• The Map chart groups rows into ~110m location buckets server-side, so the client receives {lat, lng, count, label} per bucket — not raw per-request coordinates.

Steps

1. In Organization Insights, click Edit on a report over the Requests dataset (or + New report and pick Requests), then set Chart type to Map.
2. If you see “No geocoded requests yet”, click Backfill existing rows. CartonCrew geocodes up to 50 rows per click via the US Census geocoder (digit-bearing addresses) + Nominatim fallback (city-only), then says how many it geocoded and how many are still missing.
3. Pace yourself — Nominatim asks for ≤ 1 req / s; CartonCrew enforces this, so one click can take close to a minute.
4. After backfill, the Map populates with bubbles. Click a bubble for the city + request count popup.

A Map report is not exported by Reports Manager: its PDF says map reports are not exported in this version.

What you’ll see

Common issues

• Map tiles are grey — CSP issue blocking OpenStreetMap tile hosts. Should be fixed since v1.49.4; if you see this in v1.51+, file a bug.
• Double zoom controls — fixed in v1.51.
• Bubble count smaller than total request count — only requests with geocoded latitude/longitude appear. The line under the map counts the locations and requests it plotted; after a backfill click, the result line says how many are still missing.

Last updated: 2026-09-24 · Applies to: CartonCrew v1.56+