Bookmarks

Bookmarks used to be called named extents in Essentials.

A bookmark is a shortcut that enables end users to jump the map to a particular map extent.

For example, you could configure a bookmark named Downtown that encompasses the city center. When an end user selects the Downtown bookmark, the map automatically pans and zooms to the extent of Downtown.

If there are particular bookmarks that you want to make available to end users, you can configure them in Manager. This saves the bookmarks in the site configuration so that all users have access to them. In addition, end users can create their own bookmarks. Bookmarks that are created by an end user exist only for the duration of the session—when the user closes the viewer, the bookmarks disappear. To save bookmarks across sessions, a signed-in user can save a project, provided the viewer supports projects. For information about projects, see Project Module.

If you want a particular viewer to support bookmarks, you must make the Bookmarks tool or map widget available in the viewer.

The steps to configure bookmarks are:

Add a Bookmark

You can either add a new bookmark, or import bookmarks that are already configured in another site. There are two approaches to adding new bookmarks:

Manager's Map page has an Extents tab where you configure bookmarks. To zoom the map preview to a bookmark, click the bookmark on the Extents tab.

Zoom the map preview to the LA County bookmark

Add a Bookmark Using the Map Preview

To add a bookmark using the map preview:

  1. In Manager, edit the site that you want to configure, click Map in the side panel, and then click the Extents tab.

  2. Pan and zoom the map preview to show the extent that you want to add a bookmark for.

  3. Click Add Bookmark.

    A new bookmark appears at the bottom of the list on the Extents tab. The new bookmark has the same extent as the map preview.

  4. Type a name for the bookmark and press Enter.

    Bookmark names can contain spaces and special characters.

  5. Click Apply Changes.

Add a Bookmark Using Coordinates

To add a bookmark using coordinates:

  1. In Manager, edit the site that you want to configure, click Map in the side panel, and then click the Extents tab.

  2. Click Add Bookmark.

    A new bookmark appears at the bottom of the list on the Extents tab.

  3. Type a name for the bookmark and press Enter.

    Bookmark names can contain spaces and special characters.

  4. Click the Edit icon beside the new bookmark.

  5. Edit each coordinate that you want to change. To change a coordinate, click in the box and edit the value.

    The coordinates that you enter must be in the same spatial reference as the map.

    You can edit all four coordinates at one time using copy and paste (Ctrl-C and Ctrl-V). Copy them as a comma-delimited list, for example, -80, -160, 80, 160. Paste them into any one of the boxes. Essentials will sort them into the correct boxes.

  6. Click OK.

  7. On the Extents tab, click the new bookmark.

    The map preview updates to show the bookmark, so you can verify it.

  8. Click Apply Changes.

Import Bookmarks

To import bookmarks:

For an imported bookmark to work, it must be in the same spatial reference as the map.

  1. In Manager, edit the site that you want to configure, click Map in the side panel, and then click the Extents tab..

  2. Click Import Bookmark.

    If the Import Bookmark button is grayed out, click Apply Changes to make the button available.

  3. Select the site where the bookmarks are configured, and then click Next.

  4. Select the bookmarks that you want to import.

    To select multiple bookmarks, hold the Ctrl key down while selecting.

  5. Click Finish.

    The bookmarks are added to the bottom of the list on the Extents tab.

Change a Bookmark

Change a Bookmark's Display Name

To change a bookmark's display name:

This procedure explains how to change the bookmark's display name by editing the bookmark.

You can also change a bookmark's display name by double-clicking the bookmark on the Extents tab.

  1. In Manager, edit the site that you want to configure, click Map in the side panel, and then click the Extents tab.

  2. Position the pointer over the bookmark.

    The management tools show.

  3. Click Edit .

  4. Click in the Display Name box and edit the name.

  5. Click OK.

  6. Click Apply Changes.

Change a Bookmark's Extent Using the Map Preview

To change a bookmark's extent using the map preview:

  1. In Manager, edit the site that you want to configure, click Map in the side panel, and then click the Extents tab.

  2. Pan and zoom the map preview to show the extent that you want to use.

  3. On the Extents tab, position the pointer over the bookmark.

    The management tools appear.

  4. Click Edit .

  5. Click Use Current View.

  6. Click OK.

  7. Click Apply Changes.

Change a Bookmark's Extent Using Coordinates

To change a bookmark's extent using coordinates:

  1. In Manager, edit the site that you want to configure, click Map in the side panel, and then click the Extents tab.

  2. Position the pointer over the bookmark.

    The management tools show.

  3. Click the Edit icon .

  4. Edit each coordinate that you want to change. To change a coordinate, click in the box and edit the value.

    The coordinates that you enter must be in the same spatial reference as the map.

    You can edit all four coordinates at one time using copy and paste (Ctrl-C and Ctrl-V). Copy them as a comma-delimited list, for example, -80, -160, 80, 160. Paste them into any one of the boxes. Essentials will sort them into the correct boxes.

  5. Click OK.

  6. On the Extents tab, click the bookmark.

    The map preview updates to show the bookmark, so you can verify it.

  7. Click Apply Changes.

Remove a Bookmark

To remove a bookmark:

  1. In Manager, edit the site that you want to configure, click Map in the side panel, and then click the Extents tab.

  2. Position the pointer over the bookmark that you want to remove.

    The management tools show.

  3. Click Remove .

  4. You are prompted to confirm.

  5. Click OK.

Reorder the List of Bookmarks

Bookmarks appear in the viewer in the same order that they appear on the Map page's Extents tab. You can change the list of bookmarks so they appear in a sensible order. For example, you could order the list with the bookmarks that you expect to be used the most at the top of the list. If the list is long, this saves the end user having to scroll the list.

To change the order of the list of bookmarks:

  1. In Manager, edit the site that you want to configure, click Map in the side panel, and then click the Extents tab.

  2. Click and hold a bookmark that you want to move to a different position in the list.

  3. Drag the bookmark to the desired position.

    A guideline shows where the bookmark can be placed.

  4. Release the mouse button.

  5. Continue to move bookmarks until the list is sorted the way that you want it.

  6. Click Apply Changes.