topic Re: MapView.bookmarks in JSAPI 4.x? in ArcGIS JavaScript Maps SDK Questions

MapView.bookmarks in JSAPI 4.x?

EthanBodin1 — Tue, 17 Mar 2020 17:12:01 GMT

In the 4.x version of ArcGIS API for JavaScript, the Bookmarks widget and bookmarks property apply only to a WebView. In 3.x, bookmarks could be used without a web map. Will Bookmarks be available for MapViews in 4.x?

Re: MapView.bookmarks in JSAPI 4.x?

RobertScheitlin__GISP — Tue, 17 Mar 2020 17:26:06 GMT

What is a WebView?... In 4.x the Bookmark widget applies to 2D maps only (i.e. MapView). They currently do not work for SceneViews (as this is a know limitation).

Re: MapView.bookmarks in JSAPI 4.x?

EthanBodin1 — Tue, 17 Mar 2020 19:52:09 GMT

Thank you for the question, which caused me to review and find two mistakes in my post. A less than thorough reading of API docs and sample code led me to believe the widget's view needed to derive from a WebMap (not a WebView, which I made up). I will give it a go.

Re: MapView.bookmarks in JSAPI 4.x?

EthanBodin1 — Tue, 17 Mar 2020 21:21:02 GMT

The WebStyleSymbol (2D) sample has the Bookmarks widget working with an esri/Map in place of esri/WebMap. The key is to initialize the Bookmark widget's bookmarks with an array of Bookmark objects; without that adding a bookmark fails silently.

I still claim the documentation implies WebMap is central to bookmarks functionality (Searching the API for "bookmarks", it looks like WebMap is at the root of Bookmarks. The only Bookmark class is esri/webmap/Bookmark. The only classes with a bookmarks property are the widget and WebMap. The Bookmark class and Bookmarks widget API pages both start off with "typically are defined inside the WebMap", but don't mention any other way to define them, and the sample linked from those pages uses a WebMap.)

Re: MapView.bookmarks in JSAPI 4.x?

RobertScheitlin__GISP — Tue, 17 Mar 2020 21:42:06 GMT

It displays a list of bookmarks, which typically are defined inside the WebMap

Yes the easiest way to use the bookmark widget is to use a webmap that has bookmarks defined in it, but that does not prevent you from creating your own bookmarks collection manually in code and setting the Bookmarks widget bookmarks property to that collection. I have not seen a sample for this because the normal route is to use a webmap.

Re: MapView.bookmarks in JSAPI 4.x?

DianeBird — Mon, 06 Apr 2020 20:56:57 GMT

Is it possible to have both user created bookmarks in the webmap and manually coded bookmarks appearing in the same list when the widget opens? I seem to be able to do one or the other, but not both.

Re: MapView.bookmarks in JSAPI 4.x?

RobertScheitlin__GISP — Mon, 06 Apr 2020 23:09:04 GMT

Diane,

I have not tested it but it would seem logical that you can just add to the bookmarks collection object (which already has the webmaps bookmarks).

Re: MapView.bookmarks in JSAPI 4.x?

DianeBird — Tue, 07 Apr 2020 15:04:33 GMT

Yes - I was able to add it to the code as follows:

It works perfectly, and I can still add new bookmarks to the list.