Oruxmaps Online Map Sources.xml -
The original onlinemapsources.xml file is typically located in the oruxmaps/mapfiles/ folder on your internal storage. However, it is important to note that during an app update, OruxMaps may modify or replace the official file, which means any custom maps added directly to it could be erased.
Restart the app or go to Map List and tap the Refresh button.
After copying the file, restart the OruxMaps app to allow it to recognize the new configurations. Once the app has restarted, open the map list and press the Refresh button to reload the available map sources. Your newly added maps should now appear in the online maps section.
Some examples of online map sources that can be accessed through the Online Map Sources.xml file include: Oruxmaps Online Map Sources.xml
<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" />
Manually updating onlinemapsources.xml on multiple devices is a hassle. Use a cloud sync solution.
Every map layer inside the file is wrapped in a tag. Understanding this structure allows you to build your own custom map links. The original onlinemapsources
This method gives you full flexibility and is the best way to understand how the system works.
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
: Your new maps will now appear under the Layers section in the Online folder. 3. XML Structure Breakdown After copying the file, restart the OruxMaps app
: To protect your customizations, the developers created a special folder just for user-added maps. This folder is: /sdcard/oruxmaps/mapfiles/customonlinemaps/ . When OruxMaps starts, it loads the maps from the customonlinemaps folder in addition to the official file. The crucial advantage is that the app never modifies or deletes files in this folder. This is the place where you should add your custom maps, ensuring they remain intact even after an app update.
: A unique numerical value. Duplicate IDs will cause loading errors.
The uid (User ID) element must be unique for every map source across all your XML files. Think of it as a primary key for a map source. If you're adding multiple custom maps to the customonlinemaps folder, ensure each has a unique uid . It's also crucial that these uid s do not conflict with any uid s used in the official onlinemapsources.xml file. For your custom maps, it's a good practice to use a separate range of numbers, for instance, starting at 1,000,000 or above, to avoid any chance of duplication.
: The direct web link to the tile server. It uses placeholders like z (zoom level), x (horizontal tile coordinate), and y (vertical tile coordinate).
For servers requiring custom HTTP headers (e.g., Referer ), Oruxmaps does not support header injection via XML alone. You would need to use a proxy or switch to a different map source.
