> For the complete documentation index, see [llms.txt](https://docs.chirpwireless.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chirpwireless.io/dashboards/adding-widgets/digital-building-twin/tracing-from-the-map.md).

# Tracing from the Map

No floor plan? No problem. You can build the shell of your home straight from a satellite map. Open the map, find your house, click around its outline, and the editor turns that shape into walls — and remembers where on Earth your home actually is.

This is the easiest way to start when you can see your home from above but don't have any drawings of it. It works just as well for the parts of your property beyond the house — the garden, the driveway, the garage, a shed. It's also how your home gets its **map location**: the trace saves your home's real coordinates, which is what the features in [GPS anchoring](/dashboards/adding-widgets/digital-building-twin/gps-anchoring.md) build on.

## Opening the map

1. On the bottom toolbar, click **Build**.
2. In the building-tools row, click **Trace from map**.
3. A full-screen map opens.

Move and zoom the map until your home is nicely in view — drag to move, scroll to zoom, or use the controls in the corner.

## Tracing your home

1. Click **Trace building** to start. The cursor turns into a crosshair and a hint appears: *Click on the map to add building corners*.
2. Click each **corner** of your home, one after another. Each click drops a point, and the points join up into the outline you're drawing.
3. Go all the way around the edge of the house. The toolbar keeps a running count of your points.
4. Put a point in the wrong spot? Click **Undo** to take the last one back. **Reset** clears everything and starts fresh. **Pause** lets you stop adding points for a moment without losing the ones you have.
5. When you've gone all the way around — three points or more — click **Import**.

The outline becomes walls, one for each side, placed on the floor you're currently on. The map closes and you're back in the editor with the shell of your home in place.

## What gets saved

Importing a traced home does two things:

* **Creates the walls** — one for each edge of the outline you drew, on the active floor.
* **Saves your home's location** — because you drew on a real map, the editor remembers your home's real-world coordinates. That location travels with the model, and it's what the map-based features build on later. See [GPS anchoring](/dashboards/adding-widgets/digital-building-twin/gps-anchoring.md).

## After tracing

The traced walls are just ordinary walls — click any of them to set height, thickness, and material, add doors and windows, draw the inside rooms, and furnish away. Tracing gives you a correctly-shaped, correctly-placed outline; everything inside it you build like normal.

## Tips

* Zoom in close on the map before you start — the bigger your house looks on screen, the more accurately you can click each corner.
* Go around the outline in order, all the way around once. Don't hop from one side of the house to the other.
* For an L-shaped house, click a point at every corner — including the inside corners where the L bends.
* Use **Pause** if you need to move the map partway through, then carry on clicking.

## See also

* [GPS anchoring](/dashboards/adding-widgets/digital-building-twin/gps-anchoring.md) — What your home's saved location is for
* [Drawing your home](/dashboards/adding-widgets/digital-building-twin/drawing-your-building.md) — Add the inside rooms after tracing
* [Importing a floor plan](/dashboards/adding-widgets/digital-building-twin/importing-a-dxf-plan.md) — Build from a plan file instead


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.chirpwireless.io/dashboards/adding-widgets/digital-building-twin/tracing-from-the-map.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
