> 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/maps-and-device-placement.md).

# Maps and Device Placement

When you have sensors spread around your home — in the kitchen, the garden, the garage — it helps to see where each one actually is. Chirp shows your sensor locations on an interactive map, so you always know which device is where without checking labels or room assignments.

## Where to find the map

The map appears on each sensor's detail page:

1. Tap **Devices** in the sidebar.
2. Tap a sensor to open its detail page.
3. The **Overview** tab is selected by default. The map appears in a card below the sensor's status information.

If the sensor has a location assigned, you'll see a marker on the map showing its position. A **location bar** above the map shows the sensor's room and sub-location (for example, "Living Room, Window side").

## When no location is set

If you haven't assigned a location to the sensor yet, the map area shows a placeholder:

* The text reads **"Your device location is empty"** and **"data will be available here soon"**.
* An **"Add device location"** button appears below. Tapping it takes you to the sensor's **Settings** tab, where you can pick a room from the rooms you've set up.

The button only appears if you have permission to edit the sensor.

## What the map can do

The map view gives you:

* **Pan and zoom** — Explore the area around your sensor's location.
* **Fullscreen** — Expand the map for a better look on any screen.
* **Responsive sizing** — On your phone, the map adjusts to fit comfortably.
* **Light and dark mode** — The map matches your Chirp theme.

## Setting a sensor's location

To put a sensor on the map:

1. Tap **"Add device location"** on the map placeholder, or go directly to the sensor's **Settings** tab.
2. Choose a room from the rooms you've created (rooms are set up in [Rooms](/devices/rooms.md)).
3. Save. The map on the Overview tab now shows your sensor's position.

## GPS trackers

If you have a GPS tracker device (for a vehicle, pet, or bike), the same map area can show where the tracker has been — not just where it is now. This location history feature is covered in [Tracking What Matters](/dashboards/tracking-what-matters.md), since it involves additional controls like date selection and route details that are specific to tracker devices.

## What's next

* [Rooms](/devices/rooms.md) — Set up the room structure that feeds into device locations.
* [Tracking What Matters](/dashboards/tracking-what-matters.md) — Location history for GPS tracker devices.
* [Sensor Details](/devices/sensor-details.md) — View and edit everything about a sensor.


---

# 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/maps-and-device-placement.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.