Mplan/opencloud
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
1e0da1fe36d1780120961acd341d730fc9408a2a
opencloud/.agents/skills/amap-jsapi-skill/references/api/layers-standard.md
T

421 lines
13 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## 行业标准图层
符合 OGC 标准或者行业通行规范的的图层类型
## WMS
**Extends TileLayer**
用于加载OGC标准的WMS地图服务的一种图层类，仅支持EPSG3857坐标系统的WMS图层。 </br>
[查看 WMS的OGC标准][53]。
### Parameters
- `opts` **WMSLayerOptions** 默认图层参数
- `opts.url` **String** wmts服务的url地址，如：'[https://services.arcgisonline.com/arcgis/rest/services/'+][54]
'Demographics/USA_Population_Density/MapServer/WMTS/'
- `opts.blend` **Boolean** 地图级别切换时，不同级别的图片是否进行混合，如图层的图像内容为部分透明请设置为false
- `opts.param` **Object** OGC标准的WMS地图服务的GetMap接口的参数，包括VERSION、LAYERS、STYLES、FORMAT、TRANSPARENT等， </br>
CRS、BBOX、REQUEST、WIDTH、HEIGHT等参数请勿添加，例如： </br>
{ </br>
LAYERS: 'topp:states', </br>
VERSION:'1.3.0', </br>
FORMAT:'image/png' </br>
}
- `opts.zooms` **\[Number, Number]** 支持的缩放级别范围，默认范围 [2-30] (optional, default `[2,30]`)
- `opts.opacity` **Number** 透明度，默认 1 (optional, default `1`)
- `opts.visible` **Boolean** 是否显示，默认 true (optional, default `true`)
- `opts.zIndex` **Number** 图层叠加的顺序值，1 表示最底层。默认 zIndex：4 (optional, default `4`)
### setParams
设置OGC标准的WMS getMap接口的参数，包括VERSION、LAYERS、STYLES、FORMAT、TRANSPARENT等
#### Parameters
- `params` **Object** 参数集合，{VERSION: '1.0', ...}
### getParams
获取 OGC 标准的 WMS getMap 接口的参数
### setUrl
设置 WMS 服务地址
#### Parameters
- `url` **String** 服务地址
### setUrl
设置 WMS 服务地址
#### Parameters
- `url` **String** 服务地址
### getOptions
获取图层参数信息
Returns **Object** 图层参数信息
### getzIndex
获取图层层级
Returns **Number** zIndex 图层层级
### setzIndex
设置图层层级，数字越大图层层级越高
#### Parameters
- `zIndex` **Number** 图层层级值
### getOpacity
获取图层透明度
Returns **Number** opacity 图层透明度
### setOpacity
设置图层透明度，范围 [0 ~ 1]
#### Parameters
- `opacity` **Number** 图层透明度
### getZooms
获取该图层可显示的级别范围，默认取值范围为[2-30]
Returns **\[Number, Number]** 缩放范围
### setZooms
获取该图层可显示的级别范围
#### Parameters
- `zooms` **\[Number, Number]** 缩放范围
### show
设置图层可见
### hide
设置图层隐藏
## WMTS
**Extends TileLayer**
用于加载 OGC 标准的 WMTS 地图服务的一种图层类，仅支持 EPSG3857 坐标系统的 WMTS 图层 </br>
[查看 WMTS 标准][55] </br>
[相关示例][56]
### Parameters
- `opts` **WMTSLayerOptions** 默认图层参数
- `opts.url` **String** wms服务的url地址，如'[https://ahocevar.com/geoserver/wms][57]'
- `opts.blend` **Boolean** 地图级别切换时，不同级别的图片是否进行混合，如图层的图像内容为部分透明请设置为false
- `opts.param` **Object** OGC标准的WMTS地图服务的GetTile接口的参数，包括Version、Layer、
Style、Format、Service等，TileMatrixSet、TileRow、TileCol、Request等参数请勿添加，例如： </br>
{ </br>
Layer: '0', </br>
Version:'1.0.0', </br>
Format: 'image/png' </br>
}
- `opts.zooms` **\[Number, Number]** 支持的缩放级别范围，默认范围 [2-30] (optional, default `[2,30]`)
- `opts.opacity` **Number** 透明度，默认 1 (optional, default `1`)
- `opts.visible` **Boolean** 是否显示，默认 true (optional, default `true`)
- `opts.zIndex` **Number** 图层叠加的顺序值，1 表示最底层。默认 zIndex：4 (optional, default `4`)
### setParams
设置 OGC 标准的 WMTS getTile接口的参数，包括Version、Layer、Style、Format、Service等
#### Parameters
- `params` **Object** 参数集合，{VERSION: '1.0', ...}
### getParams
获取 OGC 标准的 WMTS getMap 接口的参数
### getUrl
获取 WMTS 服务地址
Returns **String** 地址
### setUrl
设置 WMTS 服务地址
#### Parameters
- `url` **String** 服务地址
### getOptions
获取图层参数信息
Returns **Object** 图层参数信息
### getzIndex
获取图层层级
Returns **Number** zIndex 图层层级
### setzIndex
设置图层层级，数字越大图层层级越高
#### Parameters
- `zIndex` **Number** 图层层级值
### getOpacity
获取图层透明度
Returns **Number** opacity 图层透明度
### setOpacity
设置图层透明度，范围 [0 ~ 1]
#### Parameters
- `opacity` **Number** 图层透明度
### getZooms
获取该图层可显示的级别范围，默认取值范围为[2-30]
Returns **\[Number, Number]** 缩放范围
### setZooms
获取该图层可显示的级别范围
#### Parameters
- `zooms` **\[Number, Number]** 缩放范围
### show
设置图层可见
### hide
设置图层隐藏
## MapboxVectorTileLayer
**Extends Layer**
为了满足基于矢量瓦片块的数据可视化、矢量瓦片边界展示等开发需求，通过 AMap.MapboxVectorTileLayer 插件提供了简易矢量瓦片图层</br>
此图层可以使用标准的 MVT 瓦片服务作为数据源。</br>
可以配合[GeoHub-数据中心][58]发布的矢量瓦片服务。
注意：使用高德数据平台发布服务，由于服务 URL 地址是明文，建议自行做服务代理转发，防止服务 ID 和 Key 明文传输导致数据泄露。</br>
[相关示例][59]
### Parameters
- `opts` **MapboxVTLayerOptions** 图层初始化参数
- `opts.zIndex` **Number** 图层的层级 (optional, default `80`)
- `opts.opacity` **Number** 图层透明度 (optional, default `1`)
- `opts.url` **String?** MVT 数据的链接地址
- `opts.visible` **Boolean** 图层是否可见 (optional, default `true`)
- `opts.zooms` **\[number, number]** 图层缩放等级范围 (optional, default `[2,22]`)
- `opts.dataZooms` **\[number, number]** 瓦片数据等级范围，超过范围会使用最大/最小等级的数据 (optional, default `[2,18]`)
- `opts.styles` **MapboxVTLayerStyle**
- `opts.styles.polygon` **PolygonStyle?** 面类型的样式
- `opts.styles.polygon.sourceLayer` **String** 使用数据中的哪个图层，默认使用 default 图层 (optional, default `'default'`)
- `opts.styles.polygon.color` **(String \| Function)?** 面填充颜色
- `opts.styles.polygon.borderWidth` **(Number \| Function)?** 描边宽度
- `opts.styles.polygon.dash` **(Array&lt;Number> | Function)?** 描边线的虚线配置，例如：[10,5,8,5]
- `opts.styles.polygon.borderColor` **(String \| Function)?** 描边颜色
- `opts.styles.polygon.injection` **Array&lt;Any>?** 其他属性值中对于函数形式的值，假如需要获取外部变量，要使用数组的形式传入，便于在函数内部访问外部变量。请看下面的示例。
- `opts.styles.polygon.visible` **(Boolean \| Function)?** 是否显示
- `opts.styles.line` **LineStyle?** 线类型数据的样式
- `opts.styles.line.sourceLayer` **String** 使用数据中的哪个图层，默认使用 default 图层 (optional, default `'default'`)
- `opts.styles.line.color` **(String \| Function)?** 线填充颜色
- `opts.styles.line.lineWidth` **(Number \| Function)?** 宽度
- `opts.styles.line.dash` **(String \| Function)?** 虚线配置，例如：[10,5,8,5]
- `opts.styles.line.injection` **Array&lt;Any>?** 其他属性值中对于函数形式的值，假如需要获取外部变量，要使用数组的形式传入，便于在函数内部访问外部变量。请看下面的示例。
- `opts.styles.line.visible` **(Boolean \| Function)?** 是否显示
- `opts.styles.point` **PointStyle?** 点类型数据的样式
- `opts.styles.point.sourceLayer` **String** 使用数据中的哪个图层，默认使用 default 图层 (optional, default `'default'`)
- `opts.styles.point.radius` **(String \| Function)?** 圆点的半径，单位像素
- `opts.styles.point.color` **(Number \| Function)?** 圆的填充颜色
- `opts.styles.point.borderWidth` **(String \| Function)?** 描边的宽度
- `opts.styles.point.borderColor` **(String \| Function)?** 描边的颜色
- `opts.styles.point.injection` **Array&lt;Any>?** 其他属性值中对于函数形式的值，假如需要获取外部变量，要使用数组的形式传入，便于在函数内部访问外部变量。请看下面的示例。
- `opts.styles.point.visible` **(Boolean \| Function)?** 是否显示
- `opts.styles.polyhedron` **PolyhedronStyle?** 多面体类型的样式
- `opts.styles.polyhedron.sourceLayer` **String** 使用数据中的哪个图层，默认使用 default 图层 (optional, default `'default'`)
- `opts.styles.polyhedron.topColor` **(String \| Function)?** 顶面颜色
- `opts.styles.polyhedron.sideColor` **(String \| Function)?** 侧面颜色
- `opts.styles.polyhedron.texture` **(String \| Function)?** 侧面纹理，优先级高于侧面颜色
- `opts.styles.polyhedron.injection` **Array&lt;Any>?** 其他属性值中对于函数形式的值，假如需要获取外部变量，要使用数组的形式传入，便于在函数内部访问外部变量。请看下面的示例。
- `opts.styles.polyhedron.visible` **(Boolean \| Function)?** 是否显示
### Examples
```javascript
var globalVar = ['这是', '一个', '外部', '变量'];
var mvtl = new AMap.MapboxVectorTileLayer({
zIndex: 150,
opacity: 1,
// URL可以使用数据服务平台的服务，也可以使用自己发布的 MVT 数据服务
url: 'https://restapi.amap.com/rest/lbs/geohub/tiles/mvt?z=[z]&x=[x]&y=[y]&size=512&key=您申请的key值&id=数据服务ID',
dataZooms: [2, 18],
zooms: [2, 20],
tileSize: 256,
styles: {
point: {
sourceLayer: 'default',
visible: function (f, inject) {
// 这里的 inject 参数就是一个数组，他的值就是 injection 字段的数组值：[visis]。
return inject[0].indexOf('这是') > -1;
},
injection: [globalVar],
radius: function (props) {
return Math.random() * 20 + 5;
},
color: 'red',
borderWidth: 20 || function (props) {
return Math.random() * 5 + 2;
},
borderColor: 'rgba(255,255,255,1)',
},
polygon: {
sourceLayer: 'default',
color: function (props) {
return 'rgba(0,0,0,1)';
},
dash: [10, 0, 10, 0],
borderColor: 'rgba(30,112,255,1)',
borderWidth: 5,
},
line: {
sourceLayer: 'default',
color: 'rgba(20,140,40,1)',
lineWidth: 5,
dash: [10, 0, 10, 0],
},
polyhedron: {
sourceLayer: 'default',
topColor: 'rgba(230,230,230,0.9)',
sideColor: 'rgba(240,240,240,0.9)',
},
}
});
```
### setStyles
设置样式信息
#### Parameters
- `styles` **MapboxVTLayerStyle** 样式信息
### filterByRect
获取矩形范围的要素
#### Parameters
- `rect` **Polygon** 多边型，例如：\[[lng,lat],[lng,lat],[lng,lat],[lng,lat],[lng,lat]]
- `type` **String** 想要获取的要素类型，默认选择所有：all。可选值：all、point、polygon、line (optional, default `"all"`)
Returns **Array&lt;Feature>**
### getStyles
获取样式信息
Returns **MapboxVTLayerStyle** 样式
### on
图层级别监听鼠标事件
获取当前图层中鼠标位置的要素
#### Parameters
- `type` **String** 监听事件类型，目前支持 click、mousemove
- `fn` **Function** 监听的回调函数，参数中的 features 是获取的鼠标位置的要素
- `option` **Object** 拾取参数，featType：代表需要拾取的要素类型，参考 filterByRect() 函数中的 type；buffer：5, 代表以鼠标为中心点，范围为 5 的方形区域为鼠标拾取范围。值越大，拾取的范围越大，建议使用默认值。
### hide
设置图层隐藏
### hide
设置图层隐藏
### getOptions
获取图层参数信息
Returns **object** 图层参数信息
### getzIndex
获取图层层级
Returns **Number** zIndex 图层层级
### setzIndex
设置图层层级，数字越大图层层级越高
#### Parameters
- `zIndex` **Number** 图层层级值
### getOpacity
获取图层透明度
Returns **Number** opacity 图层透明度
### setOpacity
设置图层透明度，范围 [0 ~ 1]
#### Parameters
- `opacity` **Number** 图层透明度
### getZooms
获取该图层可显示的级别范围，默认取值范围为[2-20]
Returns **\[number, number]** 缩放范围
### setZooms
获取该图层可显示的级别范围
#### Parameters
- `zooms` **\[number, number]** 缩放范围
### show
设置图层可见
Reference in New Issue View Git Blame Copy Permalink