Using map.setBasemap(); for web tiled layers

RobertWinterbottom

I am just curious if it is possible to use web tile layers such as stamen or mapbox through:

map.setBasemap('myBasemap');

I know I can do something like this to get it to recognize me calling map.setBasemap('myBasemap'):

esri.basemaps['myBasemap'] = {
  baseMapLayers: [{
    url: 'http://{subDomain}.tile.stamen.com/watercolor/{level}/{col}/{row}.jpg'
  }],
  title: 'My Layer'
};

but the problem with this is it obviously wont treat the url as a tiled layer and ends up looking for something like the following:

http://%7Bsubdomain%7D.tile.stamen.com/watercolor/%7Blevel%7D/%7Bcol%7D/%7Brow%7D.jpg

Is there a good way to get the map to recognize tiled layers this way?

I am trying to avoid adding this as a web tiled layer on top of a basemap as I would like to add this to a custom basemap gallery and to be able to use this layer the same way as other basemaps via map.setBasemap().

KristianEkenes

Robert,

I'm not sure that I understand your issue completely, but I'll give it a shot.

In 3.14, instead of using esri.basemaps, you can create your own basemap instance using the Basemap and BasemapLayer classes. You can then pass your own Basemap instance into the BasemapGallery. I did this with the Stamen toner tiled layer in this bin: JS Bin - Collaborative JavaScript Debugging

You mentioned map.setBasemap in your last comment. I don't believe you can use setBasemap() to switch over to your own. BasemapGallery and BasemapToggle will allow you to do this, however.

That being said, this will all be easier in the 4.0 API. You can already see how much easier it is by taking a look at this sample: JS Bin - Collaborative JavaScript Debugging where I create a Stamen basemap and pass it into the BasemapToggle widget.

What's different about this sample is that not only is constructing each instance simpler, but you can also use the new basemap instance to set your map's basemap. In 4.0, instead of map.setBasemap(), you can set it directly on the basemap property like this:

map.basemap = stamen;

That's all there is to it! Go ahead and try it in the sample I referenced: JS Bin - Collaborative JavaScript Debugging . Open the console and type map.basemap = stamen. Then try switching to the others as well.

Hopefully this helps answer your question.