Extends L.TileLayer

Access tiles from ArcGIS Online and ArcGIS Server to visualize and identify features. Copyright text from the service is added to map attribution automatically.

If you have published a Feature Service in ArcGIS Online, it can be used to create a static set of tiles as well. You can find details about that process in the ArcGIS Online Help.

Your map service should be published using the Web Mercator Auxiliary Sphere tiling scheme (WKID 102100/3857) and the default scale options used by Google Maps, Bing Maps and ArcGIS Online. Esri Leaflet does not officially support any other spatial reference for tile layers, however unofficial support maybe obtained though the the Proj4Leaflet plugin as shown in the projection samples.


L.esri.tiledMapLayer(<Object> options)The options parameter can accept the same options as L.tileLayer. The only required parameter is url.


L.esri.TiledMapLayer also accepts all L.TileLayer options.

urlStringRequired: URL of the Map Service with a tile cache.
zoomOffsetAllowanceNumber0.1If correctZoomLevels is enabled this controls the amount of tolerance for the difference at each scale level for remapping tile levels.
proxyStringfalseURL of an ArcGIS API for JavaScript proxy or ArcGIS Resource Proxy to use for proxying requests.
useCorsBooleantrueDictates if the service should use CORS when making GET requests.
tokenStringnullWill use this token to authenticate all calls to the service.


L.esri.TiledMapLayer inherits all methods from L.TileLayer.

authenticate(<String> token)thisAuthenticates this service with a new token and runs any pending requests that required a token.
metadata(<Function> callback, <Object> context)this

Requests metadata about this Feature Layer. Callback will be called with error and metadata.

featureLayer.metadata(function(error, metadata){

Returns a new


object that can be used to identify features on this layer. Your callback function will be passed a GeoJSON FeatureCollection with the results or an error.

.at(latlng, latlngbounds, 5)
.run(function(error, featureCollection){


L.esri.TiledMapLayer fires all L.TileLayer events.


var map = L.map('map').setView([ 40.672827, -73.957901], 11);

    url: 'https://tiles.arcgis.com/tiles/nGt4QxSblgDfeJn9/arcgis/rest/services/New_York_Housing_Density/MapServer'

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.