7
7
* @namespace
8
8
* @category Visualization WebSymbol
9
9
* @description
10
- * **SuperMap iClient for MapboxGL 支持 Web 符号库,扩展了 [Map ](https://docs.mapbox.com/mapbox-gl-js/api/map /) 的 API。**
10
+ * **SuperMap iClient for MapboxGL 支持 Web 符号库,扩展了 [Mapbox ](https://docs.mapbox.com/mapbox-gl-js/api/) 的 API。**
11
11
*
12
12
* ## 新增 API
13
- * ## Map.loadSymbol
13
+ * ## mapboxgl. Map.prototype .loadSymbol
14
14
* 加载预定义符号。
15
15
*
16
16
* 参数名称 |类型 |描述
17
17
* :---- |:--- |:---
18
18
* id |string |[预定义符号ID]()
19
- * callback |function |在符号加载完成后调用,如果有错误,则带错误参数
19
+ * callback |function |在符号加载完成后调用,返回符号信息; 如果有错误,则返回错误参数。
20
20
*
21
+ * **Example**
21
22
* ```
22
23
* map.loadSymbol('point-1', (error, symbol) => {
23
24
* if (error) throw error;
27
28
* ```
28
29
*
29
30
*
30
- * ## Map.addSymbol
31
- * 在样式中添加一个符号 。该符号可以显示在地图上。符号 ID 用于 layer.symbol 。
31
+ * ## mapboxgl. Map.prototype .addSymbol
32
+ * 添加一个符号 。该符号可以显示在地图上。Mapbox layers 的 symbol属性可以使用该符号ID 。
32
33
*
33
- * 参数名称 |类型 |描述
34
- * :---- |:--- |:---
35
- * id |string |符号ID
36
- * symbol |object |由[Mapbox Layers](https://docs.mapbox.com/mapbox-gl-js/style-spec/layers/)中的paint、layout组成的符号对象
34
+ * |参数名称 |类型 |描述 | ||
35
+ * |---- |--- |--- |---|---|
36
+ * |id |string |符号ID |||
37
+ * |symbol |object |由Mapbox Layers中的[paint](https://docs.mapbox.com/mapbox-gl-js/style-spec/layers/#paint-property)、[layout](https://docs.mapbox.com/mapbox-gl-js/style-spec/layers/#layout-property)组成的符号对象|||
38
+ * | | |参数名称 |类型 |描述 |
39
+ * | | |paint |object |Mapbox Layers [paint](https://docs.mapbox.com/mapbox-gl-js/style-spec/layers/#paint-property)|
40
+ * | | |layout |object |Mapbox Layers [layout](https://docs.mapbox.com/mapbox-gl-js/style-spec/layers/#layout-property)|
37
41
*
42
+ * **Example**
38
43
* ```
39
44
* map.addSymbol('point-1', symbol);
40
45
* ```
41
46
*
42
47
*
43
- * ## Map.setSymbol
48
+ * ## mapboxgl. Map.prototype .setSymbol
44
49
* 给指定图层设置符号。
45
50
*
46
51
* 参数名称 |类型 |描述
47
52
* :---- |:--- |:---
48
53
* layerId |string |图层ID
49
- * symbolId |string |已经添加的符号ID
54
+ * symbolId |string |已经添加的符号ID(addSymbol中的符号ID)
50
55
*
56
+ * **Example**
51
57
* ```
52
58
* map.setSymbol("symbol", 'point-1');
53
59
* ```
54
60
*
55
61
*
56
- * ## Map.hasSymbol
57
- * 检查样式中是否存在具有特定 ID 的符号.
62
+ * ## mapboxgl. Map.prototype .hasSymbol
63
+ * 检查是否存在特定 ID 的符号。
58
64
*
59
65
* 参数名称 |类型 |描述
60
66
* :---- |:--- |:---
61
67
* symbolId |string |符号ID
62
68
*
69
+ * **Example**
63
70
* ```
64
71
* const pointExists = map.hasSymbol('point-1');
65
72
* ```
66
73
*
67
74
*
68
- * ## Map.removeSymbol
69
- * 从样式中删除符号 。
75
+ * ## mapboxgl. Map.prototype .removeSymbol
76
+ * 删除符号 。
70
77
*
71
78
* 参数名称 |类型 |描述
72
79
* :---- |:--- |:---
73
80
* symbolId |string |已经添加的符号ID
74
81
*
82
+ * **Example**
75
83
* ```
76
84
* map.removeSymbol('point-1');
77
85
* ```
78
86
*
79
87
*
80
- * ## 扩展 API
81
- *
82
- * ## [Map.addLayer](https://docs.mapbox.com/mapbox-gl-js/api/map/#map#addlayer)
83
- * 添加图层。
84
- *
85
- * 扩展参数名称 |类型 |描述
86
- * :---- |:--- |:---
87
- * layer |[Mapbox Layers](https://docs.mapbox.com/mapbox-gl-js/style-spec/layers/) |layer 图层, 新增了symbol属性
88
+ * ## 扩展 [Mapbox Layers](https://docs.mapbox.com/mapbox-gl-js/style-spec/layers/)
89
+ * 在[Mapbox Layers](https://docs.mapbox.com/mapbox-gl-js/style-spec/layers/) 属性的基础上新增了symbol 属性, 指定符号ID。
88
90
*
91
+ * **Example**
89
92
* ```
90
93
* map.addLayer({
91
94
* id: "symbol",
92
- * source: "xx ",
95
+ * source: "sourceId ",
93
96
* type: "symbol",
94
97
* symbol: 'point-1'
95
98
* });
96
99
* ```
97
- *
98
- *
99
- * ## [Map.setStyle](https://docs.mapbox.com/mapbox-gl-js/api/map/#map#setstyle)
100
- * 用新值更新地图的 Mapbox 样式对象。
101
- *
102
- * 扩展参数名称 |类型 |描述
103
- * :---- |:--- |:---
104
- * style | [Mapbox Style](https://docs.mapbox.com/mapbox-gl-js/style-spec/) |样式, 其中layer 图层, 新增了symbol属性
105
- *
106
100
* ```
107
101
* map.setStyle({
108
102
* version: 8,
109
103
* sources: {},
110
104
* layers: [{
111
105
* id: "symbol",
112
- * source: "xx ",
106
+ * source: "sourceId ",
113
107
* type: "symbol",
114
108
* symbol: 'point-1'
115
109
* }]
116
110
* })
117
111
* ```
118
- *
119
112
*/
0 commit comments