URI

<mapService_uri>/export[.<format>]

支持的方法

GETHEAD

父资源

mapService

介绍

动态出图。允许客户端应用程序从服务器下载地图的格网图片, 此操作在地图服务上执行。该资源 URL 返回到生成的切片包(.tpk)或缓存栅格数据集。

支持的方法:

  • GET:获取地图的格网图片 。
  • HEAD:检查 exportMap  资源是否存在,或权限是否可以访问 exportMap 资源。

资源层次

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>}

  • <layerID> 表示图层 ID 号

  • <layerDef>表示要素过滤表达式

对不同的图层进行过滤,各图层的过滤条件间以英文逗号分隔。如: 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>}}]

  • <layerID> 表示deynamicLayerd的 ID 号

  • <layer source>表示图层的类型和ID

  • <renderer>表示图层的渲染器,为图层提供符号系统的定义对象

  • <transparency>表示透明度

  • <labeling info>表示标签信息,定义用于标签图层的属性的对象

layers

String

指定导出图层时哪些图层将出现在导出的地图上,支持设置的状态包括 show、hide、include、exclude

  • 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>格式的表述。

请参见