Kristian Risager Larsen
adf1d5f562
* Map compatibility information * Add compatibility information for CrowPanel Advance HMI --------- Co-authored-by: Manuel <71137295+mverch67@users.noreply.github.com>
Map Tile Starter-Kit
This folder contains a basic set of map tiles in different styles for Meshtastic UI enabled devices with SD card support. Each zip file includes zoom levels 1 - 6 of Earth's surface, so whereever you are you'll be able to zoom out and see in what country's location you've been beamed to.
Refer to Credits and Attribution for the origin of the provided map tiles.
For size reductions each single tile has been converted to 8-bit palette using the following imagemagick command:
find maps -name "*.png" -exec mogrify -colors 256 -depth 8 +dither -define png:color-type=3 -alpha Background {} \;
Installing
Prepare a SDCard and format it with the SD formatting tool provided by www.sdcard.org. Format the SD card as MBR (sometimes also called "msdos") partition table. Meshtastic UI supports both FAT32 and exFAT partitions, with exFAT being the recommended format.
Unzip the contents of the zip file(s) into the SD card's root folder retaining the subfolder structure /maps/<style>/z/x/y.
Insert the SD card into the MUI device. On MUI's home screen you can check if the card is detected properly: scroll down to the SD card icon, press the button and you'll find information about the total size, file system format, and used space of the SD card. If there is no SD card icon, the SD card is not available.
Note: whenever you remove or insert the SD card you should press the button afterwards to get a consistent state.
Pressing on the Map button in the main button bar will open the map panel and show the surrounding area of where you are positioned according your GPS, or near other nodes with position, or at your saved home position, or at a default location. In case you see only empty tiles which may be the case when you have not yet downloaded detailed map tiles for your location, zoom out to at least level 6 which will then load the tiles on your SD card.
Long pressing the Map button allows to choose between the map styles found on SD card and reveals sliders to control brightness and contrast of the tiles. Another tap on the Map button toggles the controls.
Downloading Tiles
The map tiles are in .png format of size 256x256 pixel and zoom levels 1 - 20, where 1 represents the entire earth and 20 a mid-sized building.
A graphical tool for convenient downloading of further map tiles can be found here: map-tile-downloader It provides an automated download of MUI compatible map tiles using map raster tile APIs from different configurable providers. With this downloader tool you can extent the existing map styles by further zoom levels or download your favorite map styles according your preference.
Please read the instructions carefully and don't abuse the freely provided services.
Note: when choosing a region for downloading tiles you're advised to adapt the zoom level from the outer part (e.g. level 6 - 8) to the center of the area of interest (e.g. level 15 or 16). This way you can save a lot of time, space and credits.
If you like to check of how many tiles an area is composed of you can make use of this Tile Calculator provided by Geofabrik.
Extra maps
A small group of map tile enthusiasts (special thanks to @joyel24 & @teddy1602) like to share their downloaded tiles. In this section you'll find torrents for downloading complete sets of map tiles of various zoom levels.
France
Entire France Atlas style zoom 6 to 13: Torrent Magnet Link ~1.29GB md5: 1e21c497e124647dda528d71011e133c
Entire France Outdoors style zoom 1 to 13: Torrent Magnet Link ~3.9GB md5: c02b89e9d5d2c7d5b3d902e6429dd5c4
Netherlands
Entire Netherlands Standard style zoom 1 to 14 including Amsterdam until zoom 17: Torrent Magnet Link ~956MB md5: 30ccf6484c99ae0b0765cff19acfc67e
Refer to Credits and Attribution for the origin of the provided map tiles.
md5sum calculation
dir=<root_torrent_dir> ; find "$dir" -type f -exec md5sum {} \; | sed "s~$dir~~g" | LC_ALL=C sort -d | md5sum
Compatibility
- 🟢 LILYGO T-Deck: Confirmed to work
- 🟢 CrowPanel Advance HMI: Confirmed to work on 2.4", 2.8", and 3.5" models
- 🔴 Seeed SenseCAP Indicator: The MicroSD card slot is physically not connected with the ESP32-S3 where the MUI is running. It can not be used for showing maps in Meshtastic UI.
Credits and Attribution
Attribution to Thunderforest, Geoapify, and OpenStreetMap for providing the tile API services:
atlas, outdoors styles © https://www.thunderforest.com/terms - Creative Commons licence CC-BY-SA 2.0
positron, dark-matter-brown styles © https://www.geoapify.com/terms-and-conditions/ - Open Data Common Open Database License, "ODbL" 1.0
osm, standard style © https://www.osm.org/copyright - Open Data Commons Open Database License, "ODbL" 1.0