URI
<mapService_uri>/export[.<format>]
支持的方法
父资源
介绍
动态出图。允许客户端应用程序从服务器下载地图的格网图片, 此操作在地图服务上执行。该资源 URL 返回到生成的切片包(.tpk)或缓存栅格数据集。
支持的方法:
资源层次
HTTP 请求方法
对如下 URI 执行 HTTP 请求,以 json 输出格式为例加以说明,其中,supermapiserver 是服务器名,{component}是服务组件名,{mapName}是地图名。
http://supermapiserver:8090/iserver/services/{component}/arcgisrest/{mapName}/MapServer/export.json
GET 请求
导出地图的格网图片,URI 中的参数确定了导出图像的范围等信息。
请求参数
对 exportMap 资源执行 GET 请求,获取地图的格网图片,需要在 URI 中包含相关参数。参数如下所示:
名称 |
类型 |
含义 |
f |
String |
响应格式,支持 json、pjson |
bbox |
double |
【必填参数】 导出图像的范围(边界框),如 bbox=-127.8,15.4,-63.5,60.5 |
bboxSR |
String |
bbox 的坐标参考系统 |
size |
int |
导出图像的大小(宽度和高度),以像素为单位,如果没有指定,默认输出 400×400 像素的图像。如 size=600,550 |
imageSR |
int |
导出图像的空间参考,如 imageSR=102004 |
format |
String |
导出图像的格式。默认格式为 png |
layerDefs |
String |
导出图层时的过滤条件,可以通过定义表达式来过滤图层的要素。 格式为 layerDefs={"<layerID1>":"<layerDef1>","<layerID2>":"<layerDef2>}
对不同的图层进行过滤,各图层的过滤条件间以英文逗号分隔。如: layerDefs={"0":"SMID>500","1":"SMID>5"} |
dynamicLayers |
String |
用于修改图层的绘制顺序以及图层的绘图信息。当前,iServer 支持修改普通矢量图层(点、线、面)、面单值专题图和点、面标签专题图的绘图信息。具体包括:
dynamicLayers 数组中的顺序定义了出图时图层的顺序,第一个元素绘制在所有层的顶部。格式为: dynamicLayers=[{"id":<layerID>,"source":<layer source>,"drawingInfo":{"renderer":<renderer>,"transparency":<transparency>,"scaleSymbols":<true | false>,"labelingInfo":<labeling info>}}]
|
layers |
String |
指定导出图层时哪些图层将出现在导出的地图上,支持设置的状态包括 show、hide、include、exclude
如需要仅显示 0、1、2 这几个图层,则表达式为: layers=show:0,1,2 |
响应结构
如果直接获取地图图片,可指定表述格式为 PNG、BMP、GIF、WebP 或 JPG,则返回一幅图片。
如果获取地图图片信息,可指定表述格式为 PJSON、JSON,则返回的表述结构如下:
字段 | 类型 | 说明 |
href | String | 导出的图像的 href |
width | int | 导出图片的宽 |
height | int | 导出图片的高 |
scale | double | 导出图片的比例尺 |
extent | ArcGISMapExtend | 导出图片的范围 |
响应示例
对 export 资源执行 get 请求。URI为: http://localhost:8090/iserver/services/map-BeijingAddress/arcgisrest/county_R/MapServer/export?bbox=12904368.38,4810997.19,-63.5,60.5&layerDefs={"1":"SMID<1000"} 返回的图片如下:
HEAD 请求
返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
HEAD 请求可以用来判断 exportMap 资源是否存在,或者客户端是否有权限访问 exportMap 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 exportMap 资源是否支持<format>格式的表述。
请参见