Maps

SDL Maps gives operators one inventory for geospatial layers published by the local node and by reachable federated nodes. Use it to find GeoServer map layers, tile-backed basemaps, preview a layer, inspect fetch endpoints, and request that a remote layer be brought onto the current node for disconnected use.

What Maps Shows

The Maps page combines mapping sources into a single searchable inventory.

Source What it provides Typical use

Local GeoServer

Published WMS map layers from the current node’s GeoServer instance.

Preview operational overlays and inspect WMS fetch details.

Local tile server

Raster and vector tile catalog entries from the current node.

Preview basemaps, imagery tiles, and PMTiles or MBTiles-backed map products.

Remote GeoServer

Published WMS map layers discovered from federated nodes.

Use remote overlays while connected, or request federation for offline use.

Remote tile server

Tile catalog entries discovered from federated nodes.

Use remote basemaps or request federation for supported tile packages.

Remote layers remain dependent on the remote node until you federate them. Federating a layer requests a map transfer to the current node so the layer can continue to operate during disconnected or degraded network conditions.

Open Maps

  1. Sign in to the SDL web UI.

  2. Open Maps from the main navigation.

  3. Wait for Layer Inventory to finish loading.

If local GeoServer is not configured, Maps displays an information message and continues loading tile catalog entries and any remote endpoints that can be derived from federated node information. If a source cannot be reached, Maps displays an error for that source while still showing layers from sources that loaded successfully.

Layer Inventory

The Layer Inventory tab is the primary operating view. Each row represents one published map layer or tile catalog item.

Maps Layer Inventory

Use the inventory controls to narrow the list:

  • Search — match by display name, canonical name, source, node, workspace, layer type, fetch mode, or metadata.

  • Source — filter to a specific local or remote GeoServer or tile server.

  • Fetch Mode — filter by protocols and access patterns such as WMS, TileJSON, XYZ, or MapStyle.

  • Clear Filters — reset search and filters.

Each layer card includes:

  • Location — local node or federated node label.

  • Display name — user-friendly layer title when published by the source.

  • Canonical name — source identifier, such as a GeoServer layer name or tile catalog name.

  • Badges — source type, render type, storage type, workspace, and available fetch modes.

  • Description — source-published description when available.

  • Metadata — operational details such as workspace, bounds, zoom range, storage type, or tile type.

Preview a Layer

Click Preview on a layer card to open an interactive map preview. The preview lets you validate that the layer renders before using its fetch endpoints or requesting federation.

Maps Preview Dialog

Preview supports:

  • GeoServer WMS layers.

  • Raster tile sources.

  • TileJSON sources.

  • Vector tile sources rendered through the map style service.

For vector tile sources, use the Light and Dark controls in the preview dialog to switch the style theme. For remote layers, the preview dialog also shows a warning that the layer depends on remote connectivity until it is federated.

If a preview fails, Maps shows the preview error and, when available, a sample tile request URL. Use that URL to confirm whether the browser can reach the source service.

View Fetch Details

Click View Details on a layer card to inspect service endpoints. Maps shows the exact links needed to fetch that layer from its source.

GeoServer layers commonly include:

  • WMS GetCapabilities — service metadata for map rendering.

  • Example WMS GetMap — example map image request for the selected layer.

Tile catalog layers commonly include:

  • Style JSON — style endpoint for vector tile rendering.

  • TileJSON — metadata endpoint with bounds, zoom range, attribution, and tile templates.

  • Catalog Template — raw tile URL template published by the tile catalog.

  • Resolved Preview Source — tile source used by the preview.

Use the copy button beside an endpoint to copy it to the clipboard. Use the open button to inspect the endpoint in a new browser tab.

Federate Remote Layers

Remote layers are marked as federated and include a Federate action when they support transfer to the current node. Use federation when a layer is operationally relevant and needs to remain available during DDIL conditions.

  1. Find the remote layer in Layer Inventory.

  2. Click Preview to confirm the layer is the one you need.

  3. Click Federate from the layer card or preview dialog.

  4. Wait for the transfer request confirmation.

  5. Return later or refresh the inventory after the transfer completes.

Maps can request federation for supported GeoServer layers and tile packages. For tile packages, the source must publish a supported storage type such as mbtiles or pmtiles. For GeoServer layers, Maps sends the source workspace and layer name to the current node’s federation service.

Federate requests a transfer; it does not guarantee immediate local availability. Transfer completion depends on node connectivity, source size, priority, and federation service status.

Map Services

The Map Services tab shows source-level service endpoints for each local and remote node that Maps can inspect.

Maps Services Tab

Use this tab when you need to troubleshoot source discovery or provide service URLs to another operator:

  • GeoServer Source — WFS and WMS capabilities endpoints for a node’s GeoServer service.

  • Tile Catalog Source — tile catalog JSON endpoint for a node’s tile server.

  • Open GeoServer or Open Tile Catalog — opens the source service directly.

The summary chips show total discovered layers, GeoServer layers, tile catalog layers, type count, and federated layer count.

Local and Remote Behavior

Layer location Online behavior DDIL behavior

Local layer

Preview and fetch from the current node.

Remains available as long as the local map service is running.

Remote layer

Preview and fetch through the federated node’s service endpoint.

Not available if the remote endpoint cannot be reached.

Federated remote layer

Transfer is requested from the remote node to the current node.

Intended to become locally available after transfer completes.

For remote layers, Maps derives service endpoints from the federated node URL. For example, the current node’s tile catalog and style services map to corresponding maptiles and mapstyles service hosts on the remote node. GeoServer endpoints are derived from the configured local GeoServer URL when possible.

Troubleshooting

Symptom Likely cause Operator action

Local GeoServer message appears.

GeoServer base URL is not configured for the current node.

Continue using tile catalog sources, or ask an administrator to configure the GeoServer base URL.

Source error appears.

GeoServer capabilities or tile catalog request failed.

Open the source endpoint from Map Services and confirm the service is reachable.

No layers match.

Search or filters are too narrow, or no source returned layers.

Click Clear Filters and review source errors.

Preview error appears.

Browser cannot load the selected WMS, TileJSON, style, or tile endpoint.

Open the endpoint shown in the preview error or layer details.

Federate is disabled.

The remote source does not expose transfer metadata supported by Maps.

Use the layer online, or contact an administrator to confirm map transfer support for that source.

Transfer request fails.

Current node could not create a map transfer request for the remote node.

Confirm federation health, remote node reachability, and user permissions.

Related Information