Add a Layer
Owners and editors add layers from the Layers tab: its Add layer button opens a dialog with two tabs, File and Web map. Viewers and visitors do not see the button.
Upload a file
Section titled “Upload a file”The File tab uploads a GeoJSON, Shapefile, GeoPackage or GeoTIFF. The description and event date you enter are kept on the new layer. Formats and limits are listed in Uploads: Formats & Limits.
ArcGIS packages (.ppkx) are not uploaded. To bring their imagery in, convert the package into a
web map layer GeoPackage and import that (see below).
Add a web map
Section titled “Add a web map”A web map layer is imagery that each visitor’s browser loads straight from a public tile service, for example a historical aerial image. Nothing of the imagery is copied into the room: it stores only the link, the credit and a few display settings.
- Open Layers → Add layer → Web map.
- Paste the service’s address into Capabilities or tile URL and press Load: either a WMTS
capabilities URL (
…/WMTSCapabilities.xml) or an XYZ tile URL with exactly one{z},{x}and{y}. - For a WMTS service, choose the Layer and, if it offers several, the Tile grid. Only Web Mercator grids are offered, because the map needs them.
- Check the name and the Credit. The credit is shown on the map whenever the layer is visible; providers state the wording they require in their terms.
- Press Check tiles: a test tile must load in your browser.
- Press Preview on map to see the imagery, then Add layer to keep it, or Back to return to the dialog.
The new layer goes to the bottom of the stack, under the room’s other layers. In the Layers tab you can show or hide it, change its opacity, move it up or down, edit its name, credit, description and imagery date, or delete it. Owners and editors can also put it in the legend, where visitors can hide and show it for themselves without changing the room.
Imagery cut to a shape
Section titled “Imagery cut to a shape”A web map layer can carry a cut shape: its imagery shows only inside the shape, and the rest of the map shows through. The layer’s row in the Layers tab then reads Cut to a shape: imagery shows only inside it.
- Browsers never request a tile that lies wholly outside the shape, show a tile wholly inside it as the provider sends it, and cut a tile on its edge before drawing it.
- Nothing of the imagery is stored: the shape travels with the layer to every visitor.
- The shape belongs to the layer’s source, like its URL. It cannot be drawn or edited in the room; to change it, import the layer again.
The shape comes with the layer in a web map layer GeoPackage, for example one converted from an ArcGIS Pro package whose map is clipped to a shape.
- Open the Export / Import tab and choose the
.gpkgfile. - Press Import into Room. The panel reports Imported: 1 web map layers.