Sensor Maps

Upload a picture of your rig for a hub and mark where each sensor sits, plus what does not work on this page yet.

In the app: /hubs/:hubId/sensor-maps

A sensor map is a picture you upload for one hub - a floorplan, a photo, or a sketch of your rig - with pins on it that mark where your sensors are. Maps belong to a hub, so each hub has its own set.

Maps and pins are notes for your own reference. They do not change readings, thresholds, or alerts.

Read this first#

At this release the picture you upload does not display in the web app. The page asks your browser for the picture without your sign-in attached, so the request is refused. Where the picture should be, you get a dark panel showing the words Sensor map or a broken-image icon, depending on your browser.

Two things follow from that:

Existing pins are not drawn on the picture, so you cannot see where a pin sits.
A new pin is saved at the top left corner of the map no matter where you click, because the page cannot work out where the picture is on screen.

So the pin positions you set here are not usable yet. The labels and sensor links you type are saved correctly, and the rest of the page (uploading, listing, editing pin labels, deleting) works. If you want a working layout view of your rig, see "Camper Map is a different thing" at the bottom of this page.

Open the page#

Go to Hubs and select the hub you want.
On the hub page, select Sensor Maps at the top right, next to Add Sensor.
The page header reads Sensor Maps - followed by your hub name. The back arrow at the top left returns you to the hub.

Hubs shared with you#

Sensor maps only work on hubs you own. If a hub was shared with you by someone else, the Sensor Maps button still appears on its hub page and the page still opens, but nothing on it works:

a red bar at the top reads Request failed with status code 403
the map list is empty and says No maps yet. Upload one!, even when the owner has maps on that hub
trying to upload fails with Access denied in the upload box

There is nothing to fix at your end. Ask the person who owns the hub to make the map on their own account.

Upload a map#

Select Upload Map at the top right.
In the Upload Sensor Map box, type a name in Map Name. The hint text suggests e.g. Main Living Area.
Select the button that reads Select Image (JPG, PNG, GIF, WebP, max 10 MB) and pick a file. Once picked, that button shows your file name instead.
Select Upload. The Upload button stays greyed out until you have both a name and a file.

On a phone this box fills the screen rather than sitting over the page, but the fields and buttons are the same.

Worked example. You photograph the floorplan sticker inside your cabinet door, save it as living-area.png at 1.4 MB, type Main Living Area in Map Name, pick the file, and select Upload. The box closes and Main Living Area appears in the list of maps and is opened for you.

What to do if the upload is rejected: the box stays open and shows the reason at the top.

Image exceeds 10 MB limit - the file is too big. Save it smaller and try again.
Unsupported image type. Allowed: jpeg, png, gif, webp - the file is not one of the four accepted formats. Save the picture as a JPG or PNG and try again.

The file chooser is set to offer JPG, PNG, GIF and WebP files only, so on most devices you will not be able to pick anything else in the first place. The check is on the contents of the file rather than its name, so renaming something to .png will not get it past.

The map list#

The panel of maps is headed MAPS with the number of maps in brackets, for example MAPS (2). Each entry shows the map name and, underneath, a count such as 3 annotations. Select an entry to open it.

The panel sits to the left of the map area on a computer and above it on a phone.

The count is not adjusted for a single pin, so a map with one pin reads 1 annotations.

With no maps yet, the panel reads No maps yet. Upload one! and the large area for the map reads Upload a floorplan to get started. If you have maps but have not opened one, that area reads Select a map from the list.

Add a pin#

Select a map from the list. Above the picture you will see the map name and a chip with the same N annotations count.
Select the Place Pin chip in that toolbar. It fills in to show it is on, a Cancel chip appears next to it, and a message appears below reading Click anywhere on the image to place a sensor pin.
Click in the picture area. The New Pin box opens.
Type a Label. The hint text suggests e.g. Temperature sensor. You can leave it empty and still save; the pin then shows as Unlabeled.
Optionally open Link to Sensor (optional) and choose one of this hub's sensors. Each choice reads as the sensor name followed by its device type in brackets, for example Fridge Temp (GVH5075). Leave it on None if the pin is just a note.
Select Save.

Remember the limitation above: the pin is recorded, but not at the spot you clicked.

To leave pin mode without adding anything, select Cancel in the toolbar or select Place Pin again to switch it off. Selecting Cancel inside the New Pin box only closes that box: pin mode stays on, so your next click on the picture starts another pin.

Review, edit, and remove pins#

Once the open map has at least one pin, a section headed ANNOTATIONS appears under the picture and lists them. Each row shows:

a small blue dot, the same colour the pins would be drawn in
the label you typed, or the word Unlabeled in grey if you left it empty
a chip with the name of the linked sensor, if you linked one. If the app cannot match that sensor to this hub any more, the chip just reads Sensor.
a pencil button, which opens Edit Annotation so you can change the Label and the Link to Sensor (optional) choice, then Save
a red bin button, which removes the pin

Two things to know about Edit Annotation:

Changing the label works, including clearing it, which turns the row back into Unlabeled.
Changing the link from one sensor to another works, but setting it back to None does not. The pin keeps the sensor it already had, and the chip stays on the row. If you need a pin with no sensor on it, delete the pin and add a new one.

Deleting a pin happens immediately. There is no confirmation step and no undo.

What happens to a pin when you delete the sensor it points at depends on the choice you make in the delete box on the sensor's own page. With Remove data immediately the pin is deleted along with the sensor. With any of the Keep data choices the pin stays where it is and its chip falls back to reading Sensor.

Delete a map#

Select the red bin button on the right of a map's row in the list of maps. The map, its picture, and all of its pins are deleted straight away. There is no confirmation step and no undo, so make sure you have the right row.

What this page cannot do#

You cannot rename a map after uploading it. Upload it again under the name you want and delete the old one.
You cannot drag a pin to move it. Delete it and add it again.
You cannot remove a sensor link from an existing pin, as described above.
You cannot copy a map or its pins to another hub.

If something does not save#

Uploads tell you when they fail: the Upload Sensor Map box stays open with the reason on it. Nothing else on this page does.

If saving a pin fails, the Save button just stops spinning and the box stays open, with no message. If deleting a pin or a map fails, the row stays where it is with no message. The bar at the top of the page only reports a problem with loading the map list in the first place.

If you are not sure whether a change took effect, reload the page. What you see after a reload is what is actually stored.

Camper Map is a different thing#

If your hub sends up a layout with at least one pin on it, your Dashboard shows a separate section headed Camper Map, with the name of the rig template on the right. That one draws an RV silhouette with each pin's latest reading and its status, and it comes from your hub. You cannot edit it, or its pins, from the web app, and it has no connection to the maps you upload here.

If your hub has the camper map switched off in its own display settings, the section does not appear on the Dashboard either.