GroundCut + Mapbox

Mapbox is the geographic backbone of GroundCut. It powers address geocoding on the booking page, satellite imagery for the lawn trace, drawing via mapbox-gl-draw, and the Directions API behind route optimization. There’s nothing for you to set up — Mapbox is already wired in. The integration is invisible by design.

What the integration does

  • Geocodes addresses on the booking page (address text → lat/lng), cached in property_data so returning customers don’t re-geocode.
  • Renders satellite-streets imagery at zoom level 18 over the geocoded address for lawn tracing.
  • Provides mapbox-gl-draw for the customer’s drawing UI — tap to add points, undo, redraw.
  • Calculates drive times between jobs via the Directions API for capacity, route planning, and per-job profitability.
  • Powers route optimization via nearest-neighbor over a Mapbox-built distance matrix.

What’s automated

  • Geocoding cached cross-tenant in property_data so the same address is geocoded once across all tenants.
  • Satellite tile requests are routed through GroundCut’s Mapbox account — your tenant doesn’t need a Mapbox account of its own.
  • Drive-time calculation runs server-side on every quote so the per-job profitability number reflects actual distance, not crow-fly miles.
  • Route optimization is one-click from /admin/jobs (Plan route on a date) — the day’s queue reorders by drive time.

Setup steps

  1. 1Nothing. Mapbox is preconfigured at the platform level — geocoding, satellite tiles, lawn drawing, and Directions are wired in for every tenant out of the box.
  2. 2No tenant-level configuration is required to use geocoding, satellite tiles, lawn trace, or route optimization.
  3. 3If you’re a high-volume operator approaching Mapbox’s rate limits, contact us — we can negotiate volume tiers on the platform Mapbox account.

Related GroundCut features

  • Instant satellite quoting (mapbox-gl-draw is the drawing tool).
  • Service-area zones (zone boundaries render on a Mapbox map for tenant configuration).
  • Route optimization (Mapbox Directions API drives the distance matrix).
  • Operator queue (each job card has Open in maps which uses native maps URLs but tenant data comes from Mapbox geocodes).

Mapbox integration FAQs

Do I need my own Mapbox account?+
No. GroundCut maintains the Mapbox account at the platform level. All Mapbox API calls — geocoding, satellite tiles, Directions — run on our infrastructure. You don’t pay Mapbox directly; that cost is included in your $99/mo subscription. If you’re a heavy user approaching platform-level rate limits we’ll work with you on it.
Why satellite imagery for the lawn trace and not parcel data?+
Parcel data tells you the total lot size, including the house, driveway, garden beds, fenced patio, and shed — none of which you mow. The mowable area is what you need to price. Satellite imagery makes the customer pause, look at their actual yard, and outline what you’d cut. The drawn area runs through @turf/turf to compute square footage, which feeds the price-per-quarter-acre rule. Empirically, customer-traced quotes are far closer to walkthrough quotes than parcel-derived ones.
How accurate is the area calculation?+
Within a few percent for residential lots up to about an acre. The customer’s tap precision is the dominant error term — mapbox-gl-draw lets them undo, redo, and redraw, which solves most of it. The pricing rules cap downside via min_price (you never quote below your floor) and max_price (you never quote above a sanity ceiling no matter how big the drawing is).
What if the satellite imagery is out of date?+
Mapbox refreshes its imagery on a regional schedule. Recently developed neighborhoods sometimes show a vacant lot when a house exists. The drawing tool works regardless — the customer outlines what they want mowed today, even if the imagery shows yesterday’s ground cover. New construction is the only place this is a regular issue.
Does route optimization actually solve the traveling-salesman problem?+
No, deliberately. We use nearest-neighbor over a Mapbox Directions distance matrix starting from your home base. For a residential mowing day with 6–12 stops, nearest-neighbor produces routes within a few percent of the optimum and runs in under a second. Genuine TSP solvers would add latency without meaningful daily-time savings at the route sizes lawn crews actually run.

Try GroundCut + Mapbox free for 14 days

Pro features unlocked during the trial. Connect on day one and see it work with your real data.

14-day free trial · No card required · Cancel any time