: The direct URL template to the tile server. The variables z , x , and y represent the Zoom level, X-coordinate, and Y-coordinate of the tiles. prevents the XML parser from breaking over special characters like & .
The key takeaways are:
OruxMaps is arguably one of the most powerful GPS tracking and mapping applications available for Android. While it comes with a handful of default maps, its true power lies in its ability to display thousands of different online map sources—from specialized hiking maps to high-resolution satellite imagery.
to allow OruxMaps to save viewed tiles to your local storage for faster browsing later. downloadable
Run your code through an online XML validator tool to find the syntax error. 2. Red "X" Tiles or Loading Blocks Oruxmaps Online Map Sources.xml
: The URL structure. It must include x , y , and z placeholders so OruxMaps knows which tiles to request. maxzoom / minzoom : Limits the zoom levels.
Navigate to oruxmaps/mapfiles/customonlinemaps/ on your device.
Save the text file. Open OruxMaps, navigate to the Map menu, and select . Tap the Online tab, then tap the Refresh button (circular arrows icon) at the top of the screen to force the app to reload the updated XML file. Advanced Configurations Handling Multi-Server Load Balancing
One of the greatest strengths of OruxMaps is the active community that shares map configurations. If you don't want to create your own from scratch, you can often download ready-made files. : The direct URL template to the tile server
: The server URL structure may have changed, or your API key is invalid. Check the URL in a desktop browser by replacing z/x/y with 1/1/1.png .
Put your onlinemapsources.xml in this folder. Do not put it in the base mapfiles folder, as an app update might erase it. 2. Steps to Activate Custom Maps Download/Create the onlinemapsources.xml file.
: This indicates a syntax error in your XML file. Ensure every opening tag (e.g., ) has a matching closing tag ( ). Check for duplicate ID numbers.
Paste your new map blocks directly between existing entries. Ensure you do not accidentally paste code inside another map's tags. Step 4: Save and Refresh OruxMaps The key takeaways are: OruxMaps is arguably one
Found at /oruxmaps/mapfiles/onlinemapsources.xml , this file is often overwritten during app updates.
Overwrite your existing file in the oruxmaps/mapfiles/ directory.
Paste it directly into the oruxmaps/mapfiles/ folder, overwriting the existing file.
The template URL for the map tiles, often using placeholders like The zoom levels the map supports (usually 0 to 18 or 20). MERCATORELIPSOIDAL MERCATORSPHERICAL 3. How to Install a New XML File Download/Edit: Obtain a pre-configured onlinemapsources.xml from a trusted source like or a community forum. Move the File: Use a file manager to place it in the oruxmaps/mapfiles/customonlinemaps/ Refresh in App: Open OruxMaps, go to Switch Map , and tap the (circular arrow) button. 4. Pro Tips for Better Maps Configuring online maps - OruxMaps
If a map is unnecessary, you can click and hold the map name in the selection list, and it will disappear (you may need to delete it from the XML for a permanent removal).
To modify or replace this file, you must navigate to the internal storage of your Android device. The default directory is usually: Android/data/com.orux.oruxmaps/files/oruxmaps/mapfiles/onlinemapsources.xml