当前位置：首页 > article >正文

Cesium ArcGisMapServerImageryProvider API 介绍

article 2026/5/11 9:15:04

作为一名GIS研究生，WebGIS 技术无疑是我们必学的核心之一。说到WebGIS，要提的就是 Cesium —— 这个让3D地球可视化变得简单又强大的工具。为了帮助大家更好地理解和使用 Cesium，我决定把我自己在学习 Cesium 文档过程中的一些心得和收获分享给大家。大家一起交流，一起进步！

在Cesium中，ArcGisMapServerImageryProvider 是一个非常有用的API，它允许开发者使用由ArcGIS MapServer提供的切片图像作为背景图层。这个API对于需要在Web应用中整合ArcGIS地图服务的开发者来说，提供了一个便捷的接口。通过该API，开发者可以轻松加载ArcGIS预缓存的地图图像，或者直接从ArcGIS MapServer请求实时数据。

`ArcGisMapServerImageryProvider` 是什么？

简单来说，ArcGisMapServerImageryProvider 是一个图像提供者（ImageryProvider），它从ArcGIS MapServer获取切片图像并在Cesium的场景中展示。ArcGIS 是一个非常流行的地理信息系统（GIS）平台，它提供了丰富的地图服务和地理数据。在Cesium中，通过使用这个API，你可以将ArcGIS提供的地图服务直接集成到3D地图中。

如何使用 `ArcGisMapServerImageryProvider`

ArcGisMapServerImageryProvider 这个API并不会直接实例化，而是提供了两个静态方法来创建实例：

fromBasemapType(style, options)：
- 通过这种方式，你可以根据预定义的ArcGIS基图样式（比如卫星图、海洋图、阴影图等）来创建图像提供者。
- 这个方法适用于从ArcGIS的常规基图服务中加载切片图像。
fromUrl(url, options)：
- 如果你有一个ArcGIS MapServer的URL，并且想要从指定的服务中加载图像数据，可以使用这个方法。
- 这种方式更加灵活，允许你从任何ArcGIS服务器加载数据。

核心属性

credit: 返回当前图像提供者的来源信用，通常在使用第三方地图服务时，需要显示版权信息。
enablePickFeatures: 控制是否允许从地图上选取特征（如点、线、面）。如果设置为 true，当用户点击地图时，pickFeatures 方法会返回点击位置的特征信息。
layers: 用逗号分隔的图层ID列表，用于指定要显示的图层。如果为 undefined，则显示所有图层。
tileWidth 和 tileHeight: 指定每个瓦片的宽度和高度，默认为 256 像素。
maximumLevel 和 minimumLevel: 定义可以请求的最大和最小细节级别，帮助控制地图的细节层次。

核心方法

getTileCredits(x, y, level):
获取指定瓦片的版权信息。适用于你需要为每个瓦片提供来源标注时使用。
pickFeatures(x, y, level, longitude, latitude):
这个方法非常强大，允许你在特定位置（通过经纬度）上选取地图上的特征。返回的是一个包含地图上特征信息的数组。
requestImage(x, y, level, request):
用来请求特定瓦片的图像。这个方法通常是后台异步执行的，直到瓦片加载完毕。

我来举一个通俗易懂的例子帮助理解

想象我们正在开发一个虚拟旅游应用，想让用户在3D地图上看到全球的卫星图像。你可能需要一个高质量的图层来呈现地球的实际影像。这时，ArcGIS提供的卫星图像服务就非常适合。

你可以通过 ArcGisMapServerImageryProvider API 来实现这一点。就像你在地图上铺了一层卫星图像，然后在上面展示你的3D模型，用户可以从全球任何角度查看你的模型，背景都是清晰的卫星图像。

再比如正在开发一个虚拟旅游网站，让用户在地图上查看不同城市的景点。你可以用 fromBasemapType 方法加载 ArcGIS 的卫星图层，然后让用户在虚拟世界中“飞行”，同时看到真实世界的卫星影像。

更详细内容可以直接阅读官方API介绍：ArcGisMapServerImageryProvider - Cesium Documentation