Location Map

Would love this, i need to check if this is possible here on the ESP32, especially how we draw the map.... it's on my list!

I'm attempting to build it with Claude Code as a proof of concept, it certainly looks doable just may not have time to test it for a couple of days.

Thanks @stevenhorner! This is better suited to a discussion than an issue, so I moved it here: https://github.com/MaxGramser/homeassistant_espscreen/discussions/105

Please continue the conversation there. I'm closing this issue to keep the tracker for bugs and concrete board requests.

Got a screen running? Tell others which board you have and what works on the Tessera website. It helps everyone pick a screen that works.

Like my work? Consider buying me a coffee, much appreciated!

I managed to get this working on my Guition 4" but it is all written with AI.

Here's how it looks in Home Assistant:

This is it on the screen:

For the pictures I've set it to Town for the zoom level so as not to show my exact house, but you can change the zoom.

This uses a person entity and adds a Map Display option. You can add additional entities to the map. There are a few things I still want to be able to adjust and I started this a few ago so it's a few versions behind at the moment.

github.comhttps://github.com/stevenhorner/homeassistant_espscreen/tree/feature/map-card

But it looks super cool and I wanna try to include it in the full project

Thanks again @stevenhorner, the map card is now in ESP Screens 0.4.34 with firmware 0.20.0 (0.4.33 brought it, but that app did not start; 0.4.34 fixes that, so update straight to 0.4.34).

Your branch showed how it could work, and I rebuilt it on the current code. I really liked how you sent the map to the screen as a picture, exactly the way a live camera arrives: the screen needs no map code at all, and no location ever reaches it. That part is the same now. Also from your version: the framings (everyone on the card or a fixed view), other people riding along, and the movement mark, so a map is only drawn again when someone moves. You are credited as co-author on the commit and in the release notes.

What is different:

• The streets come from Home Assistant's own map as vector tiles, so the add-on draws them in the screen's own colours: quiet greys and white streets, with strong colour only for the people. A screen in Dark mode gets a dark map.
• It works on every tile size, from one cell to the whole page.
• Show frames everyone, the area around home, or the area around that person, with a distance for the last two. Someone outside the view is a small marker on the edge pointing the way.

One thing from your original request is not there yet: the tile's entity is a person, and the people riding along are people too. A device tracker shows on the map by assigning it to a person in Home Assistant (Settings, People). Device trackers on their own may come later.

You have the 4-inch Guition: could you try it on your own screen and let me know how it looks and whether the map follows you around? Details are in docs/MAP.md.

Got a screen running? Tell others which board you have and what works on the Tessera website. It helps everyone pick a screen that works.

Like my work? Consider buying me a coffee, much appreciated!

This is so cool, really nice implementation!

On my 10" screen loading the full map is a bit slow. Is there anything that can be done to improve this? Is the image already compressed to display resolution size before sending it over to the board?

Thanks for expanding on my testing work. I've noticed that after around 15-20 minutes the map stops displaying and shows shows Away or Home for a person. If I change the page and go back again it refreshes and shows the map again. I need to do some testing to see if this is because the location hasn't changed or just because it times out.

Also in the settings screen in Home assistant it doesn't show the map on the tile, unless you press Preview. This did work on my test code On the screenshot above this is from the settings page, on the actual screen or when pressing preview there is a map. This is also the view that the screen falls back to after 15-20 minutes.

I'm also seeing timeouts since today on map and camera streams on my Guition V3 10".

When the new map functionality was released it worked well. So I assume this issue came with one of the changes to media in the last few builds.

wierd.... working on this

Could also be the release that introduced the swipe up and down that caused it.

Thanks both, this helped a lot. ESP Screens 0.4.51 with firmware 0.30.0 fixes the map falling back to Home or Away.

What went wrong. A page with only maps on it (no camera) asked ESP Screens once for its picture. If that one answer came back without a picture, the screen never asked again and showed the plain person tiles until you turned the page. That is exactly what you saw, Steven: going to another page and back made it ask again. I could make it happen on a test screen every time.

What 0.4.51 changes:

• The screen asks again after 10 seconds, and then a little later each time (up to 5 minutes), until the map comes back. No page turn needed.
• A map keeps the picture it shows until the next one has loaded, so there is no empty moment when someone moves.
• ESP Screens remembers the address screens fetch pictures from. It asks Home Assistant for it every ten minutes, and if Home Assistant did not answer that once, pictures went out without a link. This part works on any firmware.

Update the app to 0.4.51 first, then the screen to firmware 0.30.0.

The editor. You are right, Steven: the layout view in the editor does not draw a map yet, only Preview does. That is a missing piece, not something your version broke. It is on the list.

The slow first load on the 10-inch, Heronimonimo: the map is drawn at exactly the size of its card and sent in 8-bit colour, and a full page on the 10-inch is capped at 1024 by 640 pixels. The first map of an area is the slowest, because Home Assistant fetches the streets from OpenStreetMap then. After that they are kept for a week, and the next map only redraws the markers.

If it still happens after the update, please send:

• Steven: the ESP Screen Manager log (Settings, Apps, ESP Screen Manager, Log) from around the moment the map disappears. The lines that matter contain "Live pictures", "no address for this app on the LAN" or "cannot be read".
• Heronimonimo: where you see the timeouts (the screen's own ESPHome log, or the app's log) and a few of those lines. Does it happen on a page with only cameras too, or only where a map is on the page? I could not reproduce the camera timeouts here, and I have not found a link to the swipe release yet, so your log is the best lead.

Got a screen running? Tell others which board you have and what works on the Tessera website. It helps everyone pick a screen that works.

Like my work? Consider buying me a coffee, much appreciated!