arcgis for server 101 rest api新特性.docx

1、arcgis for server 101 rest api新特性目 录ArcGIS for Server 10.1 1目录 I1 地图服务 11.1 动态图层 11.2 地图服务资源 11.3 图层资源 21.4 支持WMTS 32 影像服务 32.1 影像服务支持新的操作 32.2 影像服务支持新的子资源 42.3 栅格目录项（Raster catalog item）新增子资源 42.4 影像服务资源新增属性 42.5 其他参数变化 52.6 支持WMTS 63 网络分析服务 63.1 网络图层资源 63.2 操作参数变化 63.3 三维网络分析 64 要素服务 74.1 要素服务新增操作

2、支持： 74.2 要素服务资源新增属性 74.3 图层资源新增操作 84.4 图层资源新增属性 84.5 【pre-release未提到，已被gdbVersion参数取代】新增versionName参数 95 GP服务 95.1 GP服务资源 95.2 GP服务操作 105.3 GP数据类型 105.4 GP服务结果 106 地理编码服务 107 几何服务 118 Schematic服务 119 REST API Admin 1110 其他变化 12伴随着ArcGIS Server 10.1的发布，REST API的功能也得到了很多增强与完善。1 地图服务1.1 动态图层地图服务支持动态图层资

3、源。动态图层支持query和generateRenderer（在beta 1中原本是generateDataClasses）操作。URL地址：http:/dynamicLayerExport Map，Identify，Find操作支持新的dynamicLayers参数。Legend和Layers资源支持dynamicLayers参数。1.2 地图服务资源地图服务资源包括maxRecordCount，maxImageHeight，maxImageWidth，supportsDynamicLayers等属性，用于指定服务是否支持动态图层。另外，tileServers属性标识地图服务的多个子域端点（

4、缓存分布式部署，瓦片请求将在缓存服务器之间处理）。supportedQueryFormats属性指示支持的query操作输出格式。地图服务资源现在timeInfo下包含新的属性：timeRelation、defaultTimeInterval、defaultTimeIntervalUnits、defaultTimeWindow和hasLiveData。地图服务资源现在包含minScale和maxScale属性。1.3 图层资源Layer现在支持新的generateRenderer操作，通过该操作生成分级渲染器和唯一值渲染器。图层资源包含若干新属性：maxRecordCount表示通过Find、

5、Identify、Query所能返回的最大记录数；canModifyLayer指示一个图层的符号、数据源以及连接信息是否可修改；supportsStatistics指示Query操作是否支持统计功能；supportsAdvancedQueries指示查询操作是否支持对查询结果进行排序；hasLabels指示图层是否具有定义好的标注；canScaleSymbols指示图层的符号是否依赖比例尺（随比例尺变化）；supportedQueryFormats指示某个查询所支持的输出格式；hasZ和hasM分别指示图层中的几何体是否包含Z和M值；identify、find、query、query rela

6、ted records等操作以及要素资源接受两个新的参数：returnZ和returnM，以标示返回的几何体中是否包含Z和M值；图层资源将为relationships返回role、cardinality、keyField、isComposite、relationshipTable和keyFieldInRelationshipTable属性；操作：export、identify、find、query、queryRelatedRecords、generateRenderer，资源：feature、attachment、html popup，支持gdbVersion参数。通过该参数切换图层数据源指向

7、的可选SDE版本；【pre-release中未提到该项，疑似已取消】indexedFields是一个数组，包含索引字段的名称。对图层资源的查询操作支持3个新的参数：orderByFields、outStatistics和groupByFieldsForStatistics。1.4 支持WMTS缓存地图服务支持WMTS资源（仅在网页中访问）。WMTS资源支持WMTS能力：http:/WMTSCapabilities.xml，10.1中版本只支持1.0.0。（可通过客户端API访问）WMTS资源支持WMTS Tile子资源（可通过客户端API访问）：http:/tile/.。2 影像服务2.1 影

8、像服务支持新的操作Add Rasters：支持文件或URL（影像服务、地图服务、WCS、WMS），只能POST。Update Raster：同上，只支持单个更新。Delete Rasters：同上，指定rasterIds即可。Measure：量算距离、方向、面积、周长、高度等。不同算法对数据源有不同要求。Compute Histograms：指定范围，所有波段。2.2 影像服务支持新的子资源Tile：http:/tile/Raster Attribute Table：http:/rasterattributetableColormap：返回像素点的RGB颜色值。Histograms：返回影像服

9、务的柱状图。【pre-release中未提到该项，疑似已取消】Metadata：返回影像服务的元数据，xml格式。Key Properties：返回影像服务的关键属性，始终返回json格式。2.3 栅格目录项（Raster catalog item）新增子资源Metadata：xml格式。Thumbnail：返回单个栅格目录项的缩略图。Raster Info：返回关联的栅格数据信息（宽度高度、波段数、像素类型等）。Key Properties：返回栅格目录项的关键属性，始终是json格式。2.4 影像服务资源新增属性缓存信息：影像服务资源新增initialExtent，fullExtent，s

10、ingleFusedMapCache和tileInfo属性，用于标识服务的缓存信息。默认属性：影像服务资源包含defaultMosaicMethod，mosaicOperator，defaultCompressionQuality，defaultResamplingMethod等默认属性。默认镶嵌规则由defaultMosaicMethod和mosaicOperator组合而成。当defaultMosaicMethod是esriMosaicAttribute，影像服务对应采用sortField和sortValue。约束信息：影像服务通过allowRasterFunction、allowedMo

11、saicMethods，maxRecordCoun， maxImageHeight、maxImageWidth、maxDownloadImageCount和maxMosaicImageCount属性，指示服务的约束信息。影像服务资源包含rasterFunctionInfos，rasterTypeInfos，mensurationCapabilities属性，标识所支持的栅格函数模板（用于导出图片），栅格类型（用于添加/更新栅格数据）和量算能力（用于量算）。影像服务资源包含hasHistograms，hasColormap，hasRasterAttributeTable属性，指示服务关联的资源是

12、否可用。影像服务资源提供capabilities属性，指示所支持的操作。影像服务资源包含editFieldsInfo和ownershipBasedAccessControlForRasters两个JSON对象，包含编辑器跟踪的字段信息和对关联属性的访问控制。2.5 其他参数变化影像服务的Raster File资源支持新的rasterId参数。影像服务的Identify操作支持一个新增的time、renderingRule、returnGeometry、returnCatalogItems参数。Export Image操作支持新的noDataInterpretation参数。2.6 支持WMTS

13、切片影像服务支持WMTS资源，WMTS资源支持WMTS Capabilities和WMTS Tile子资源。3 网络分析服务3.1 网络图层资源网络图层资源支持hasZ和hasM属性以指定图层是否Z或M值敏感。3.2 操作参数变化Closest facility操作支持timeOfDay和timeOfDayUsage参数。Service area操作支持timeOfDay和useHierarchy参数。Route、Closest facility和Service area操作支持一个可选的url属性，用于指定输入位置。Route、Closest facility和Service area操作的

14、参数outputLines新增一个枚举值：esriNAOutputLineTrueShapeWithMeasure。3.3 三维网络分析Route、Closest facility操作返回的CompressedGeometry能够包含M和Z值。如果Route、Closest facility和Service area在包含Z值的网络数据集中运算，那么这些操作返回的结果中的每个节点将包含Z值。同时支持在输入的点和线参数中包含Z值。4 要素服务4.1 要素服务新增操作支持：Apply Edits：可同时提交增加、删除和更新的内容。Query：查询图层数据，可以只返回ID、数量，或返回全部要素（有数

15、量限制）。Create Replica：为要素服务子集创建复本（可指定图层及过滤条件、数据范围、空间参考等）。Synchronize Replica：通过replicaID在服务器端和客户端之间同步数据变化。Redefine Replica：更改复本的定义，包括添加/移除图层、更改图层定义、更改地理范围等。Unregister Replica ：取消要素服务中复本的注册。4.2 要素服务资源新增属性maxRecordCount、supportsRollbackOnFailure、hasVersionedData、supportsDisconnectedEditing和supportedQuer

16、yFormats。4.3 图层资源新增操作图层支持操作Generate Renderer。Query操作支持returnGeometry、maxAllowableOffset、orderByFields、groupByFieldsForStatistics、outStatistics、gdbVersion、returnZ 和 returnM 参数。Query Related Records支持maxAllowableOffset、gdbVersion、returnZ 和 returnM 参数。Apply Edits、Add Features、Update Features 和 Delete F

17、eatures 操作支持gdbVersion参数。Apply Edits、Add Features、Update Features、Delete Features和Delete Attachments操作支持rollbackOnFailure参数。Add Attachment、Update Attachment和Delete Attachments 操作支持gdbVersion 参数。Feature、Attachment Infos、Attachment 和 HTML Popup 资源支持gdbVersion 参数。4.4 图层资源新增属性图层资源中fields新增nullable属性。图层资

18、源包含editFieldsInfo属性，标识编辑器跟踪的字段。图层资源新增属性：defaultVisibility、maxRecordCount、ownershipBasedAccessControlForFeatures、syncCanReturnChanges、isDataVersioned、supportsRollbackOnFailure、supportedQueryFormats,、hasZ 和hasM。图层资源将为relationships返回role、cardinality、keyField、isComposite、relationshipTable和keyFieldInRela

19、tionshipTable属性。Feature资源新增支持returnZ和returnM参数。要素服务资源和图层资源均具有zDefault和enableZDefaults属性，以支持配置为包含默认Z值的服务。4.5 【pre-release未提到，已被gdbVersion参数取代】新增versionName参数查询操作：Query和Query Related Records操作支持versionName参数。编辑操作：Apply Edits、Add Features、Update Features和Delete Features操作支持versionName参数。附件管理操作：Add Atta

20、chment、Update Attachment和Delete Attachments操作支持versionName参数。资源：Feature、Attachment Infos、Attachment和HTML Popup资源支持versionName参数。5 GP服务5.1 GP服务资源GP服务资源支持maximumRecords和currentVersion属性。5.2 GP服务操作新增Cancel job操作。该操作可在一个异步的GP任务完成之前将其取消。submitJob操作执行以及返回的GP结果资源现在支持returnZ 和 returnM 参数。5.3 GP数据类型GPMultiVa

21、lue现在支持所有的GP数据类型。GPDataFile 和 GPRasterData现在支持通过上传项的itemID 作为输入。5.4 GP服务结果如果GP服务与一个结果地图服务（result map service）关联，GP 结果可以直接通过关联的地图服务资源进行访问。如果要素包含Z和M值，则GPFeatureRecordSetLayer将返回hasZ 和 hasM 属性。GPFeatureRecordSetLayer 和 GPRecordSet 为响应中的字段返回fields属性。6 地理编码服务新增Geocode Addresses操作，支持批量处理地理编码。Find Address

22、Candidates操作支持新的searchExtent参数。对于由组合定位器发布的地理编码服务，Geocode服务资源可返回涉及的每个定位器名称。7 几何服务Project操作通过transformation和transformForward输入参数支持大地基准（datum）的转换。Buffer操作支持测地学（geodesic）缓冲区分析。Areas和Lengths操作支持calculationType参数。Lengths操作支持calculationType参数。geodesic参数已被弃用。下述操作将对输入的图形调用Simplify 方法：Auto Complete、 Buffer、Cu

23、t、Difference、Intersect、Label Points、Offset、Project、Relation、Reshape和Union。下述操作在特定条件下将对输入的图形调用Simplify 方法：Areas and Lengths、Densify 和 Distance。8 Schematic服务Schematic服务是10.1中新增的服务，用于显示、生成、更新和布局逻辑示意图。9 REST API Admin从10.1开始，将无法通过REST API admin调用generateToken操作（http:/generateToken）。使用ArcGIS Server的管理API

24、的generateToken操作：http:/admin/generateToken替代。10 其他变化使用WKID定义的空间参考对象，现在包含一个latestWkid属性。使用WKID定义的空间参考对象，可以选择性地包含垂直坐标系的定义（使用vcsWkid和latestVcsWkid属性）。ServerInfo资源限制返回shortLivedTokenValidity。现在支持包含Z和M值的几何体。featureSet可能包含hasZ 和 hasM属性用于指示其中的几何体是否包含Z和M值。地图服务、地理编码服务、地理处理服务、几何服务、影像服务、球体服务和地理数据服务现在支持Item Info、Thumbnail和Metadata资源。地理处理服务、影像服务、地理数据服务、要素服务和移动服务现在支持Uploads资源，该资源是上传相关操作和资源的父资源。