exportMap

URI

<mapService_uri>/export[.<format>]

支持的方法

GET、HEAD

父资源

mapService

介绍

动态出图。允许客户端应用程序从服务器下载地图的格网图片， 此操作在地图服务上执行。该资源 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>}
  • <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>格式的表述。

请参见