Skip to content

Bookmarks

Save the current map view — camera position, layer visibility/opacity, and the active basemap — and restore it later with one click. Bookmarks are stored in the browser's localStorage.

  • id: bookmarks
  • Surfaces: left-panel, top-bar

Place it

topBarWidgets: [{ widgetName: 'bookmarks', panelWidth: 270 }],
// or
leftPanelWidgets: [{ widgetName: 'bookmarks' }],

Behavior

  • Save the current view under a name. Saving a name that already exists prompts to overwrite.
  • Restore by clicking a saved bookmark — the map flies to its camera and reapplies its layer/basemap state.
  • Rename and delete (with a confirmation) saved bookmarks.
  • Bookmarks are namespaced by branding.appId, so multiple apps on one origin don't collide.

Configuration — settings.bookmarks

bookmarks: {
  maxCount: 35,
},
Field Type Default Description
maxCount number 35 Maximum saved bookmarks. Saving a new one past the cap prunes the oldest. Set 0 for no cap