Online Map Sources.xml - Oruxmaps
. It acts as a registry that the app reads to populate the "Online Maps" list with various providers like OpenStreetMap, Google, or custom WMS/WMTS servers. Core File Details Default Location: /oruxmaps/mapfiles/onlinemapsources.xml Custom Location:
: A unique numerical identifier. Every map in your file must have a different ID. If two maps share an ID, only one will load.
Instead, place your custom file in this folder: oruxmaps/mapfiles/customonlinemaps/ .
Mastering OruxMaps Online Map Sources.xml: A Complete Guide OruxMaps is perhaps the most powerful Android GPS application for hikers, cyclists, and off-road enthusiasts. While it excels at displaying offline maps, its ability to load custom online maps is unmatched. The core of this functionality lies in the onlinemapsources.xml file.
: The app creates a primary, default configuration file named onlinemapsources.xml in the folder: /sdcard/oruxmaps/mapfiles/ . This file contains the maps that are officially offered by OruxMaps. It's a relatively short list, designed to get you started. However, this file is at risk. When you update the OruxMaps app, it may be replaced or overwritten, which would erase any custom maps you've added directly to it. OruxMaps does create a backup file ( onlinemapsources.xml.backup ) during an update, but it's still not an ideal place for your long-term custom sources. Oruxmaps Online Map Sources.xml
: Set to 1 to allow the built-in OruxMaps "Map Creator" tool to download this map layer for complete offline use. Step-by-Step Guide to Adding Custom Maps
Worse: Map servers change their URLs. Your lovingly curated XML file from 2019? Dead. All those $x requests now return 404 or a “forbidden” image. You have to manually hunt down new endpoints—a cartographic archeology project.
. This prevents the app from overwriting your custom sources during official updates.
There is a syntax error in your XML structure (e.g., a missing closing tag like ). Every map in your file must have a different ID
The standard file path is: └─ Android / data / com.orux.oruxmaps / files / oruxmaps / mapfiles / onlinemapsources.xml
Code Select Expand. 🔵 TopoGuide (GR) ©TopoGuide]]> 1 20 MERCATORESFERICA om 1 1 0 0 Customize Onlinemapsources.xml - Page 2 - OruxMaps
Understanding the location of this file is crucial for successful customization. OruxMaps primarily uses two locations for these definitions, but one is designed to be the central, safe place for your custom maps.
button (circular arrows) in the Map List to see new sources. 2. Basic XML Structure Each map source is wrapped in an tag with a unique ID. < onlinemapsources onlinemapsource >My Custom Map < > < > < > < projection >MERCATORESFERICA downloadable downloadable onlinemapsource onlinemapsources Use code with caution. Copied to clipboard 3. Key Parameters Explained Mastering OruxMaps Online Map Sources
As mentioned earlier, when you add a map using the in-app '+' button, OruxMaps saves the configuration in an internal database, not an XML file. However, in recent versions of the app, it is possible to these maps to a file. The exact menu option may vary, but look for an export or share option within the online map management screen. This can be a handy way to back up your settings or share them with other users.
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.
To add a new map, you must inject a new block into the XML file. Here is the standard structural breakdown of a single map entry:
When you view an online map, OruxMaps sends HTTP requests to fetch small square images called "tiles." The XML file provides the base URLs, coordinate systems, zoom levels, and caching parameters required to download and display these tiles seamlessly. Why Customize This File?