MapGIS Client for JavaScript API

new IGSVectorTileLayer(options)

document/layer/igserver/IGSVectorTileLayer.js, line 11

支持如下方法：

[1、根据子图层id查询图层]
[2、通过传入的 JSON 构造并返回一个新的 IGSVectorTileLayer 对象]
[3、导出为 JSON 对象]
4、通过矢量瓦片样式图层的id，找到对应的矢量瓦片样式图层对象
5、通过矢量瓦片样式图层的id，找到对应的矢量瓦片样式图层的序号
6、通过矢量瓦片样式图层的序号，找到对应的矢量瓦片样式图层的id
7、设置样式图层属性对象
8、删除样式图层
9、设置样式图层可见性
10、获取样式图层可见性
11、获取样式图层绘制属性
12、设置样式图层绘制属性
13、获取样式图层布局属性
14、设置样式图层布局属性
17、克隆图层

IGS矢量瓦片图层
支持IGS1.0和2.0两个服务版本

支持通过如下三种方式来初始化矢量瓦片图层对象：
1、通过服务基地址来初始化矢量瓦片图层对象；
2、通过加载矢量瓦片样式文件的方式来初始化矢量瓦片图层对象；
3、通过设置矢量瓦片样式的方式来初始化矢量瓦片图层对象；
当加载MapGIS制作并由IGS发布的矢量瓦片时，如果矢量瓦片样式中有mapinfo参数，则子图层ID对应的是MapX中的图层索引；如果没有mapinfo参数，则子图层ID对应的是矢量瓦片样式图层ID；
当加载第三方发布的矢量瓦片时，子图层ID对应的是矢量瓦片样式图层ID；

[ES5引入方式]：
zondy.layer.IGSVectorTileLayer()
[ES6引入方式]：
import { IGSVectorTileLayer } from "@mapgis/webclient-common"

针对图层的操作请在图层加载完毕事件中进行
Layer.on('layerview-created', function (result) {
console.log("加载完毕:", result.layer)
});
如果不想在该事件中放入业务代码，则请确认图层资源以加载完毕后再进行操作
if(layer.loadStatus === 'loaded') {
// 你的业务逻辑
}

同时也支持二次开发自定义业务逻辑，示例如下：
[自定义矢量瓦片业务逻辑-es5]，[自定义矢量瓦片业务逻辑-es6]

注意:三维上,不支持简单Marker样式设定;二维上,简单Marker的颜色,外边线样式,旋转角度无法在图层初始化和初始化后修改,须在制作数据时进行指定

Name Type Description

options

Object

构造参数

Name	Type	Default	Description
`url`	String	null	可选服务基地址，和style参数二者选其一: IGS1.0的服务基地址为：http://{ip}:6163/igs/rest/mrcs/vtiles/{folder}:{serviceName} IGS2.0的服务基地址为：http://{ip}:{port}/igs/rest/services/{folder}/{serviceName}/VectorTileServer 参考示例：[IGS2.0的矢量瓦片示例] 服务基地址也支持传入矢量瓦片样式文件地址：样式文件地址：http://{文件服务路径}/{样式文件名称}.json 请注意当服务基地址内容为矢量瓦片样式文件地址时，请保证图层名和数据源名称一致，否则会导致接口请求异常删除图层方法：[删除图层]
`style`	Object	null	可选矢量瓦片的mvt样式对象，默认从服务中获取，用户也可主动传入mvt样式对象来构造一个矢量瓦片图层，此时会忽略用户输入的url参数和url参数二者选其一参考示例：[通过mvt样式对象来构造矢量瓦片示例]
`sublayers`	Collection.<IGSVectorTileSubLayer>		可选会通过该参数中指定的子图层列表对矢量瓦片服务中的子图层进行过滤，不在列表中的子图层将不会显示；如果没有指定该参数，则会按照矢量瓦片服务中的子图层的属性显示所有子图层；如果该参数为空数组，则矢量瓦片服务所有的子图层都不显示。目前支持的专题图如下： `1、单值专题图` `2、分段专题图` `3、统一专题图` 参考示例： [1、显示所有子图层] [2、根据id显示子图层] [3、通过修改子图参数，设置子图层显隐] [4、设置子图层专题图-单值专题图] [5、设置子图层专题图-分段专题图] [6、设置子图层专题图-统一专题图] [7、通过修改子图参数，设置子图层专题图]
`minScale`	Number	0	可选最小显示比例尺，图层在视图中可见的最小比例尺。
`maxScale`	Number	0	可选最大显示比例尺，图层在视图中可见的最大比例尺。
`opacity`	Number	1	可选图层透明度，0到1之间的值，0为完全透明，1为不透明，参考示例：[设置图层透明度]
`tokenKey`	String	'token'	可选 token名
`tokenValue`	String	null	可选 token值，只有当tokenValue存在时，才会绑定token
`visible`	Boolean	true	可选图层显示或隐藏，true则显示，false则隐藏，参考示例：[设置图层显隐]
`labelsRenderMode`	String	'off-screen'	可选指定矢量瓦片注记的渲染模式,仅在三维上有效 on-screen: 使用Cesium接口实时渲染注记 off-screen: 使用矢量瓦片来绘制注记三维注记目前不支持修改透明度和显隐参数请注意模式切换时，会造成性能损失，在显卡较弱的机器上会出现卡顿现象参考示例：[矢量瓦片三维注记][切换三维注记模式]
`clippingArea`	Polygon \| Extent \| Circle \| MultiPolygon \| null	null	可选图层空间裁剪范围，仅支持多多边形裁剪、多边形裁剪、矩形裁剪、圆形裁剪
`replaceStyleURL`	Boolean	true	可选初始化图层时，是否将样式中的基地址替换为图层的基地址
`replaceStyleURLRegExp`	RegExp	'预定义的正则表达式'	可选当replaceStyleURL设置为true时，将样式中的基地址替换为图层的基地址操作中使用的正则表达式

Fires

Layer#event:图层加载完毕事件
Layer#event:图层销毁完毕事件
Layer#event:图层更新完毕事件
Layer#event:图层显隐更新完毕事件
Layer#event:图层透明度更新完毕事件

Examples

IGS1.0的矢量瓦片示例

//初始化地图管理容器
// ES5引入方式
const { IGSVectorTileLayer } = zondy.layer
const { SpatialReference } = zondy
// ES6引入方式
import { IGSVectorTileLayer, SpatialReference } from "@mapgis/webclient-common"
//初始化矢量瓦片图层
const igsVectorTileLayer = new IGSVectorTileLayer({
  // 矢量瓦片基地址
  url: ''
});

IGS2.0的矢量瓦片示例

 // ES5引入方式
const { IGSVectorTileLayer } = zondy.layer
// ES6引入方式
import { IGSVectorTileLayer } from "@mapgis/webclient-common"
// 初始化矢量瓦片图层
const igsVectorTileLayer = new IGSVectorTileLayer({
  // 矢量瓦片基地址
  url: ''
});

通过mvt样式对象来构造矢量瓦片示例

// ES5引入方式
const { IGSVectorTileLayer } = zondy.layer
// ES6引入方式
import { IGSVectorTileLayer } from "@mapgis/webclient-common"
// 初始化矢量瓦片图层
const igsVectorTileLayer = new IGSVectorTileLayer({
  // 矢量瓦片的mvt样式对象
  style: {}
});

自定义矢量瓦片业务逻辑-es5

// ES5引入方式
const { IGSVectorTileLayer } = zondy.layer
// ES6引入方式
import { IGSVectorTileLayer } from "@mapgis/webclient-common"
// 初始化矢量瓦片图层
const igsVectorTileLayer = new IGSVectorTileLayer({
  // 矢量瓦片基地址
  url: ''
});
// 例如通过重写igsVectorTileLayer对象的covertCustomStyleToMVTStyle方法，来自定义矢量瓦片业务逻辑
igsVectorTileLayer.covertCustomStyleToMVTStyle = function(customStyle) {
  // 自定义你的业务逻辑
  // 此方法必须要返回一个符合MapBox标准的矢量瓦片
  return mvtStyle
}
// 在ES5模式下，如果更改了图层的业务逻辑，则必须通过图层的load方法来加载元信息，之后再添加图层
igsVectorTileLayer.load().then(() => {
  // 添加图层
  map.add(igsVectorTileLayer)
})

自定义矢量瓦片业务逻辑-es6

// ES6引入方式
import { IGSVectorTileLayer } from "@mapgis/webclient-common"
// 在ES6模式下继承IGSVectorTileLayer，并重写其业务逻辑
class IGSVectorTileLayerCustom extends IGSVectorTileLayer {
  constructor(options) {
    super(options)
  }
}
// 重写方法
IGSVectorTileLayerCustom.prototype.covertCustomStyleToMVTStyle = function (customStyle) {
  // 自定义你的业务逻辑
  // 此方法必须要返回一个符合MapBox标准的矢量瓦片
  return mvtStyle
}
const customLayer = new IGSVectorTileLayerCustom({
  // 矢量瓦片基地址
  url: ''
})

矢量瓦片三维注记

// ES5引入方式
const { LabelClass } = zondy
const { IGSVectorTileLayer } = zondy.layer
// ES6引入方式
import { IGSVectorTileLayer, LabelClass } from "@mapgis/webclient-common"
// 初始化一个额外的图标DOM对象
const iconImage = new Image()
iconImage.src = '图片地址或者base64字符串'
// 初始化矢量瓦片图层
const igsVectorTileLayer = new IGSVectorTileLayer({
  // 矢量瓦片基地址
  url: '',
  // 开启三维注记
  labelsRenderMode: 'on-screen',
  // 设置要应用三维主句的子图层
  sublayers: [{
    // 矢量瓦片子图层id
    id: '矢量瓦片子图层id',
    // 注记参数，目前仅用填写一个
    labelingInfo: [
      new LabelClass({
        symbol: {
          // 填充颜色 rgba or 16进制颜色
          color: 'rgba(255,255,255,1)',
          // 描边颜色
          haloColor: 'rgba(0,0,0,0.5)',
          // 描边宽度
          haloSize: 2,
          // 行高
          lineHeight: 1.1,
          // 文本间距
          letterSpacing: 2,
          // 字体样式 参考css
          font: {
            size: 14,
            family: '微软雅黑',
            weight: 'normal',
            style: 'normal'
          },
          // 额外的图标
          textExtraIcon: iconImage,
          // 图标的大小
          textExtraIconSize:20,
          // 图标方位
          textExtraIconAnchor:'left'
        },
        // 渲染方式 1.canvas 2.label 3.ground
        renderMode: 'canvas',
        // 最大可见范围
        minScale: 60000000,
        // 最小可见范围
        maxScale: 1,
        // 布局位置 可选 1.above-left 2.above-center 3.above-right 4.center-left 5.center-center 6.center-right 7.below-left 8.below-center 9.below-right
        labelPlacement: 'above-center',
        // 高程采样参数
        elevationInfo: {
          mode: 'OnTheGround',
          offset: 0
        }
      })
    ]
  }]
});

切换三维注记模式

// 矢量瓦片渲染模式
igsVectorTileLayer.labelsRenderMode = 'off-screen'
// Cesium三维渲染模式
igsVectorTileLayer.labelsRenderMode = 'on-screen'

设置图层透明度

igsVectorTileLayer.opacity = 0.5

显示或隐藏图层

igsVectorTileLayer.visible = !igsVectorTileLayer.visible

删除图层

map.remove(igsVectorTileLayer)

显示所有子图层

 // ES5引入方式
const { IGSVectorTileLayer } = zondy.layer
// ES6引入方式
import { IGSVectorTileLayer } from "@mapgis/webclient-common"
// 添加图层
const igsVectorTileLayer = new IGSVectorTileLayer({
  // 服务基地址
  url: 'http://{ip}:{port}/igs/rest/services/{serviceName}/VectorTileServer',
  //默认不设置sublayers,加载全部图层
});

根据id显示子图层

// ES5引入方式
const { IGSVectorTileLayer } = zondy.layer
// ES6引入方式
import { IGSVectorTileLayer } from "@mapgis/webclient-common"
// 添加图层
const igsVectorTileLayer = new IGSVectorTileLayer({
  // 服务基地址
  url: 'http://{ip}:{port}/igs/rest/services/{serviceName}/VectorTileServer',
  // 根据id显示子图层
  sublayers: [
     {
       // 子图层id
       id: '子图层id',
       // 显示子图层
       visible: true
     }
   ]
});

通过修改子图参数，设置子图层显隐

// ES5引入方式
const { IGSVectorTileLayer } = zondy.layer
// ES6引入方式
import { IGSVectorTileLayer } from "@mapgis/webclient-common"
// 添加图层
const igsVectorTileLayer = new IGSVectorTileLayer({
  // 服务基地址
  url: 'http://{ip}:{port}/igs/rest/services/{serviceName}/VectorTileServer'
});
igsVectorTileLayer.on('layerview-created', function (result) {
  console.log("加载完毕:", result.layer)
  // 根据id获取子图层
  const subLayer = igsVectorTileLayer.findSublayerById('图层id')
  // 设置子图层显隐
  subLayer.visible = false
})

设置子图层专题图-单值专题图

// ES5引入方式
const { IGSVectorTileLayer } = zondy.layer
const { UniqueValueRenderer } = zondy.renderer
const { SimpleFillSymbol,SimpleLineSymbol } = zondy.symbol
const { Color } = zondy
// ES6引入方式
import { IGSVectorTileLayer,UniqueValueRenderer ,SimpleFillSymbol,SimpleLineSymbol,Color} from "@mapgis/webclient-common"
const igsVectorTileLayer = new IGSVectorTileLayer({
  // 服务基地址,当不指定图层名称时,默认查询第一个子图层
  url: 'http://{ip}:{port}/igs/rest/services/{serviceName}/VectorTileServer',
  // 设置子图层专题图
  sublayers: [
     {
       // 子图层id
       id: '子图层id',
       // 设置渲染样式-单值专题图
       renderer: new UniqueValueRenderer({
         //专题图过滤字段名
         field: '你的字段名',
         // 默认样式,当没有匹配到指定值时,会使用默认样式
         //因为该数据的几何类型为区,因此设置区样式
         defaultSymbol: new SimpleFillSymbol({
           // 填充颜色
           color: 'rgba(1,1,252,0)',
           // 外边线样式
           outline: new SimpleLineSymbol({
             //线颜色
             color: new Color(255, 1, 0, 1),
             //线宽
             width: 1
           })
         }),
         //单值专题图过滤调条件数组
         uniqueValueInfos: [{
           //指定字段值
           value: "指定的值",
           //匹配到该值后的样式
           //因为该数据的几何类型为区,因此设置区样式
           symbol: new SimpleFillSymbol({
             // 填充颜色
             color: 'rgba(1,1,252,1)',
             // 外边线样式
             outline: new SimpleLineSymbol({
               //线符号颜色
               color: new Color(255, 1, 0, 11),
               //线宽
               width: 1
               })
             })
           },{
             //指定字段值
             value: "指定的值",
             //匹配到该值后的样式
             //因为该数据的几何类型为区,因此设置区样式
             symbol: new SimpleFillSymbol({
               // 填充颜色
               color: new Color(211, 111, 11, 1)
             })
           }]
       })
     }
  ]
});

设置子图层专题图-分段专题图

// ES5引入方式
const { IGSVectorTileLayer } = zondy.layer
const { ClassBreakRenderer } = zondy.renderer
const { SimpleFillSymbol,SimpleLineSymbol } = zondy.symbol
const { Color } = zondy
// ES6引入方式
import { IGSVectorTileLayer,ClassBreakRenderer ,SimpleFillSymbol,SimpleLineSymbol,Color} from "@mapgis/webclient-commo
const igsVectorTileLayer = new IGSVectorTileLayer({
  // 服务基地址,当不指定图层名称时,默认查询第一个子图层
  url: 'http://{ip}:{port}/igs/rest/services/{serviceName}/VectorTileServer',
  // 设置子图层专题图
  sublayers: [
    {
     // 子图层id
     id: '子图层id',
     // 设置渲染样式-分段专题图
     renderer: new ClassBreakRenderer({
       //专题图过滤字段名
       field: '你的字段名',
       // 默认样式,当没有匹配到指定值时,会使用默认样式
       // 因为该数据的几何类型为区,因此设置区样式
       defaultSymbol:  new SimpleFillSymbol({
         // 填充颜色
         color: 'rgba(222,1,252,1)',
         // 线符号样式
         outline: new SimpleLineSymbol({
           //线符号颜色
           color: new Color(255, 1, 0, 1),
           //线宽
           width: 1
         })
       }),
       //分段专题图过滤条件数组
       classBreakInfos: [{
         // 最大过滤范围,field对应的值小于maxValue
         maxValue: "最大范围",
         // 最小过滤范围,field对应的值大于等于minValue
         minValue: "最小范围",
         // 匹配到该值后的样式
         // 因为该数据的几何类型为区,因此设置区样式
         symbol:  new SimpleFillSymbol({
           // 填充颜色
           color: 'rgba(1,1,252,1)',
           // 线符号样式
           outline: new SimpleLineSymbol({
             //线符号颜色
             color: new Color(255, 1, 0, 1),
             //线宽
             width: 1
           })
         })
       }]
     })
   }
 ]
});

通过修改子图参数，设置子图层专题图

// ES5引入方式
const { IGSVectorTileLayer } = zondy.layer
const { ClassBreakRenderer } = zondy.renderer
const { SimpleFillSymbol,SimpleLineSymbol } = zondy.symbol
const { Color } = zondy
// ES6引入方式
import { IGSVectorTileLayer,ClassBreakRenderer ,SimpleFillSymbol,SimpleLineSymbol,Color} from "@mapgis/webclient-commo
const igsVectorTileLayer = new IGSVectorTileLayer({
  // 服务基地址
  url: 'http://{ip}:{port}/igs/rest/services/{serviceName}/VectorTileServer'
});
// 根据id获取子图层
const subLayer = igsVectorTileLayer.findSublayerById('子图层id')
// 设置渲染样式-分段专题图
subLayer.renderer = new ClassBreakRenderer({
    // 专题图过滤字段名
    field: '你的字段名',
    // 默认样式,当没有匹配到指定值时,会使用默认样式
    // 因为该数据的几何类型为区,因此设置区样式
    defaultSymbol:  new SimpleFillSymbol({
      // 填充颜色
      color: 'rgba(222,1,252,1)',
      // 线符号样式
      outline: new SimpleLineSymbol({
        //线符号颜色
        color: new Color(255, 1, 0, 1),
        //线宽
        width: 1
      })
    }),
    //分段专题图过滤条件数组
    classBreakInfos: [{
      // 最大过滤范围,field对应的值小于maxValue
      maxValue: "最大范围",
      // 最小过滤范围,field对应的值大于等于minValue
      minValue: "最小范围",
      // 匹配到该值后的样式
      // 因为该数据的几何类型为区,因此设置区样式
      symbol:  new SimpleFillSymbol({
        // 填充颜色
        color: 'rgba(1,1,252,1)',
        // 线符号样式
        outline: new SimpleLineSymbol({
          //线符号颜色
          color: new Color(255, 1, 0, 1),
          //线宽
          width: 1
        })
      })
    }]
  })

统一专题图

// ES5引入方式
const { IGSVectorTileLayer } = zondy.layer
const { SimpleRenderer } = zondy.renderer
const { SimpleFillSymbol,SimpleLineSymbol } = zondy.symbol
const { Color } = zondy
// ES6引入方式
import { IGSVectorTileLayer,SimpleRenderer ,SimpleFillSymbol,SimpleLineSymbol,Color} from "@mapgis/webclient-commo
const igsVectorTileLayer = new IGSVectorTileLayer({
  // 服务基地址
  url: 'http://{ip}:{port}/igs/rest/services/{serviceName}/VectorTileServer',
  // 设置子图层专题图
  sublayers: [{
    // 子图层id
    id: '子图层id',
    // 设置渲染样式-统一专题图
    renderer: new SimpleRenderer({
    // 因为该数据的几何类型为区，因此设置区样式
    symbol: new SimpleFillSymbol({
      // 填充颜色
      color: new zondy.Color(255, 0, 0),
      // 外边线样式
      outline: new SimpleLineSymbol({
        // 线颜色
        color: new Color(0, 0, 0),
        // 线宽度
        width: 1
      })
    })
  })
  }]
})

Extends

VectorTileLayer

Members

allSublayersCollectionFlattener.<SubLayer>

所有子图层的扁平化集合。

通过 CollectionFlattener 对 sublayers 做递归展开，便于按 id 查找和批量遍历。

clippingAreaPolygon Extent Circle MultiPolygon null

空间裁剪范围。

支持多多边形、多边形、矩形（Extent）、圆形等几何对象，用于在客户端按空间范围裁剪矢量瓦片显示范围。

currentStyleInfoObject

当前矢量瓦片样式元信息。

通常包含以下字段：serviceUrl、styleUrl、spriteUrl、glyphsUrl 以及内存中的 style 对象，便于在调试或序列化时恢复当前正在使用的 MVT 样式配置。

descriptionString

图层描述

Default Value:

descriptionString

图层描述

Default Value:

elevationInfoElevationInfo

高程模式参数。矢量瓦片图层仅支持 ElevationMode.onTheScene 和 ElevationMode.onTheGround。

labelsRenderModeString

矢量瓦片注记渲染模式。

仅在三维视图中生效：

on-screen：使用 Cesium 接口实时渲染注记；
off-screen：通过矢量瓦片在离屏 Canvas 中绘制注记。

请注意：模式切换会带来一定性能开销，在显卡较弱的环境中可能触发卡顿。

mvtExtentNumber

MVT 矢量瓦片相对坐标范围。

默认为 4096，表示矢量瓦片内部坐标从 0 到 4096。该值通常与服务端发布时设置的 extent 保持一致。

Default Value:

replaceStyleURLBoolean

初始化图层时，是否将样式中的基地址替换为图层的基地址

Default Value:

replaceStyleURLRegExpRegExp

当replaceStyleURL设置为true时，将样式中的基地址替换为图层的基地址操作中使用的正则表达式

sublayersCollection.<SubLayer> null

子图层列表对象。

子图层由服务端 mapinfo 与客户端配置合并生成；图层未加载完成时会暂存到 _clientSublayers。

tileDisplayStrategyTileDisplayStrategy

当视图比例尺超出瓦片数据自身级别范围时的显示策略。

由 TileDisplayStrategy 枚举定义，例如：

TileDisplayStrategy.hide：大于最大级别或小于最小级别时隐藏；
TileDisplayStrategy.stretch：大于最大级别时拉伸，小于最小级别时缩小。

tileInfoTileInfo null

瓦片切图信息。

该对象描述矢量瓦片的切片规则（级别范围、行列号范围、原点、分辨率等），通常由服务端元信息生成，也可以通过 options.tileInfo 传入自定义配置。

titleString

图层名称

typeLayerType

图层类型

Default Value:

urlString

矢量瓦片服务地址

Methods

clone(){IGSVectorTileLayer} document/layer/igserver/IGSVectorTileLayer.js, line 973

克隆对象

Returns:

Type	Description
IGSVectorTileLayer	IGS矢量瓦片对象

covertCustomStyleToMVTStyle(customStyle){Object} document/layer/igserver/IGSVectorTileLayer.js, line 622

将自定义的style转成矢量瓦片的mvtStyle，可有子类或初始化时自定义

Name	Type	Description
`customStyle`	Object	自定义的style

Returns:

Type	Description
Object	修改好的符合矢量瓦片规范的样式对象

inherited deleteStyleLayer(styleLayerId){void} document/layer/baseLayer/VectorTileLayer.js, line 535

删除样式图层。

成功删除后会通过地图对象触发一次 layer-update 事件（LayerEventType#layerUpdate），用于通知视图刷新。

Name	Type	Description
`styleLayerId`	String	样式图层 id

Returns:

Type	Description
void

inherited findSublayerById(sublayerID){SubLayer|null} document/layer/baseLayer/VectorTileLayer.js, line 1030

根据子图层id查询图层

Name	Type	Description
`sublayerID`	String	图层ID

Returns:

Type	Description
SubLayer \| null	子图层对象（未找到时返回 null）

Example

根据子图层id查询图层

// ES5引入方式
const { IGSVectorTileLayer } = zondy.layer

// ES6引入方式
import { IGSVectorTileLayer} from "@mapgis/webclient-common"
const igsVectorTileLayer = new IGSVectorTileLayer({
  // 服务基地址
  url: 'http://{ip}:{port}/igs/rest/services/{serviceName}/VectorTileServer'
});
map.add(igsVectorTileLayer);
// 根据id获取子图层
const subLayer = igsVectorTileLayer.findSublayerById('子图层id')

inherited getExtendProperties(styleLayerId, key){Any} document/layer/baseLayer/VectorTileLayer.js, line 714

获取样式图层的扩展属性（extendProperties）。

Name	Type	Description
`styleLayerId`	String	样式图层 id
`key`	String	扩展属性名

Returns:

Type	Description
Any	扩展属性值；未找到时返回 null。

inherited getLayoutProperties(styleLayerId){Object|null} document/layer/baseLayer/VectorTileLayer.js, line 646

获取样式图层布局属性（layout）。

layout 属性通常用于控制图层的布局、可见性、符号摆放等。

Name	Type	Description
`styleLayerId`	String	样式图层 id

Returns:

Type	Description
Object \| null	layout 对象；未找到时返回 null。

inherited getPaintProperties(styleLayerId){Object|null} document/layer/baseLayer/VectorTileLayer.js, line 602

获取样式图层绘制属性（paint）。

paint 属性通常用于控制颜色、透明度、线宽、填充等视觉渲染效果。

Name	Type	Description
`styleLayerId`	String	样式图层 id

Returns:

Type	Description
Object \| null	paint 对象；未找到时返回 null。

inherited getStyleLayer(styleLayerId){Object|null} document/layer/baseLayer/VectorTileLayer.js, line 433

通过矢量瓦片样式图层的 id 获取样式图层对象。

适用于对矢量瓦片样式进行精细化控制或调试，例如在调用 VectorTileLayer#setStyleLayer 前先获取当前图层样式。

注意：该方法依赖 VectorTileLayer#style 已存在且包含 layers 数组；通常需要先完成图层元信息/样式加载。

Name	Type	Description
`styleLayerId`	String	样式图层 id

Returns:

Type	Description
Object \| null	样式图层对象（Mapbox Style Layer），未找到时返回 null。

inherited getStyleLayerId(index){Object|null} document/layer/baseLayer/VectorTileLayer.js, line 471

通过矢量瓦片样式图层的序号获取样式图层对象。

注意：该方法依赖 VectorTileLayer#style 已存在。

Name	Type	Description
`index`	Number	样式图层序号（从 0 开始）

Returns:

Type	Description
Object \| null	样式图层对象（包含 `id` 字段）；越界时返回 null。

inherited getStyleLayerIndex(styleLayerId){Number} document/layer/baseLayer/VectorTileLayer.js, line 455

通过矢量瓦片样式图层的 id 获取其在 `style.layers` 中的序号。

注意：该方法依赖 VectorTileLayer#style 已存在。

Name	Type	Description
`styleLayerId`	String	样式图层 id

Returns:

Type	Description
Number	样式图层序号（从 0 开始）；未找到时返回 -1。

inherited getStyleLayerVisibility(styleLayerId){Boolean} document/layer/baseLayer/VectorTileLayer.js, line 586

获取样式图层可见性。

Name	Type	Description
`styleLayerId`	String	样式图层 id

Returns:

Type	Description
Boolean	是否可见。若未找到对应样式图层或 `layout` 不存在，默认返回 true。

inherited setExtendProperties(styleLayerId, key, value){void} document/layer/baseLayer/VectorTileLayer.js, line 690

设置样式图层的扩展属性（extendProperties）。

该接口用于在样式图层对象上挂载业务自定义字段，例如三维注记控制参数等。

注意：该方法仅更新内存中的样式对象，不会触发图层更新事件。

Name	Type	Description
`styleLayerId`	String	样式图层 id
`key`	String	扩展属性名
`value`	Any	扩展属性值

Returns:

Type	Description
void

inherited setLayoutProperties(styleLayerId, layout){void} document/layer/baseLayer/VectorTileLayer.js, line 664

设置样式图层布局属性（layout）。

该方法会将 layout 合并到现有 layout 对象中，并触发一次 layer-update 事件（LayerEventType#layerUpdate）。

Name	Type	Description
`styleLayerId`	String	样式图层 id
`layout`	Object	layout 配置（会与原 layout 合并）

Returns:

Type	Description
void

inherited setPaintProperties(styleLayerId, paint){void} document/layer/baseLayer/VectorTileLayer.js, line 620

设置样式图层绘制属性（paint）。

该方法会将 paint 合并到现有 paint 对象中，并触发一次 layer-update 事件（LayerEventType#layerUpdate）。

Name	Type	Description
`styleLayerId`	String	样式图层 id
`paint`	Object	paint 配置（会与原 paint 合并）

Returns:

Type	Description
void

inherited setStyleLayer(styleLayer, index){void} document/layer/baseLayer/VectorTileLayer.js, line 487

更新指定的样式图层对象。

该方法可用于：

替换指定 id 的样式图层；
通过传入 index 调整样式图层在 style.layers 中的顺序。

成功更新后会通过地图对象触发一次 layer-update 事件（LayerEventType#layerUpdate），用于通知视图刷新。

Name	Type	Description
`styleLayer`	Object	样式图层对象
`index`	Number	可选样式图层顺序（从 0 开始）。传入后会将图层移动到指定位置。

Returns:

Type	Description
void

inherited setStyleLayerVisibility(styleLayerId, visible){void} document/layer/baseLayer/VectorTileLayer.js, line 566

设置样式图层可见性。

底层通过更新 layout.visibility 实现：visible → 'visible'，false → 'none'。

该方法会触发 layer-update 事件（LayerEventType#layerUpdate）。

Name	Type	Description
`styleLayerId`	String	样式图层 id
`visible`	Boolean	是否可见

Returns:

Type	Description
void

toJSON(){Object}

document/layer/igserver/IGSVectorTileLayer.js, line 961

转换为 JSON 对象

Returns:

Type	Description
Object	JSON 对象

IGSVectorTileLayer.fromJSON(json){IGSVectorTileLayer} document/layer/igserver/IGSVectorTileLayer.js, line 953

通过传入的 JSON 构造并返回一个新的 IGSVectorTileLayer 对象

Name	Type	Description
`json`	Object	JSON 对象

Returns:

Type	Description
IGSVectorTileLayer	新的 IGSVectorTileLayer 对象

Class: IGSVectorTileLayer

new IGSVectorTileLayer(options)

支持如下方法：

Fires

Examples

Extends

Members

allSublayersCollectionFlattener.<SubLayer>

clippingAreaPolygon Extent Circle MultiPolygon null

currentStyleInfoObject

descriptionString

descriptionString

elevationInfoElevationInfo

labelsRenderModeString

mvtExtentNumber

replaceStyleURLBoolean

replaceStyleURLRegExpRegExp

sublayersCollection.<SubLayer> null

tileDisplayStrategyTileDisplayStrategy

tileInfoTileInfo null

titleString

typeLayerType

urlString

Methods

clone(){IGSVectorTileLayer}

Returns:

covertCustomStyleToMVTStyle(customStyle){Object}

Returns:

inherited deleteStyleLayer(styleLayerId){void}

Returns:

inherited findSublayerById(sublayerID){SubLayer|null}

Returns:

Example

inherited getExtendProperties(styleLayerId, key){Any}

Returns:

inherited getLayoutProperties(styleLayerId){Object|null}

Returns:

inherited getPaintProperties(styleLayerId){Object|null}

Returns:

inherited getStyleLayer(styleLayerId){Object|null}

Returns:

inherited getStyleLayerId(index){Object|null}

Returns:

inherited getStyleLayerIndex(styleLayerId){Number}

Returns:

inherited getStyleLayerVisibility(styleLayerId){Boolean}

Returns:

inherited setExtendProperties(styleLayerId, key, value){void}

Returns:

inherited setLayoutProperties(styleLayerId, layout){void}

Returns:

inherited setPaintProperties(styleLayerId, paint){void}

Returns:

inherited setStyleLayer(styleLayer, index){void}

Returns:

inherited setStyleLayerVisibility(styleLayerId, visible){void}

Returns:

toJSON(){Object}

Returns:

IGSVectorTileLayer.fromJSON(json){IGSVectorTileLayer}

Returns: