CHAPTER 05

Set Up Maps

The “maps” button opens the Map selection screen. Use it to switch the displayed maps and to add and edit maps. For offline downloads, see Download Maps for Offline Use.

Map selection screen

• Visibility toggle (eye icon) — Shows or hides the map. Maps with a transparency setting are displayed over the map below.
• Map name — For PDF maps and PMTiles, tapping jumps to that map’s extent. Long-press to reorder by dragging.
• Edit (pencil) — Opens the Map Edit screen.
• PDF — Appears when a PDF map is specified. Tap it to fetch the PDF again.
• Up/Down — Moves the display order one step at a time. Maps higher up are displayed in front. Using it just below a group moves the map into or out of the group, the same as dragging.
• Group — Add a group to organize maps together. Create one with “Group creation” on the Map Edit screen, and tap the folder icon to expand or collapse it.
• Offline / online toggle (top left) — Switches to offline mode, which displays only downloaded tiles. See Download Maps for Offline Use.
• Download (top right) — Enters download mode. See Download Maps for Offline Use.
• import — Loads map settings (json), PDF maps, and PMTiles files. Map settings replace everything when they contain multiple maps, and are added or updated when single. A geospatial PDF can be used as a map; multi-page PDFs become a separate map per page, and PDFs exported by EcorisMap can also be loaded. For PMTiles, the extent and zoom are set automatically from the file.
• add — Registers a new map. The Map Edit screen opens.

Maps registered from the start

Right after installation, the following four maps are registered.

“Standard map” and “Satellite image” are Google base maps. Only one of them can be displayed, so turning one on turns the other off. Turning both off leaves no base map. These two cannot be edited, deleted, or reordered, and are always fixed at the bottom of the list.

Adding and editing maps (Map Edit screen)

• Group creation — When checked, this item becomes a group (folder).
• name — The map name shown in the list.
• URL — The map tile URL. See the table below for supported formats.
• Source notation — Note the source in accordance with the map’s terms of use. It is shown at the bottom right of the screen while the map is displayed. When using maps published externally, always check the provider’s terms of use.
• Transparency (0–1) — The higher the value, the more transparent the map, so you can overlay it on the map below. Overlaying a hillshade map is a typical use.
• Fixed zoom — When you zoom in beyond this value, the tiles at this zoom level are scaled up and displayed. This is called overzoom. Set it to the maximum zoom level the map source provides, and the map keeps displaying with enlarged tiles even when you zoom in further — it does not disappear at zoom levels the source does not serve.
• High resolution — Uses tiles one zoom level higher for a more detailed display, such as showing the GSI map in detail over a wide area.
• Y-axis inversion — Check this when loading TMS-format tiles (with the Y-axis origin at the bottom).

• Vector tiles — Appears when a PMTiles URL is specified. Check this when the PMTiles is in vector format. If unchecked, the PMTiles is treated as raster format.

• Style URL (json) — Appears when the URL is pbf or “Vector tiles” is checked. Specifies the style for vector tiles. It follows the layers section of the MapLibre Style Spec, and only basic items are supported. You can also load a style json from your device using the folder button. See style_sample for examples.

• export — Writes out this map’s settings as json.

• delete — Deletes the map settings. A “Do you want to delete it?” confirmation appears.

• save (top right) — Saves your changes.

Supported URL formats

You can specify maps in the following formats as the URL. To create and host tiles from your own data, see Create & Host Map Tiles.