外观
瓦片常见问题
约 2535 字
瓦片加载不支持非标准切片。
如果使用官网的瓦片链接加载失败,可以打开 Network 查看是否为 key 的问题;如果是,则需要进行替换,参考常见问题 - 第 3 方 token 有问题
如何更换加载的底图
回复map.basemap = 瓦片id || 瓦片name

如何加载其他坐标系的瓦片?
回复crs: "EPSG:4490"加载时瓦片未铺满全球的原因


如何设置偏移量
回复// 该方法演示地图内部需要设置偏移量时如何加载
tileLayer = new mars3d.layer.XyzLayer({
url: "'url'&z={z_2}&y={y}&x={x}",
customTags: {
z_2(imageryProvider, x, y, level) {
return level - 2
}
}
})
map.addLayer(tileLayer)瓦片贴模型显示异常且注记模糊
目前已知的问题:
多个图层调整时会全部重新渲染;
EPSG:3857 Web 墨卡托投影坐标系的瓦片贴模型时存在投影变形带来的显示模糊问题。
clampToTileset: true 即可贴到 3D Tiles 模型上,官方示例「瓦片贴模型」(layer-tile/manage/clampToTileset)可直接参考。const tdtLayer = new mars3d.layer.TdtLayer({
layer: "img_z",
key: mars3d.Token.tiandituArr,
crs: mars3d.CRS.EPSG4326,
clampToTileset: true, // 关键代码
});
map.addLayer(tdtLayer);模糊问题:注记层如果是自己的服务,可以发布到 21 级,避免拉伸 18 级的数据导致模糊;3857 瓦片建议改用 4326 坐标系的瓦片以避免投影变形。
有的瓦片加载后变得模糊(如高德)
回复因为三维地图 WebGL 的渲染机制不同,是将图片重新通过 canvas 绘制到 WebGL 中;而高德、OpenLayers、Leaflet 等二维地图是直接显示图片的,所以更清晰。瓦片在南北极缺失一块(圆形缺口)的原因

顶部那个圆圈对应的坐标系范围大概是 85-90。
瓦片请求参数在 Network 中显示异常
例如 ArcGisLayer 瓦片的花括号没有被转义、WmtsLayer 瓦片的 queryParameters 参数被编码。
回复可参考下面的代码进行类似修改:Cesium.Resource.ReplaceUrl = function (url) {
if (url.startsWith("http://server.mars3d.cn/arcgis/rest/services/mars/guihua/MapServer")) {
return url.replace(/\{/gm, "%200").replace(/\}/gm, "%20")
}
return url
}xyzLayer xyz 瓦片不支持单击事件吗?但 API 中显示有
回复基类中定义的代表所有图层均有,但并不是所有子类都实现了,目前仅 wmts、wms、arcgis 图层具备单击事件。xyz 图层需要配置 enablePickFeatures、pickFeaturesUrl、getFeatureInfoFormats 等参数后才支持单击。
imageLayer 加载大图(如 60M)时黑屏的解决
回复WebGL 的图片分辨率不得超过 4096 像素,目前无法处理。加载 wms 等服务需要注意哪些事项?
回复wms 只支持 4326、3857、4490 的标准切片,其他坐标系不支持。
对应级别 tilematrix 找到的瓦片,tilerow&tilecol 这两个参数使用时常见报错无效,参考: https://blog.csdn.net/m0_69803146/article/details/135129924?spm=1001.2014.3001.5502
通用标准的服务,一般都是服务的支持或参数问题;如需细调服务,可根据服务的 xml 服务描述信息进行调试测试,例如: http://mars3d.cn/editor-vue.html?key=ex_3_2_3&id=layer-tile/type/wms
如果服务请求时还涉及大小写问题,可参考修改 wms 请求的大小写:
Cesium.Resource.ReplaceUrl = function (url) {
if (this.\_url.startsWith("//server.mars3d.cn/geoserver/mars/wms")) {
return url.replaceAll("bbox", "BBOX")
} else {
return url
}
}config.json 中配置 WMS 图层的正确写法
同样的 WMS 服务参数,用代码 new WmsLayer 可以正常加载地图;写到 config.json 配置文件中就无法正常显示。
代码方式正常加载:

配置文件中写无法显示:

在 config.json 中按下面结构配置即可正常加载:
{
"id": "21c9529fbd8892320ea52ed993d0189f",
"name": "ww-1_transparent_mosaic_group1_3b",
"type": "wms",
"url": "http://111.31.77.214:10005/geoserver/scmonitor/wms",
"layers": "scmonitor:ww-1_transparent_mosaic_group1_3b",
"crs": "EPSG:4326",
"bbox": [119.67690814903645, 28.72073397898277, 119.72675494903645, 28.73338077898277],
"zIndex": 3000,
"flyTo": true,
"parameters": {
"service": "WMS",
"version": "1.1.0",
"request": "GetMap",
"srs": "EPSG:4326",
"layers": "scmonitor:ww-1_transparent_mosaic_group1_3b",
"format": "image/png",
"transparent": true,
"styles": ""
},
"show": true
}WMS 点击高亮轮廓与瓦片图元边界不一致
1、WMS 图层点击通过 GetFeatureInfo 获取 geometry 绘制 Graphic 高亮,高亮轮廓和 WMS 瓦片上的图元边界不一致; 如下图:
2、官网示例中 WMS 点击可返回完整面 geometry,高亮效果正常;
3、返回数据,是怎么控制的?要怎么样才能返回面数据呢?
http://mars3d.cn/editor-vue.html?key=ex_3_2_3&id=layer-tile/type/wms
WMS 高空视角图形扎堆渲染的优化
1、用户加载 WMS 服务图层,相机高度较高(高空俯视)时,无填充色的矩形基础图形扎堆聚集,画面显示一团一团,渲染效果差;
2、该现象在官网示例复现,非项目环境独有。用户询问是否可以增加金字塔分层渲染做优化。
现象:放大到局部,单个矩形图形显示正常;缩小抬高视角,大量小几何要素叠加在一起出现渲染混乱、糊成一团。


高空视高下,WMS 图层大量小矩形要素不要扎堆糊在一起,渲染显示清晰,希望通过金字塔分层(多分辨率瓦片)方式优化显示效果。
http://mars3d.cn/editor-vue.html?key=ex_3_2_3&id=layer-tile/type/wms
回复需要服务端配置wms图层对应的分层渲染style配置,客户端只是加载服务端返回的xyz图片。
ArcGisLayer ArcGis 瓦片
如何修改服务本身的样式?
回复ArcGisLayer 不支持修改样式,它是服务端渲染后的图片,加载到客户端显示。可以用 ArcGisWfsSingleLayer 或 ArcGisWfsLayer 来加载,通过 symbol 配置颜色。
WMTSLayer WMTS 瓦片
format 为 application/json;type=geojson 的服务无法加载
回复这个属于 wfs,这种需要定制开发矢量瓦片(渲染为图片),或按矢量数据显示解析规则。WMTS 无法配置 tilematrix 参数
回复添加参数 tileMatrixSetID:"EPSG:4326_plyx:"具体来源为gitee 提问
瓦片请求如何自定义校验(如时间校验)
回复使用 customTags 参数。 url: "'url'&z={z_2}&y={y}&Created={time}",
customTags: {
time: function (imageryProvider, x, y, level) {
return new Date().getTime();
},
},如何配置 tilerow、tilecol 参数
回复这两个参数是自动计算的,可以设置 rectangle 边界参数。如何加载自定义 popup
回复- 如果有对应的 wms 服务,可以参考示例添加代码以支持 popup

- 如果没有,需要添加 click 事件做相关查询处理,查询数据返回后自行构造 Popup 对象弹窗显示即可。
WMSLayer WMS 瓦片可以添加 mouseMove 移动事件吗?
回复理论上可以添加,但效率太差,鼠标移动时会一直查询服务;单击则是一次点击查询一次,更合理。WMS 1.3.0 的 BBox 轴顺序和图层对不上
回复GeoServer 的 WMS 1.3.0 在 EPSG:4326 下,BBox 是纬度在前、经度在后。WmsLayer 请求使用的是经度在前、纬度在后。轴顺序不一致时,瓦片范围错位,图层加载不出来。这种情况不要硬改 WmsLayer 的 BBox,改用 XyzLayer 按服务要求拼 URL:
const tileLayer = new mars3d.layer.XyzLayer({
url: "http://localhost/geoserver/workspace/wms?service=WMS&version=1.3.0&request=GetMap&layers=workspace:layer&bbox={westProjected},{southProjected},{eastProjected},{northProjected}&crs=EPSG:4326&width=256&height=256&styles=&format=image/png&transparent=TRUE",
crs: "EPSG:4326",
flyTo: true
})
map.addLayer(tileLayer){westProjected} 这四个占位符会按当前坐标系换成投影坐标。服务若仍提示参数错误,对照 GetCapabilities 里的 CRS 和轴顺序再改 bbox 占位符的先后。
多个 WMTS 按级别分段显示
回复希望 0–9 级只用服务 A、11–12 级只用服务 B 时,用group 包起来,分别设置 minimumLevel、maximumLevel:{
name: "分段影像",
type: "group",
show: true,
layers: [
{
type: "wmts",
url: "http://localhost/service-a/{TileMatrix}/{TileRow}/{TileCol}.png",
layer: "a",
tileMatrixSetID: "EPSG:3857",
crs: "EPSG:3857",
minimumLevel: 0,
maximumLevel: 9
},
{
type: "wmts",
url: "http://localhost/service-b/{TileMatrix}/{TileRow}/{TileCol}.png",
layer: "b",
tileMatrixSetID: "EPSG:3857",
crs: "EPSG:3857",
minimumLevel: 11,
maximumLevel: 12
}
]
}超过最大级别仍显示空白时,先在浏览器中直接打开该级别的一张瓦片地址验证;如果服务返回的就是空图,客户端也无法把上一级拉伸显示出来。
WMS 点击高亮的轮廓和瓦片图斑对不上
回复GetFeatureInfo 返回的几何由服务端决定。官网示例能返回完整面,是因为示例服务配置了返回面几何。自己的服务只返回点或简化线时,高亮轮廓就会和瓦片图斑不一致,需要在 GeoServer 或 ArcGIS 里调整查询返回的几何,而不是修改前端绘制。官网示例中的 WMTS 服务数据加载失败如何处理
回复- 服务不稳定,公司自建服务需要重启一下。
- 第三方服务不可用时,可以更换为其他服务地址。
