new WebMap(id, options, mapOptions)

Usage

// 浏览器
<script type="text/javascript" src="https://iclient.supermap.io/dist/mapboxgl/iclient-mapboxgl.js"></script>
<script>
  new mapboxgl.supermap.WebMap(id, options, mapOptions);
  
</script>

// ES6 Import
import { WebMap } from '@supermapgis/iclient-mapboxgl';

new WebMap(id, options, mapOptions);

mapboxgl/mapping/WebMap.js, line 16

Name Type Description

id

number

iPortal|Online 地图 ID。

options

Object

基础参数。

Name	Type	Default	Description
`target`	string	'map'	可选地图容器 ID。
`server`	string	"https://www.supermapol.com"	可选地图的地址。当设置 `id` 时有效。
`credentialKey`	string		可选凭证密钥。当设置 `id` 时有效。
`credentialValue`	string		可选凭证值。当设置 `id` 时有效。
`tiandituKey`	string		可选用于访问天地图的服务。当设置 `id` 时有效。
`googleMapsAPIKey`	string		可选用于访问谷歌地图。当设置 `id` 时有效。
`googleMapsLanguage`	string		可选用于定义在谷歌地图图块上显示标签的语言。当设置 `id` 且底图为谷歌地图时有效。
`withCredentials`	boolean	false	可选请求是否携带 cookie。当设置 `id` 时有效。
`excludePortalProxyUrl`	boolean		可选 server 传递过来的 URL 是否带有代理。当设置 `id` 时有效。
`ignoreBaseProjection`	boolean	false	可选是否忽略底图坐标系和叠加图层坐标系不一致。
`isSuperMapOnline`	boolean		可选是否是 SuperMap Online 地图。
`iportalServiceProxyUrlPrefix`	string		可选 iportal的代理服务地址前缀。
`proxy`	string \| boolean		可选 HTTP 请求代理地址。布尔值表示使用 iPortal 默认代理地址。

mapOptions

Object

地图参数。

Name	Type	Description
`center`	Array	可选中心点。
`zoom`	number	可选缩放级别。
`bearing`	number	可选旋转角度。
`pitch`	number	可选倾角。
`crs`	string \| Object	可选投影。
`renderWorldCopies`	boolean	可选连续渲染。
`rasterTileSize`	number	可选栅格瓦片大小。
`style`	Object	可选 style 样式。

Version:

9.1.2

Fires

Extends

WebMapBase

Events

inherited deprecated addlayerssucceeded common/mapping/WebMapBase.js, line 102

地图创建成功。自v11.2.1废弃，请使用WebMapBase#event:mapcreatesucceeded替代。

Properties:

Name	Type	Description
`map`	Object	MapBoxGL Map 实例。
`mapparams`	Object	地图信息。
`mapParams.title`	string	地图标题。
`mapParams.description`	string	地图描述。
`layers`	Aarry	图层列表。

inherited baidumapnotsupport common/mapping/WebMapBase.js, line 143

不支持百度地图。

inherited dataflowfeatureupdated common/mapping/WebMapBase.js, line 153

数据流图层要素更新。

inherited deprecated getlayersfailed common/mapping/WebMapBase.js, line 134

图层创建失败。自v11.2.1废弃，请使用WebMapBase#event:layercreatefailed替代。

Properties:

Name	Type	Description
`error`	Object	失败原因。
`map`	Object	MapBoxGL Map 实例。
`layer`	Object	图层信息。

inherited deprecated getmapfailed common/mapping/WebMapBase.js, line 119

地图创建失败。自v11.2.1废弃，请使用WebMapBase#event:mapcreatefailed替代。

Properties:

Name	Type	Description
`error`	Object	失败原因。

inherited layercreatefailed common/mapping/WebMapBase.js, line 126

图层创建失败。

Properties:

Name	Type	Description
`error`	Object	失败原因。
`map`	Object	MapBoxGL Map 实例。
`layer`	Object	图层信息。

inherited layerorsourcenameduplicated common/mapping/WebMapBase.js, line 148

图层名或数据源名重复。

inherited mapbeforeremove common/mapping/WebMapBase.js, line 165

地图销毁前。

inherited mapcreatefailed common/mapping/WebMapBase.js, line 113

地图创建失败。

Properties:

Name	Type	Description
`error`	Object	失败原因。

inherited mapcreatesucceeded common/mapping/WebMapBase.js, line 92

地图创建成功。

Properties:

Name	Type	Description
`map`	Object	MapBoxGL Map 实例。
`mapparams`	Object	地图信息。
`mapParams.title`	string	地图标题。
`mapParams.description`	string	地图描述。
`layers`	Aarry	图层列表。

inherited mapinitialized common/mapping/WebMapBase.js, line 86

地图初始化成功。

Properties:

Name	Type	Description
`map`	Object	MapBoxGL Map 实例。

inherited projectionnotmatch common/mapping/WebMapBase.js, line 158

底图投影与底图投影不匹配。

Methods

inherited clean(removeMap) common/mapping/WebMapBase.js, line 466

删除地图或者清空地图上的图层和事件。

Name	Type	Default	Description
`removeMap`	boolean	true	可选是否删除地图。false 表示只清空地图上的图层和事件。

Version:

11.2.1

inherited cleanLayers() common/mapping/WebMapBase.js, line 487

删除追加的图层和事件。当设置 map 时有效

Version:

11.2.1

inherited copyLayer(id, layerInfo){Array} common/mapping/WebMapBase.js, line 454

复制指定图层。

Name	Type	Description
`id`	string	指定图层 id。
`layerInfo`	Object	可选复制图层信息。如 id、source、layout

Version:

11.2.1

Returns:

Type	Description
Array	复制成功的信图层信息。

inherited getLayerCatalog(){Array} common/mapping/WebMapBase.js, line 394

获取图层组。

Version:

11.2.1

Returns:

Type	Description
Array	图层组。

inherited getLayers(){Array} common/mapping/WebMapBase.js, line 374

获取图层。

Version:

11.2.1

Returns:

Type	Description
Array	图层。

inherited getLegends(){Array} common/mapping/WebMapBase.js, line 384

获取图例。

Version:

11.2.1

Returns:

Type	Description
Array	图例。

inherited getWebMapType(){String} common/mapping/WebMapBase.js, line 419

获取地图类型。

Version:

11.2.1

Returns:

Type	Description
String	地图类型。

inherited rectifyLayersOrder(layers, topLayerBeforeId) common/mapping/WebMapBase.js, line 429

根据已知顺序的可感知图层，对地图上图顺序进行排序。

Name	Type	Description
`layers`	Array	图层列表。
`topLayerBeforeId`	string	图层列表中置顶图层指定的 beforeId。

Version:

11.2.1

inherited resize(keepBounds) common/mapping/WebMapBase.js, line 178

调整地图大小。

Name	Type	Default	Description
`keepBounds`	boolean	false	可选是否保持当前地图范围。

inherited setBearing(pitch) common/mapping/WebMapBase.js, line 250

更新地图旋转角度。

Name	Type	Description
`pitch`	number	地图旋转角度。

inherited setCenter(center) common/mapping/WebMapBase.js, line 223

更新地图中心点。

Name	Type	Description
`center`	Array	地图中心点。

inherited setCRS(crs) common/mapping/WebMapBase.js, line 196

更新地图投影。

Name	Type	Description
`crs`	string \| Object	地图 crs。

inherited deprecated setMapOptions(mapOptions) common/mapping/WebMapBase.js, line 356

设置 map 参数。

Name	Type	Description
`mapOptions`	Object	map 参数。

inherited setMaxBounds(maxBounds) common/mapping/WebMapBase.js, line 307

更新地图 maxbounds。

Name	Type	Description
`maxBounds`	number	地图最大缩放范围。

inherited setMaxZoom(maxZoom) common/mapping/WebMapBase.js, line 332

更新地图 maxzoom。

Name	Type	Description
`maxZoom`	number	地图最大缩放级别。

Version:

11.2.1

inherited setMinZoom(minZoom) common/mapping/WebMapBase.js, line 319

更新地图 minzoom。

Name	Type	Description
`minZoom`	number	地图最小缩放级别。

Version:

11.2.1

inherited setPitch(pitch) common/mapping/WebMapBase.js, line 264

更新地图倾角。

Name	Type	Description
`pitch`	number	地图倾角。

inherited setRasterTileSize(tileSize) common/mapping/WebMapBase.js, line 290

更新地图栅格图层瓦片大小。

Name	Type	Description
`tileSize`	number	栅格瓦片大小。

inherited setRenderWorldCopies(isWorldCopy) common/mapping/WebMapBase.js, line 238

更新地图连续渲染。

Name	Type	Description
`isWorldCopy`	boolean	地图是否连续渲染。

inherited setStyle(style) common/mapping/WebMapBase.js, line 278

更新地图样式。

Name	Type	Description
`style`	Object	地图 style 样式

inherited deprecated setWebMapOptions(webMapOptions) common/mapping/WebMapBase.js, line 345

设置 webMap 参数。

Name	Type	Description
`webMapOptions`	Object	webMap 参数。

inherited toggleLayerVisible(layer, visible) common/mapping/WebMapBase.js, line 408

设置图层显隐。

Name	Type	Description
`layer`	string	图层信息。
`visible`	boolean	图层是否可见。true 表示显示，false 表示隐藏。

Version:

11.2.1

inherited updateOverlayLayer(layerInfo, features, mergeByField) common/mapping/WebMapBase.js, line 440

更新 geojson 图层要素信息。

Name Type Description

layerInfo

Object

图层信息。

Name	Type	Description
`id`	string	可选图层信息 id。
`renderSource`	string	可选图层渲染 source 信息。

features

Array

要素信息。

mergeByField

string

属性关联字段。

Version:

11.2.1

Class: WebMap

new WebMap(id, options, mapOptions)

Usage

Fires

Extends

Events

inherited deprecated addlayerssucceeded

Properties:

inherited baidumapnotsupport

inherited dataflowfeatureupdated

inherited deprecated getlayersfailed

Properties:

inherited deprecated getmapfailed

Properties:

inherited layercreatefailed

Properties:

inherited layerorsourcenameduplicated

inherited mapbeforeremove

inherited mapcreatefailed

Properties:

inherited mapcreatesucceeded

Properties:

inherited mapinitialized

Properties:

inherited projectionnotmatch

Methods

inherited clean(removeMap)

inherited cleanLayers()

inherited copyLayer(id, layerInfo){Array}

Returns:

inherited getLayerCatalog(){Array}

Returns:

inherited getLayers(){Array}

Returns:

inherited getLegends(){Array}

Returns:

inherited getWebMapType(){String}

Returns:

inherited rectifyLayersOrder(layers, topLayerBeforeId)

inherited resize(keepBounds)

inherited setBearing(pitch)

inherited setCenter(center)

inherited setCRS(crs)

inherited deprecated setMapOptions(mapOptions)

inherited setMaxBounds(maxBounds)

inherited setMaxZoom(maxZoom)

inherited setMinZoom(minZoom)

inherited setPitch(pitch)

inherited setRasterTileSize(tileSize)

inherited setRenderWorldCopies(isWorldCopy)

inherited setStyle(style)

inherited deprecated setWebMapOptions(webMapOptions)

inherited toggleLayerVisible(layer, visible)

inherited updateOverlayLayer(layerInfo, features, mergeByField)