After a long proces of rewriting and testing ZwiftMap (thanks to all who helped!) it is now again possible to see where other riders are in ZwiftMap.
What is new?
ZwiftMap 2.0.0 is delivers much of the same functionality as ZwiftMap did in the past, but many things have changed on the inside.
The Configuration window now has three screens:
- [glossary_exclude]WindowsWindows The Windows operating system from Microsoft.[/glossary_exclude] – Here you control which [glossary_exclude]windows[/glossary_exclude] to show. Except for the first run of ZwiftMap the Configuration window will alway open on this screen. It is because it has the ffunctions you are most likely to access again and again.
- Profile – You can save your username and password and configure different things which are related to your user profile in Zwift and ZwiftGPS.
- Settings – Here you control the settings such as colours, background opacity, and different window properties. You can also access configuration files and log files from this screen.
There are several things which are new compared to the old version of ZwiftMap:
- A map powered by ZwiftGPS
- Use all the features of ZwiftGPS but as an click-through overlay
- Show/hide the different controls in ZwiftGPS with a keyboard shortcut (Windows+Alt+S in Windows and Command+Alt+S in macOSmacOS The operating system on the Mac computers from Apple)
- Position and resize the map window as you like (toggle the positioning/resize mode with the keyboard shortcut Windows+Alt+Z in Windows and Command+Alt+Z in macOS )
- Adjust background transparency
- Enable auto login to ZwiftGPS (the rider ID in the profile – which can be retrieved automatically from my.zwift.com – is used).
- Several changes to the configuration window
- Different screens
- More online help and guidance
- Save Zwift username and password to enable automatic login to my.zwift.com
- Get profile (rider ID) automatically from my.zwift.com so the rider ID can be used for auto-login to ZwiftGPS.
- Enable auto login to my.zwift.com (to get your rider profile) and auto close to automatically close the window. my.zwift.com will then briefly open on program launch and close again when the profile has been read. For this to work you must let my.zwift.com remember your username and password or store your username and password in ZwiftMap.
- Choose whether to minimise the Configuration window on start (default) or not.
- Control the Configuration window (focus or hide/minimise) with the hotkey
(Windows+Alt+X in Windows and Command+Alt+X in macOS)
- You can choose to activate advanced network features. Then it gives you
- A detailed chat log with name display
- All metrics in the Ride/run data window, incl. w/kg
- Ride/run data updated with same frequency as the in-game display
- Chat log improvements
- Show Ride Ons
- Show personal messages in a different style
Where can I get it?
After having thought about it over the summer period of 2018 and made a few proof of concepts I decided that ZwiftMap should live on. It seems like there is an audience for this type of game overlay application, in particular the map and chat log parts of it.
I don’t think Zwift will open up for more third party apps in the near future.
Based on that I had two sources of data for ZwiftMap:
- the log file (this is the fallback solution – it enables a basic map)
- the UDP and TCP packages between the game and the server
But even then, because the mobile API became off-limits after GPDR went into effect in May 2018, there is no way to retrieve information about other users and show them on the map – except from ZwiftGPS.
By embedding (with full functionality) ZwiftGPS as a map window in ZwiftMap, ZwiftGPS users get the full ZwiftGPS experience whether in a regular browser or directly in a ZwiftMap ‘browser’ as a screen overlay, whatever they prefer. ZwiftGPS opt-in is still required and data is only shown for those who opted in.