MapMeasure

MapMeasure is the shared measurement workspace inside the satellite view of the Property Visual Panel. It lets you trace polygons and lines on the live Google map, store those measurements with the estimate or proposal, and apply supported values back into pricing inputs.

MapMeasure is available in:

• Residential estimates
• Commercial building proposals
• Fleet proposals
• Holiday lights estimates

The same saved measurements reopen with the record, including map center, zoom, tilt, and heading.

Open MapMeasure

Open the record you are working on, then open the Property Visual Panel and switch to the Satellite tab. When MapMeasure is enabled for that workflow, you will see the measurement toolbar on top of the map.

Use MapMeasure when you need values such as:

• Building footprint square footage
• Lot size
• Roof area
• Gutter length
• Fence length
• Driveway area
• Parking or curb reference measurements

Drawing Tools

MapMeasure supports two draw modes:

• Polygon for areas like roofs, footprints, driveways, parking, and lots
• Line for gutters, fences, frontage, curbs, and other linear measurements

While you draw, MapMeasure shows live geodesic totals on the map:

• Polygons show area and perimeter
• Lines show length

All saved totals are recalculated on the server from latitude and longitude points before they are stored.

Keyboard Shortcuts

During draw mode, these shortcuts are available:

• Escape cancels the active draft and exits draw mode
• Ctrl+Z or Cmd+Z removes the last draft vertex

Polygon drafts can be completed by clicking the first vertex again or by double-clicking after at least three points. Line drafts complete on double-click after at least two points.

Undo is draft-aware all the way down to the last point. If you remove the final vertex, MapMeasure keeps the active draft category and styling in place so you can keep drawing without reselecting the tool.

Editing Saved Measurements

After a measurement is saved, you can:

• Select it from the map or the measurement list
• Rename it
• Recolor it
• Duplicate it
• Delete it
• Reopen it later with the same geometry and map view

Saved measurements are attached to the active record, and when the workflow has a reusable property address on file they can also be loaded from that property-level address context.

MapMeasure saves are scoped to the current organization and target record before the server accepts them, which helps prevent cross-record or cross-org mixups during shared office workflows.

Map preview lookups now load through the app's internal map routes with request throttling and permission checks. That means failed address or Street View lookups show clearer inline errors instead of leaving the visual panel stuck in a loading state, and upstream non-image responses are rejected before they can be shown in the admin UI.

Measurement save/load failures now surface plain-language admin messages instead of raw database text, while detailed diagnostics stay in server logs for support.

Smart Apply

MapMeasure can do more than store reference shapes. In supported workflows it can push measured values back into the actual pricing inputs.

Residential Estimates

Residential smart apply updates both the property summary fields and the pricing-driving service selections used by the estimate engine.

When you apply a supported residential measurement, Clean Estimate Pro also saves the estimate's property_data_source as mapmeasure and records the measurement-source metadata used for that estimate revision. That makes later edits and reopen flows preserve the fact that the value came from saved map geometry instead of a manual guess.

Current mappings:

• footprint or custom_area -> house-wash.sqft and top-level property_sqft
• roof -> roof-cleaning.roof_sqft and top-level roof_sqft
• gutter -> gutters.gutter_linear_ft and top-level gutter_linear_ft
• driveway -> driveway.driveway_sqft
• fence -> fence.fence_linear_ft

The apply dialog shows the current value and the proposed measured value before you confirm the overwrite.

Commercial Building Proposals

Commercial building proposals can apply supported measurements to the active property inside the portfolio builder. Proposal property saves now replace the full property graph through one atomic database transaction, so a failed save cannot partially delete and reinsert child rows.

Fleet and Holiday Lights

Fleet and holiday lights can capture and save measurements in the shared satellite workspace, but their use is intentionally lighter in v1:

• Fleet keeps measurements available for reference and workflow support
• Holiday lights keeps the existing design canvas as the pricing source, with MapMeasure available as a saved map reference

Edit and Reopen Behavior

Residential estimate reconstruction was hardened so saved values round-trip more cleanly when you reopen an estimate for editing. When legacy estimates contain service-specific inputs, Clean Estimate Pro now preserves those values before falling back to generic defaults.

That includes fields such as:

• roof_sqft
• roof_type
• roof_half
• gutter_linear_ft
• driveway_sqft
• fence_linear_ft
• stories
• sqft

This is especially important when a MapMeasure-applied estimate is saved, reopened, and edited again later.

Deployment Note

MapMeasure and the shared Property Visual Panel prefer the server-side GOOGLE_MAPS_SERVER_API_KEY environment variable for geocoding, Static Maps, and Street View proxy requests. If that dedicated server key is missing, CE Pro falls back to NEXT_PUBLIC_GOOGLE_MAPS_API_KEY for those internal map requests. If that public Maps key is browser-only, referrer-restricted, or missing Geocoding / Street View access, saved map previews and measurement workflows keep the unavailable message instead of acting like the address itself could not be found.

Best Practices

• Use category-specific shapes whenever possible so the apply suggestions stay relevant.
• Keep separate shapes for separate pricing surfaces instead of tracing one large custom polygon.
• Apply measurements only after confirming the category matches the pricing field you want to update.
• For holiday lights, keep using the holiday lights design canvas for production pricing and installation planning.