Custom imagery

Supported layer types

Besides manually adding layers you can add WMS layers by querying a WMS server for a list of supported layers see layer control, or by querying the Open Aerial Map (OAM) service.

NOTE even though the URLs may look similar to those for a WMS layer, we do not support requesting data from ESRI MapServer with their native protocol.

Adding a custom imagery source

To add a custom layer goto the Preferences screen and select Custom imagery, press the + button to add a new layer, or you can select the same from the layer control, "+" menu. In the form you can set

Selecting the Save button will add the source to the configuration, Save and set will additionally add the source to the active layers as the current background for background imagery sources.

Remote PMTiles source

To add a remote PMTiles source add the URL and then select Save. Vespucci will attempt to retrieve all necessary information for the entry from the remote source if the URL ends with .pmtiles.

Supported place holders

Place holders are replaced when the application retrieves imagery files from the source and are replaced by calculated values. There are some variants even between applications that in principle use the same system, which are noted for completeness sake below.

The place holders have the general format of { place holder name }.

{apikey} api key for sources that require it. JOSM, iD, Vespucci (only in configuration files) see key configuration example for more information.

{zoom} the zoom level

{x} the x tile number

{y} the y tile number

{-y} the y tile number for sources using TMS tile numbering. JOSM, iD, Vespucci

{ty} alternative for the y tile number for sources using TMS tile numbering. iD, Vespucci

{switch:a,b,c} rotating server selection (replace a,b,c by the actual sub-domains). JOSM, iD, Vespucci

{quadkey} used for Bing. Vespucci

{proj} projection for WMS servers. JOSM, Vespucci (only in configuration files)

{wkid} projection for proprietary ESRI servers. JOSM, Vespucci (only in configuration files)

{width} tile width for WMS servers. JOSM, Vespucci

{height} tile height for WMS servers. JOSM, Vespucci

{bbox} bounding box in proj coordinates for WMS servers. JOSM, Vespucci

{subdomain} reserved, used internally by Vespucci

Required placeholders

Note: remote PMTiles sources do not require any placeholders.

Examples

Tile server example:

http://tiles.poole.ch/AGIS/OF2011/{zoom}/{x}/{y}.png

WMS server example:

https://geodienste.sachsen.de/wms_geosn_dop-rgb/guest?FORMAT=image/jpeg&VERSION=1.1.1&SERVICE=WMS&REQUEST=GetMap&LAYERS=sn_dop_020&STYLES=&SRS=EPSG:3857&WIDTH={width}&HEIGHT={height}&BBOX={bbox}

PMTiles example:

https://r2-public.protomaps.com/protomaps-sample-datasets/overture-pois.pmtiles

MBTiles and PMTiles

To add a MBTiles or PMTIles layer, down/upload the file to your device, then go to the Custom imagery form as described above. Tap the SD card icon, navigate to the folder where you saved the file and select it. The form should now be filled out with all necessary values.

Notes: