Do not use basic word processors like Microsoft Word, as they inject hidden formatting characters. Use a dedicated code or text editor such as (Windows), VS Code (Cross-platform), or QuickEdit (Android). Step 2: Open and Locate the Insertion Point
Android/data/com.orux.oruxmapsDonate/files/oruxmaps/mapfiles/onlinemapsources.xml Legacy/Storage Path: oruxmaps/mapfiles/onlinemapsources.xml
Do not edit the default onlinemapsources.xml directly if you can avoid it. When OruxMaps updates, it may overwrite this file, deleting your custom work. The Recommended Location: customonlinemaps
: Set to 1 so tiles save temporarily to your phone as you browse.
The that allows OruxMaps to stream, render, and download custom map tiles from servers worldwide. By modifying this XML configuration, outdoor enthusiasts can expand the app's default catalog to include topographic imagery, satellite layers, and specialized regional maps. This comprehensive guide covers everything from file structure and implementation mechanics to code syntax and troubleshooting workflows. Understanding the Architecture Oruxmaps Online Map Sources.xml
The onlinemapsources.xml file is a text file that tells OruxMaps where to download map tiles (small image files) from the internet. It acts as a bridge between specialized map providers and your Android device.
While this method is convenient, adding a map this way does not write it to the onlinemapsources.xml file. Instead, OruxMaps saves these custom maps in an internal database. If you want to share the map with others or keep a permanent backup of your configuration, the manual XML method described below is more suitable.
Double-check the URL format. Ensure the tile coordinates ( z , x , y ) match the layout required by the server. Some older configurations use a different order, such as z/s/x/y . Additionally, verify if the map provider recently changed their access API rules or requires an API access key. Issue 3: Maps Refuse to Download for Offline Use
This flexibility cuts both ways. A malformed XML—a missing slash, a duplicate UID—will silently fail. No error message. Oruxmaps will just show a blank grid. Debugging means reading logcats or trial-and-error editing. Do not use basic word processors like Microsoft
: A unique numerical identifier. Duplicate IDs will cause the app to crash or ignore maps.
The Online Map Sources.xml file is a configuration file used by Oruxmaps to connect to online map sources. It contains a list of URLs, parameters, and other settings that allow Oruxmaps to communicate with various map servers, such as OpenStreetMap, Google Maps, and others. This file is usually located in the Oruxmaps installation directory or in the Android device's storage.
Copy the file to the internal storage folder: oruxmaps/mapfiles/customonlinemaps/ . Refresh in App: Open OruxMaps and tap the Map icon. Select Switch map > Online .
Adjust settings to download maps more efficiently for offline use. When OruxMaps updates, it may overwrite this file,
Some examples of online map sources that can be accessed through the Online Map Sources.xml file include:
Scroll to the bottom of the file, just above the closing tag. Paste your new block. Save the file and restart OruxMaps. Method 2: Importing Community XML Configurations
<wms uid="20001" name="DEMO WMS Service" url="URL of the WMS Service" version="1.3.0" layers="0" proj="&WGS84;" transparent="0" format="image/png" minzoom="0" maxzoom="18" />
. This prevents the app from overwriting your custom sources during official updates.