SuperMap iClient3D for WebGL 多源数据加载篇—常用汇总
橙晚 2024-10-12 09:33:01 阅读 85
目录
前言一、地形1.1、SuperMap iServer地形（1）单独加地形（2）通过scene.open加载
1.2、stk全球地形服务
二、二维底图2.1、第三方在线地图服务2.1.1、天地图2.1.2、BingMap2.1.3、谷歌2.1.3、高德2.1.4、Arcgis方式一：通过ArcGisMapServerImageryProvideri接口，但不支持CGCS2000坐标系方式二：通过CGCS2000MapServerImageryProvideri接口，支持CGCS2000、WGS84、全球墨卡托等坐标系方式三：通过WebMapTileServiceImageryProvider接口，构造WMTS地址
2.2、本地图片2.3、OGC标准地图服务2.3.1、WMS2.3.2、WMTS
2.4、SuperMap rest地图2.5、SuperMap 三维地图瓦片2.5.1、单独加载2.5.2、通过scene.open加载
三、S3M图层3.1、单独加载3.2、通过scene.open加载
四、MVT五、场景加载六、实体6.1、Primitive6.2、dataSource6.3、entity
七、地质体
前言
最近小编整理了SuperMap iClient3D for WebGL常见的多源数据加载方式和示例代码，供大家参考。本文章适用于稍微有基础的同学。
如有遗漏，欢迎大家补充。
一、地形
1.1、SuperMap iServer地形
地形服务生产：
数据生成TIN或者DEM缓存后。可加载到场景中，保存工作空间，然后发布iServer。也可直接发布sct配置文件，数据来源选择三维切片缓存，服务类型选择REST-三维服务。
详细可参考博客：https://www.jianshu.com/p/8df809ee93cb
地形服务使用：
详细可参考博客：https://blog.csdn.net/supermapsupport/article/details/89448119
（1）单独加地形
注意：地形服务源自SuperMap iServer发布时需设置isSct为true
使用接口：<code>CesiumTerrainProvider
示例代码：
var viewer = new Cesium.Viewer('cesiumContainer',{
terrainProvider:new Cesium.CesiumTerrainProvider({
url:'http://localhost:8090/iserver/services/3D-SiChuanDiXingYingXiang/rest/realspace/datas/DatasetDEM',
invisibility:true
isSct : true//地形服务源自SuperMap iServer发布时需设置isSct为true
})
});
（2）通过scene.open加载
通过scene.open打开可直接查看到地形效果，该效果只限于将地形保存于工作空间发布iServer的情况。
1.2、stk全球地形服务
由于国外的stk服务地址（//assets.agi.com/stk-terrain/world）有时候访问慢或直接访问不到，所以我们使用SuperMap iServer进行了一次转发，效果和stk一样。
使用接口：CesiumTerrainProvider
示例代码：
var terrainProvider= new Cesium.CesiumTerrainProvider({
url : "https://www.supermapol.com/realspace/services/3D-stk_terrain/rest/realspace/datas/info/data/path",
requestWaterMask : true,//开启法向量
requestVertexNormals : true,//开启水面特效
isSct: false
})
viewer.terrainProvider=terrainProvider;
二、二维底图
2.1、第三方在线地图服务
2.1.1、天地图
接口：TiandituImageryProvider
示例代码：
//初始化天地图全球中文注记服务，并添加至影像图层
var labelImagery = new Cesium.TiandituImageryProvider({
mapStyle: Cesium.TiandituMapsStyle.CIA_C, //天地图全球中文注记服务（经纬度投影），如果不加这行代码默认就是使用IMG_W墨卡托投影全球影像底图
token: "10a5ea344938a74c3b311e9351a20490"
});
viewer.imageryLayers.addImageryProvider(labelImagery);
2.1.2、BingMap
接口：BingMapsImageryProvider
示例代码：
viewer.imageryLayers.addImageryProvider(new Cesium.BingMapsImageryProvider({
key : URL_CONFIG.BING_MAP_KEY,//可至官网（https://www.bingmapsportal.com/）申请key
url : URL_CONFIG.BINGMAP
}));
2.1.3、谷歌
接口：UrlTemplateImageryProvider
示例代码：
var GG = new Cesium.UrlTemplateImageryProvider({
url: 'http://mt1.google.cn/vt/lyrs=s&hl=zh-CN&x={x}&y={y}&z={z}&s=Gali',
tilingScheme:new Cesium.WebMercatorTilingScheme(),
subdomains: '1234',
});
viewer.imageryLayers.addImageryProvider(GG );
2.1.3、高德
接口：UrlTemplateImageryProvider
示例代码：
var GD = new Cesium.UrlTemplateImageryProvider({
url: 'https://webst0{s}.is.autonavi.com/appmaptile?style=6&x={x}&y={y}&z={z}',
tilingScheme:new Cesium.WebMercatorTilingScheme(),
subdomains: '1234',
});
viewer.imageryLayers.addImageryProvider(GD);
2.1.4、Arcgis
方式一：通过ArcGisMapServerImageryProvideri接口，但不支持CGCS2000坐标系
var layer = viewer.imageryLayers.addImageryProvider(new SuperMap3D.ArcGisMapServerImageryProvider({
url: 'http://cache1.arcgisonline.cn/ArcGIS/rest/services/ChinaOnlineCommunity/MapServer'
}));
方式二：通过CGCS2000MapServerImageryProvideri接口，支持CGCS2000、WGS84、全球墨卡托等坐标系
var layer = viewer.imageryLayers.addImageryProvider(new SuperMap3D.CGCS2000MapServerImageryProvider({
url: 'http://cache1.arcgisonline.cn/arcgis/rest/services/ChinaOnlineStreetPurplishBlue/MapServer',
// suggest: true,//4490坐标系，按照suggest切片方案切的瓦片,需要设置该参数
// tilingScheme: new SuperMap3D.ArcGisGeographicTilingScheme({})
}));
viewer.flyTo(layer);
方式三：通过WebMapTileServiceImageryProvider接口，构造WMTS地址
var wmtsLayer = viewer.imageryLayers.addImageryProvider(new SuperMap3D.WebMapTileServiceImageryProvider({
url: 'http://cache1.arcgisonline.cn/arcgis/rest/services/ChinaOnlineStreetPurplishBlue/MapServer/WMTS',
layer: 'ChinaOnlineStreetPurplishBlue',
format: "image/jpgpng",
style: 'default',
tileMatrixSetID: "default028mm",
}));
viewer.flyTo(wmtsLayer);
2.2、本地图片
接口：SingleTileImageryProvider
示例代码：
//使用本地的一张图片初始化地球，建议图片长宽比2:1
viewer.imageryLayers.addImageryProvider(new SuperMap3D.SingleTileImageryProvider({
url: './images/worldimage.jpg'
}));
2.3、OGC标准地图服务
2.3.1、WMS
接口：WebMapServiceImageryProvider
示例代码：
var provider = new Cesium.WebMapServiceImageryProvider({
url : 'https://sampleserver1.arcgisonline.com/ArcGIS/services/Specialty/ESRI_StatesCitiesRivers_USA/MapServer/WMSServer',
layers : '0',
proxy: new Cesium.DefaultProxy('/proxy/')
});
viewer.imageryLayers.addImageryProvider(provider);
详细可参考博客：https://blog.csdn.net/supermapsupport/article/details/89472404
2.3.2、WMTS
接口：WebMapTileServiceImageryProvider
示例代码：
//添加天地图全球矢量标注服务(经纬度)
viewer.imageryLayers.addImageryProvider(new Cesium.WebMapTileServiceImageryProvider({
url: 'http://t0.tianditu.com/cia c/wmts?tk=1d109683f4d84198e37a38c442d68311',layer: 'cia ' ,
style: 'default',format: 'tiles ',
tileMatrixSetID: 'c',
tileMatrixLabels: matrixIds,
tilingScheme: new Cesium.GeographicTilingScheme({
numberOfLevelZeroTilesX: 2，
numberOfLevelZeroTilesY: 1
})
详细可参考博客：https://blog.csdn.net/supermapsupport/article/details/89471734
2.4、SuperMap rest地图
接口：SuperMapImageryProvider
示例代码：
//利用服务url创建SuperMapImageryProvider实例
var provider_mec = new Cesium.SuperMapImageryProvider({
url: 'http://localhost:8090/iserver/services/map-agscache-test318/rest/maps/test318'//墨卡托投影地图服务
});
//初始化时添加经纬度投影地图图层
viewer.imageryLayers.addImageryProvider(provider_mec);
2.5、SuperMap 三维地图瓦片
2.5.1、单独加载
对影像数据集或者地图右键生成三维缓存，然后在iServer发布，数据来源选择三维切片缓存，服务类型选择REST-三维服务。
接口：SuperMapImageryProvider
示例代码：
//利用服务url创建SuperMapImageryProvider实例
var provider_mec = new Cesium.SuperMapImageryProvider({
url: 'http://localhost:8090/iserver/services/3D-SanWeiGaoJiRenZhengShuJu/rest/realspace/datas/%E4%B8%AD%E5%B1%B1%E5%B8%82%E5%BD%B1%E5%83%8F'//墨卡托投影地图服务
});
viewer.imageryLayers.addImageryProvider(provider_mec);
2.5.2、通过scene.open加载
对影像数据集或者地图右键生成三维缓存，保存工作空间。然后在iServer发布工作空间，服务类型选择REST-三维服务。后期通过scene.open打开场景即可查看到场景中的三维影像缓存。
三、S3M图层
包括建模白模数据、城市精模数据、倾斜摄影三维模型、点云、BIM、三维点/线/面、三维场数据、三维网络数据等多源异构空间数据。
3.1、单独加载
接口：scene.addS3MTilesLayerByScp
示例代码：
scene.addS3MTilesLayerByScp("http://localhost:8090/iserver/services/3D-KongJianZuoBiaoGuanWang/rest/realspace/datas/SQCSPSQZ/config");
3.2、通过scene.open加载
将数据在SuperMap iDesktopX存入场景中，保存工作空间。然后在iServer发布工作空间，服务类型选择REST-三维服务。后期通过scene.open打开场景即可
四、MVT
数据生产：在SuperMap iDesktopX中将矢量地图生成遵循 MapBox MVT规范的矢量瓦片。
服务发布：服务来源选择：UGCV5（MVT瓦片）；服务类型选择：REST-矢量瓦片服务
接口： viewer.scene.addVectorTilesMap
示例代码：
var url = 'http://localhost:8090/iserver/services/map-mvt-Xian_GuangDong/restjsr/v1/vectortile/maps/%E5%8E%BF_%E5%B9%BF%E4%B8%9C';
mvtMap = viewer.scene.addVectorTilesMap({
url: url,
canvasWidth: 512,
name: 'testMVT',
viewer: viewer
});
五、场景加载
使用接口：scene.open
保存在场景中的地图，s3m图层，地形，影像都会被保存在场景中（除天地图等第三方在线底图和web数据源图层不能通过该方式添加）
六、实体
6.1、Primitive
Primitive偏底层，图形绘制和数据加载效率较高，但开发难度更大。
示例代码：
//加载3Dtiles数据
viewer.scene.primitives.add(new Cesium.Cesium3DTileset({
url: './data/little/tileset.json',
}));
6.2、dataSource
数据源是Cesium中用于加载和管理地理数据的组件。它可以处理多种格式的数据，包括GeoJSON、TopoJSON、KML和CZML。不同的文件类型只是为了不同方式的输入数据结构而已，本质上内部还是转换为Entity对象保存。
示例代码：
//加载kml文件
viewer.dataSources.add(Cesium.KmlDataSource.load('./SampleData/kml/model.kml', {
camera: scene.camera,
canvas: scene.canvas
}))
6.3、entity
在Cesium中，实体(Entity)是用来描述具有几何形状和属性的对象的基类。实体可以是点、线、面、模型等，它们可以包含额外的信息，如名称、描述和标签。实体在Cesium中非常有用，因为它们可以被轻松地添加、更新和删除，从而为场景添加丰富的交互性。
示例代码：
viewer.entities.add({
position: Cesium.Cartesian3.fromDegrees(parseFloat(selectedFeatures[i].fieldValues["12"]), parseFloat(selectedFeatures[i].fieldValues["13"]), parseFloat(selectedFeatures[i].fieldValues["16"])),
billboard: {
image: './images/location4.png',
width: 30,
height: 40,
},
name: selectedFeatures[i].fieldValues["11"],
description: des
});
七、地质体
数据生产：参考博客：https://blog.csdn.net/supermapsupport/article/details/122036528
服务发布：用原始的地质体模型在iServer发布数据服务。
示例代码：
var modelUrls = [
"http://www.supermapol.com/realspace/services/data-dizhiti/rest/data/datasources/%E5%9C%B0%E8%B4%A8%E4%BD%93/datasets/Layer1/features/1.stream",
"http://www.supermapol.com/realspace/services/data-dizhiti/rest/data/datasources/%E5%9C%B0%E8%B4%A8%E4%BD%93/datasets/Layer2/features/1.stream",
"http://www.supermapol.com/realspace/services/data-dizhiti/rest/data/datasources/%E5%9C%B0%E8%B4%A8%E4%BD%93/datasets/Layer3/features/1.stream",
"http://www.supermapol.com/realspace/services/data-dizhiti/rest/data/datasources/%E5%9C%B0%E8%B4%A8%E4%BD%93/datasets/Layer4/features/1.stream",
"http://www.supermapol.com/realspace/services/data-dizhiti/rest/data/datasources/%E5%9C%B0%E8%B4%A8%E4%BD%93/datasets/Layer5/features/1.stream",
"http://www.supermapol.com/realspace/services/data-dizhiti/rest/data/datasources/%E5%9C%B0%E8%B4%A8%E4%BD%93/datasets/Layer6/features/1.stream",
];
function showModel() {
var models = [];
// 也可以不设置纹理，设置颜色
models.push({
id: 1,
model: modelUrls[0],
color: new Cesium.Color(179 / 255, 179 / 255, 179 / 255, 1)
});
models.push({
id: 2,
model: modelUrls[1],
color: new Cesium.Color(94 / 255, 179 / 255, 59 / 255, 1)
});
models.push({
id: 3,
model: modelUrls[2],
color: new Cesium.Color(52 / 255, 94 / 255, 35 / 255, 1)
});
models.push({
id: 4,
model: modelUrls[3],
color: new Cesium.Color(115 / 255, 115 / 255, 115 / 255, 1)
});
models.push({
id: 5,
model: modelUrls[4],
color: new Cesium.Color(171 / 255, 85 / 255, 66 / 255, 1)
});
models.push({
id: 6,
model: modelUrls[5],
color: new Cesium.Color(68 / 255, 68 / 255, 68 / 255, 1)
});
solidModelsProfile.addModels(models);
solidModelsProfile.addedEvent.addEventListener((param) => {
console.log(param);
viewer.camera.flyTo(
{
destination: new Cesium.Cartesian3.fromDegrees(param.modelPosition[0].position.x, param.modelPosition[0].position.y, 60000)
})
});
}
showModel();
声明
本文内容仅代表作者观点，或转载于其他网站，本站不以此文作为商业用途
如有涉及侵权，请联系本站进行删除
转载本站原创文章，请注明来源及作者。