Below is a concise, well-formed example of an OruxMaps Online Map Sources.xml file containing common map sources (tile, WMS, and MBTiles via HTTP). Replace URLs, names, and parameters as needed.
<?xml version="1.0" encoding="utf-8"?>
<mapSources>
<!-- OpenStreetMap Standard -->
<mapSource>
<id>osm_standard</id>
<name>OpenStreetMap Standard</name>
<type>tile</type>
<url>https://tile.openstreetmap.org/z/x/y.png</url>
<minZoom>0</minZoom>
<maxZoom>19</maxZoom>
<tileSize>256</tileSize>
<attribution>© OpenStreetMap contributors</attribution>
<isOnline>true</isOnline>
</mapSource>
<!-- OpenTopoMap -->
<mapSource>
<id>opentopomap</id>
<name>OpenTopoMap</name>
<type>tile</type>
<url>https://s.tile.opentopomap.org/z/x/y.png</url>
<subdomains>abc</subdomains>
<minZoom>0</minZoom>
<maxZoom>17</maxZoom>
<tileSize>256</tileSize>
<attribution>© OpenTopoMap (CC-BY-SA)</attribution>
<isOnline>true</isOnline>
</mapSource>
<!-- Stamen Terrain (example with user-agent or referer not set here) -->
<mapSource>
<id>stamen_terrain</id>
<name>Stamen Terrain</name>
<type>tile</type>
<url>https://stamen-tiles.a.ssl.fastly.net/terrain/z/x/y.png</url>
<minZoom>0</minZoom>
<maxZoom>18</maxZoom>
<tileSize>256</tileSize>
<attribution>Map tiles by Stamen Design</attribution>
<isOnline>true</isOnline>
</mapSource>
<!-- Example WMS source -->
<mapSource>
<id>example_wms</id>
<name>Example WMS</name>
<type>wms</type>
<url>https://demo.geo-server.org/geoserver/wms</url>
<layers>layer_name</layers>
<format>image/png</format>
<crs>EPSG:3857</crs>
<minZoom>0</minZoom>
<maxZoom>18</maxZoom>
<attribution>WMS Example</attribution>
<isOnline>true</isOnline>
</mapSource>
<!-- MBTiles over HTTP (served as tiles) -->
<mapSource>
<id>mbtiles_http</id>
<name>Remote MBTiles</name>
<type>tile</type>
<url>https://example.com/tiles/z/x/y.png</url>
<minZoom>0</minZoom>
<maxZoom>14</maxZoom>
<tileSize>256</tileSize>
<attribution>Remote MBTiles</attribution>
<isOnline>true</isOnline>
</mapSource>
</mapSources>
Notes:
If you want a ready-to-import file with specific tile providers or your own URLs, tell me which providers or URLs to include.
The onlinemapsources.xml file is the configuration backbone for online mapping in OruxMaps, allowing users to integrate various map providers beyond the default list. By modifying or adding this file, you can access satellite imagery, topographic maps, and specialized layers like nautical or weather charts. Core Functionality
Custom Map Integration: It acts as a directory where you define the URL patterns for different map servers. Instead of being limited to built-in options, you can add any source that uses standard tile formats (Google/OSM style), WMS (Web Map Service), or WMTS (Web Map Tile Service).
Persistent Storage: While the app comes with a default file in the oruxmaps/mapfiles/ directory, this file is often overwritten during updates. To keep your custom sources safe, you should place your own version in oruxmaps/mapfiles/customonlinemaps/. Oruxmaps Online Map Sources.xml
Layer Management: The XML format allows you to specify parameters for each source, including: Min/Max Zoom: Controls the visibility levels of the map.
Cacheable/Downloadable: Determines if tiles can be saved for offline use. Projection: Typically uses MERCATORELIPSOIDAL or WGS84. How to Add New Sources
To expand your map list, you can either manually edit the XML file or download pre-configured files from community contributors:
Download/Edit: Obtain an updated onlinemapsources.xml (popular distributions like AnyGIS offer hundreds of curated sources).
File Placement: 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. Below is a concise, well-formed example of an
Tap the Refresh (circular arrows) button to load the new sources from your XML. Creating Offline Maps from Online Sources
A major feature enabled by these XML sources is the ability to create permanent offline maps. Once an online source is active, you can use the "Map Creator" tool to select an area and download specific zoom levels directly to your device for use without a data connection. Sample XML Structure
Each map source is defined within
Note: Always respect the Terms of Service of map providers, as some strictly forbid bulk downloading or automated tile scraping. Configuring online maps - OruxMaps Notes:
To the casual user, Oruxmaps is just a green icon—a rugged, no-nonsense alternative to Gaia or AllTrails. But to a digital cartography nerd, the app has a secret heart: a humble XML file usually named oruxmaps Online Map Sources.xml.
This file isn't just a settings menu. It’s a declarative programming language for maps. It’s the skeleton key that lets Oruxmaps access virtually any tile-based map on the internet, from Cold War Soviet military topo sheets to real-time weather radar and obscure mountain biking trails in rural Patagonia.
Let’s pop the hood.
Here is a simple entry for the standard OpenStreetMap:
<onlinemapsource uid="1" >
<name>OpenStreetMap Standard</name>
<url><![CDATA[https://tile.openstreetmap.org/zoom/x/y.png]]></url>
<copyright><![CDATA[© OpenStreetMap contributors]]></copyright>
<onlinemapsource>
And a more advanced one with explicit zoom constraints:
<onlinemapsource uid="42" >
<name>Google Satellite (High Res)</name>
<url><![CDATA[https://mt1.google.com/vt/lyrs=s&x=x&y=y&z=zoom]]></url>
<zoom_min>0</zoom_min>
<zoom_max>22</zoom_max>
<type>PNG</type>
<copyright>Map data ©2024 Google</copyright>
</onlinemapsource>
Every custom source you add will follow this pattern. The uid must be unique; otherwise, Oruxmaps will show duplicate or overlapping entries.