Background Maps Troubleshooting
Resolve common Background Maps messages and workflow issues.
Common Messages and Fixes
| Message or Issue | Recommended Fix |
|---|---|
| Assign CRS to drawing to see background map | Assign a CRS to the drawing, then refresh or reopen the palette. |
| No License found. | Check the SPCAD license status before using Background Maps or Capture Image. |
| Please run WMTSLOAD in Model Space. | Switch to model space and run the command again. |
| Please run Capture Image in Model Space. | Switch to model space before opening or running Capture Image. |
| Select a background map from the list before turning the map on. | Select one item in the Background Map list, then click Map On / Off again. |
| Select a background map from the list before capturing an image. | Select a map item before clicking Capture Image. |
| Current view bounds are invalid. | Zoom to a valid drawing area and try loading or refreshing again. |
| No active WMTS session found. | Load a background map first. This message also appears when you try to refresh or turn off a map when no session exists. |
Refresh Issues
| Issue | Recommended Fix |
|---|---|
| Refresh skipped because the current view is too large | Zoom in to a smaller area and run Refresh again. |
| Auto Refresh does not update the map | Confirm that a background map session is active and that Auto Refresh is turned on for that session. |
| Map looks low detail after zooming in | Click Refresh manually. If Auto Refresh is on, SPCAD should refresh after the view becomes small enough relative to the existing raster coverage. |
Capture Image Issues
| Issue | Recommended Fix |
|---|---|
| Specify output image file path. | If using Raster on Disk, click Browse or type a valid image file path before capture. |
| Specify a capture window before capture. | Select Window Selection again and pick a valid rectangular area. |
| Tile count exceeds the current limit. | Choose a lower quality, zoom in, select a smaller area, or use Use Highest Quality Within Limit. |
| Tile count could not be calculated. | Confirm that the drawing has CRS, the selected area is valid, and the map service is reachable. |
| Capture Image cancelled. | The capture was cancelled by the user or by the processing workflow. Run the capture again if needed. |
Display Order Issues
If the background map hides CAD entities, turn Bring Background Image to Front off and refresh or toggle the setting for the active session.
If the map is hidden behind other raster or solid objects, turn Bring Background Image to Front on.
Best Practices
- Work in a practical model-space view instead of loading maps for very large areas.
- Use manual Refresh when you need immediate control over the visible map area.
- Use Window Selection for capture when you need a precise image boundary.
- Use Raster on Disk when the output image file must be stored at a known path.
- Turn Auto Refresh off when working in very large drawings or when frequent panning causes unwanted updates.