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 must 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 will not support any other spatial reference for tile layers.


Constructor Description
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.

Option Type Default Description
url String Required: URL of the Map Service with a tile cache.
zoomOffsetAllowance Number 0.1 If correctZoomLevels is enabled this controls the amount of tolerance for the difference at each scale level for remapping tile levels.
proxy String false URL of an ArcGIS API for JavaScript proxy or ArcGIS Resource Proxy to use for proxying requests.
useCors Boolean true Dictates if the service should use CORS when making GET requests.
token String null Will use this token to authenticate all calls to the service.


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

Method Returns Description
authenticate(<String> token) this Authenticates 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){
identify() this Returns a new L.esri.services.IdentifyFeatures 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([37.7614, -122.3911], 12);

  url: 'https://services.arcgisonline.com/ArcGIS/rest/services/USA_Topo_Maps/MapServer',
  maxZoom: 15

Edit this page on GitHub