- Usage of wahooMapsCreator
- The tool stops but does not output an error
- I have a Java error. "Java heap space - out of memory"
- I have a Osmosis error. "Task type mw doesn't exist"
- How can I migrate from v3.x.x to v4.x.x?
- Is there a way to use wahooMapsCreator without installing Anaconda and the other software directly on OS level?
- Generated maps
- Where on my Wahoo device do I have to copy the maps?
- How can I restore original maps?
- Can I preview my generated maps before putting them onto the Wahoo device?
- Does device/offline routing functionality use the new roads?
- Are there already generated maps available for download?
- Are there already generated routing tiles available for download?
- Device theme
- Connection from Wahoo device to computer
Run the tool and output debug logging messages.
Add the -v argument if running via CLI or set the checkbox on Advanced settings via GUI.
If you are on Windows and running out of memory, it can be that you just don't have enough memory OR that the memory limit of java 32 is the cause.
You identify a Java error when the console outputs java.lang.OutOfMemoryError.
There are some possible workarounds:
- You can try to deinstall Java 32 and install the 64 bit version
- Launch this command before running wahooMapsCreator helped here: #198
set JAVACMD_OPTIONS=-server -Xmx3G
- A permanent workaround (in opposite to 2.) is making changes from this PR https://github.com/treee111/wahooMapsCreator/pull/171/files in the osmosis.bat file on your computer. This file located here:
wahooMapsCreatorData\_download\tooling_win\Osmosis\bin\osmosis.bat.
You might have osmosis installed in version 0.49.0 or 0.49.1 and might be using macOS or Linux. If yes, this error occurs during creation of the .map files:
org.openstreetmap.osmosis.core.OsmosisRuntimeException: Task type mw doesn't exist.
In these two versions 0.49.0 and 0.49.1, the feature we use for loading the mapwriter plugin was removed and just brought back in version 0.49.2.
You can list your version of osmosis on macOS/Linux with:
brew list osmosis
You can upgrade osmosis on macOS/Linux with:
brew upgrade osmosis
You have to remove your existing environment:
conda env remove -n gdal-user
followed by creating a new environment and install wahoomc into:
conda create -n gdal-user python=3.10 geojson=2.5 gdal=3.6 requests=2.28 shapely=1.8 bs4=4.11 lxml=4.9 matplotlib=3.4.3 pip --channel conda-forge --override-channels
conda activate gdal-user
pip install wahoomc
Is there a way to use wahooMapsCreator without installing Anaconda and the other software directly on OS level?
The process of setting up the environment for creating your individual maps with wahooMapsCreator is way easier as it was before. Before, many manual steps have been involved, taking care of certain versions of tools to be OK with each other and configs around the OS.
You can give the docker version of wahooMapsCreator a try: https://github.com/vti/wahooMapsCreator-docker, it is kind of a A standalone package without having to install stuff on OS level.
There is a directory named like the country or X/Y coordinates you processed in the wahooMapsCreatorData directory (see docs).
The content of this folder is relevant.
As an example, lets assume, we want to copy the maps of american_samoa
We need to copy the folders under the american_samoa directory into the maps/tiles/8 directory on the Wahoo device (see docs).
It should look like that after copying the files
If the folder, i.e. maps/tiles/8/6 does already exist on your Wahoo device, copy the .map.lzma and .map.lzma.17 files into the existing folder.
Delete all content from maps/tiles/8 on your Wahoo device. After that, you can download original Wahoo maps from the ELEMNT mobile phone app again.
Read usage of cruiser
The device routing (synonym: offline routing) functionality is provided through routing tiles and available on newer models e.g. BOLTv2/ROAMv2. The routing tiles are stored in the directory maps/routing and contain all know roads which can be used to route over. This is something different then routes synced from Komoot, Stava, ... or planned via the ELEMNT Companion mobile app. In this case you follow a track, but on device routing will be used when you wonder off that track.
Without updating the routing tiles in addition to updating the generated map files, device routing of your device will not route you over the newly added roads in the maps. The reason is: The old routing tiles simply do not know about there existence.
Generating Routing tiles are not covered in this repo.
On this OneDrive, you'll find already generated maps for download: http://wahoomaps.higli.de/ .
The content of these maps are slightly different from what you create with the default settings of wahooMapsCreator. Other than that this might be a good starting point to tryout and get them on your device and see what can be achieved.
By customizing the wahooMapsCreator settings and configuration you can than create your individual maps with wahooMapsCreator.
Base map tiles could also be downloaded from Wahoo update server (url: https://cdn.wahooligan.com/wahoo-maps/{version}/tiles/{zoom}/{x}/{y}.map.lzma; latest map version = 12, zoom level =8, x, y = map tile index/coordinates) but these are relatively old.
Current routing tiles can be downloaded from http://wahoomaps.higli.de/. Download the -routing.zip file for the countries of your choice and copy the content under the maps/routing directory on your wahoo device.
Routing tiles could also be downloaded from Wahoo update server, see documentation but these are relatively old.
Examplary the germany routing tiles would be stored in maps/routing/2/000/.... More details can be accessed here
If you render using VTM, delete this folder on your Wahoo device: maps/vtm-elemnt/vtm-elemnt.xml.
If you do not render using VTM, delete this file maps/mapsforge-roam/mapsforge-roam.xml or maps/mapsforge-bolt/mapsforge-bolt.xml. Depending on which exists.
In addition, delete the empty file cfg_BHomeActivity_VtmMaps in the root directory of the Wahoo device if it exists.
If ADB does not seam to work with your PC and Wahoo:
- try to do the Authorization multiple times
- try another USB cable. Some cables do not support adb / file transfer