# new IGSMapImageLayer(url, options)
地图图片图层(Leaflet)
参数:
名称 | 类型 | 默认值 | 描述 |
---|---|---|---|
url |
String | 服务基地址 |
|
options |
Object | 额外构造参数 |
|
layers |
String | 要显示的子图层 |
|
id |
String | 图层id |
|
clientId |
String | 客户端id,用户的唯一标识;在地图服务中,调用接口时如果修改了地图的状态,包括设置动态投影、设置图层显示隐藏等,为了提升并发性能,服务端会根据clientId来生成临时地图,最佳做法是一个浏览器生成一个固定的唯一值;建议普通用户不要传该参数,webclient会根据当前浏览器生成一个固定的唯一值 |
|
imageWidth |
Number | 256 | 瓦片宽度,仅当renderMode为'tile'时生效 |
imageHeight |
Number | 256 | 瓦片高度,仅当renderMode为'tile'时生效 |
imageFormat |
String | 'image/jpeg' | 瓦片格式 |
opacity |
Number | 1 | 图层透明度 |
visible |
Boolean | true | 图层显示或隐藏 |
imageTransparent |
Boolean | true | 图层背景是否可以透明 |
bounds |
L.latLngBounds | 地图显示范围 |
|
igsVersion |
String | igs版本号 |
|
tokenKey |
String | token名 |
|
tokenValue |
String | token值 |
|
tokenAttachType |
Boolean | false | 当请求类型为POST时,是否将token设置在请求体中 |
filters |
String | 子图层过滤条件 |
|
httpMethod |
FetchMethod | FetchMethod.get | 数据请求方式 |
clippingArea |
Object | 图层裁剪对象 |
|
mapServer |
MapServer | 服务库对象 |
|
projectionSrs |
Boolean | false | 是否开启IGS2.0动态投影 |
isAntialiasing |
Boolean | false | 返回的图片时,是否开启服务端抗锯齿功能;启用抗锯齿功能后,显示效果会更清晰,但会导致出图速度变慢,true表示开启抗锯齿,false表示关闭抗锯齿,如果没有设置,则默认应用地图文档(MapX)上的设置参数 |
renderMode |
String | 'tile' | 影像的展现形式。可选'tile' 、 'image'。默认为'tile',加载影像时以瓦片的方式平铺。当选项为'image'时,加载影像会请求一张覆盖当前屏幕的图像。 |
示例
// ES5引入方式
const { IGSMapImageLayer } = zondy.Layer
const { initializeCRS, initializeOptions } = zondy.leaflet
// ES6引入方式
import { IGSMapImageLayer } from "@mapgis/webclient-common"
import "@mapgis/webclient-leaflet-plugin"
const { initializeCRS, initializeOptions } = zondy.leaflet
// 构造一个IGSMapImageLayer图层对象
const layer = new IGSMapImageLayer({
// 服务基地址
url: "http://{ip}:{port}/igs/rest/services/{服务名}/MapServer"
});
// 加载图层元数据
layer.load().then(function () {
// 构造地图视图的初始化参数
const crs = initializeCRS(layer)
const mapViewOptions = {
// 地图视图参考系
crs: crs,
// 初始化中心点
center: [31.147781205532336,112.21905099757561],
// 初始化级数
zoom: 2
}
// 构造Leaflet地图视图对象
const map = L.map('地图视图容器ID', mapViewOptions)
// 构造图层的初始化参数
const layerOptions = initializeOptions(layer)
// 添加图层到地图视图中
new zondy.leaflet.IGSMapImageLayer(layer.url, layerOptions).addTo(map)
})