# ArcGisTileLayer
查阅Leaflet API

#### new mars2d.layer.ArcGisTileLayer(options)
plugins/mars2d-esri/ArcGisTileLayer.js 5

ArcGIS Server 瓦片地图服务图层， 【需要引入mars2d-esri 插件库】

参数名称 | 类型 | 描述信息
--- | --- | ---
`options` | Object | 参数对象，包括以下：
参数名称 | 类型 | 默认值 | 描述信息
--- | --- | --- | ---
`url` | String |  | ArcGIS Server服务地址,比如：'https://sampleserver3.arcgisonline.com/ArcGIS/rest/services/World/MODIS/ImageServer'
`zoomOffsetAllowance` | Number | `0.1` | 可选 如果启用correctZoomLevels，这将控制重新映射贴图级别的每个缩放级别上的差异的容错量。
`token` | String |  | 可选 如果您在服务需要传递令牌，它将包含在对服务的所有请求中。
`proxy` | String |  | 可选 代理服务URL
`useCors` | Boolean | `true` | 可选 如果此服务在发出 GET 请求时应使用 CORS。
`opacity` | Number | `1` | 可选 瓦片的不透明度。
`minZoom` | Number | `0` | 可选 最小的缩放级别
`maxZoom` | Number | `18` | 可选 最大的缩放级别
`maxNativeZoom` | Number |  | 可选 瓦片来源可用的最大缩放倍数。如果指定，则所有缩放级别上的图块maxNativeZoom将高于将从maxNativeZoom级别加载并自动缩放。
`minNativeZoom` | Number |  | 可选 瓦片来源可用的最小缩放数。如果指定，所有缩放级别上的图块minNativeZoom将从minNativeZoom级别加载并自动缩放。
`zIndex` | Number | `1` | 可选 瓦片层的显式zIndex
`bounds` | L.LatLngBounds |  | 可选 自定义加载的瓦片矩形范围
`errorTileUrl` | String |  | 可选 显示加载瓦片失败时，显示的图片的url
`tms` | Boolean |  | 可选 如果此值为true，反转切片Y轴的编号（对于TMS服务需将此项打开）
`zoomReverse` | Boolean | `false` | 可选 如果设置为true，则URL网址中使用的缩放z数字将被颠倒（maxZoom - zoom而不是zoom）
`xOffset` | Number |  | 可选 对URL中地图的缩放级别x值加上xOffset值
`yOffset` | Number |  | 可选 对URL中地图的缩放级别y值加上yOffset值
`zOffset` | Number |  | 可选 对URL中地图的缩放级别z值加上zOffset值
`customTags` | function |  | 可选 自定义对瓦片请求参数处理
`tileSize` | Number | L.Point | `256` | 可选 网格中瓦片的宽度和高度。如果宽度和高度相等，则使用数字，否则L.point(width, height)。
`className` | String |  | 可选 要分配给瓦片图层的自定义类名称
`keepBuffer` | Number | `2` | 可选 当平移地图时，在卸载它们之前，先保留许多行和列的数据块。
`detectRetina` | Boolean | `false` | 可选 如果此项为true，并且用户是视网膜显示模式，会请求规定大小一般的四个切片和一个地区内一个更大的缩放级别来利用高分辨率.
`crossOrigin` | Boolean | `false` | 可选 如果为true，则所有图块将其crossOrigin属性设置为“*”。如果要访问像素数据，则需要这样做。
`updateInterval` | Number | `200` | 可选 当平移时，updateInterval毫秒不会更新一次瓦片。
`updateWhenZooming` | Boolean | `true` | 可选 默认情况下，平滑缩放动画（touch zoom 或flyTo()） 会在整个缩放级别更新网格图层。设置此选项false将仅在平滑动画结束时更新网格层。
`noWrap` | Boolean | `false` | 可选 该层是否在子午线断面。 如果为true，GridLayer只能在低缩放级别显示一次。当地图CRS 不包围时，没有任何效果。 可以结合使用bounds 以防止在CRS限制之外请求瓦片。
`chinaCRS` | ChinaCRS |  | 可选 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系。
`id` | String | Number | `createGuid()` | 可选 图层id标识
`pid` | String | Number | `-1` | 可选 图层父级的id，一般图层管理中使用
`name` | String | `''` | 可选 图层名称
`pane` | String | `'tilePane'` | 可选 指定图层添加到地图的哪个pane的DIV中，用于控制不同层级显示的，优先级高于zIndex。

##### 参考:

- `支持的事件类型`

- 更多请参考L.esri.TiledMapLayer类API

### 继承自

- L.esri.TiledMapLayer

### 属性值

#### 只读 hasOpacity : boolean
plugins/mars2d-esri/ArcGisTileLayer.js 156

是否可以调整透明度

#### id : String|Number
plugins/mars2d-esri/ArcGisTileLayer.js 89

对象的id标识

#### 只读 isAdded : Boolean
plugins/mars2d-esri/ArcGisTileLayer.js 67

是否已添加到地图

#### name : String
plugins/mars2d-esri/ArcGisTileLayer.js 102

名称 标识

#### opacity : Number
plugins/mars2d-esri/ArcGisTileLayer.js 142

透明度

#### pid : String|Number
plugins/mars2d-esri/ArcGisTileLayer.js 76

对象的pid标识

#### show : Boolean
plugins/mars2d-esri/ArcGisTileLayer.js 116

显示隐藏状态

### 方法

#### addTo(map) → ArcGisTileLayer
plugins/mars2d-esri/ArcGisTileLayer.js 208

将图层添加到地图

参数名称 | 类型 | 描述信息
--- | --- | ---
`map` | Map | 地图对象

##### 返回值:

当前对象本身，可以链式调用

#### identify(callback, context) → Object
plugins/mars2d-esri/ArcGisTileLayer.js 192

返回一个IdentifyFeatures新对象，可用于识别该图层上的要素。您的回调函数将传递一个带有结果或错误的GeoJSON。

参数名称 | 类型 | 描述信息
--- | --- | ---
`callback` | function | 回调方法
`context` | Object | 可选 侦听器的上下文(this关键字将指向的对象)。

##### 返回值:

L.esri.services.IdentifyFeatures对象

##### 使用示例:

    dynamicMapLayer.identify()
      .at(latlng)
      .run(function(error, featureCollection){
        console.log(featureCollection);
      });

#### metadata(callback, context) → ArcGisTileLayer
plugins/mars2d-esri/ArcGisTileLayer.js 178

请求有关此要素图层的元数据。将使用error和调用回调metadata。

参数名称 | 类型 | 描述信息
--- | --- | ---
`callback` | function | 回调方法
`context` | Object | 可选 侦听器的上下文(this关键字将指向的对象)。

##### 返回值:

当前对象本身，可以链式调用

##### 使用示例:

    dynamicMapLayer.metadata(function(error, metadata){
      console.log(metadata);
    });

#### remove() → ArcGisTileLayer
plugins/mars2d-esri/ArcGisTileLayer.js 218

将图层从地图上移除

##### 返回值:

当前对象本身，可以链式调用