arcgis for server 10.1 rest api新特性.doc

目 录ARCGIS FOR SERVER 10.11目 录I1地图服务11.1动态图层11.2地图服务资源11.3图层资源21.4支持WMTS32影像服务32.1影像服务支持新的操作32.2影像服务支持新的子资源42.3栅格目录项（Raster catalog item）新增子资源42.4影像服务资源新增属性42.5其他参数变化52.6支持WMTS63网络分析服务63.1网络图层资源63.2操作参数变化63.3三维网络分析64要素服务74.1要素服务新增操作支持：74.2要素服务资源新增属性74.3图层资源新增操作84.4图层资源新增属性84.5【pre-release未提到，已被gdbVersion参数取代】新增versionName参数95GP服务95.1GP服务资源95.2GP服务操作105.3GP数据类型105.4GP服务结果106地理编码服务107几何服务118SCHEMATIC服务119REST API ADMIN1110其他变化12 II伴随着ArcGIS Server 10.1的发布，REST API的功能也得到了很多增强与完善。1 地图服务1.1 动态图层地图服务支持动态图层资源。动态图层支持query和generateRenderer（在beta 1中原本是generateDataClasses）操作。URL地址：http:/dynamicLayerExport Map，Identify，Find操作支持新的dynamicLayers参数。Legend和Layers资源支持dynamicLayers参数。1.2 地图服务资源地图服务资源包括maxRecordCount，maxImageHeight，maxImageWidth，supportsDynamicLayers等属性，用于指定服务是否支持动态图层。另外，tileServers属性标识地图服务的多个子域端点（缓存分布式部署，瓦片请求将在缓存服务器之间处理）。supportedQueryFormats属性指示支持的query操作输出格式。地图服务资源现在timeInfo下包含新的属性：timeRelation、defaultTimeInterval、defaultTimeIntervalUnits、defaultTimeWindow和hasLiveData。地图服务资源现在包含minScale和maxScale属性。1.3 图层资源Layer现在支持新的generateRenderer操作，通过该操作生成分级渲染器和唯一值渲染器。图层资源包含若干新属性：maxRecordCount表示通过Find、Identify、Query所能返回的最大记录数；canModifyLayer指示一个图层的符号、数据源以及连接信息是否可修改；supportsStatistics指示Query操作是否支持统计功能；supportsAdvancedQueries指示查询操作是否支持对查询结果进行排序；hasLabels指示图层是否具有定义好的标注；canScaleSymbols指示图层的符号是否依赖比例尺（随比例尺变化）；supportedQueryFormats指示某个查询所支持的输出格式；hasZ和hasM分别指示图层中的几何体是否包含Z和M值；identify、find、query、query related records等操作以及要素资源接受两个新的参数：returnZ和returnM，以标示返回的几何体中是否包含Z和M值；图层资源将为relationships返回role、cardinality、keyField、isComposite、relationshipTable和keyFieldInRelationshipTable属性；操作：export、identify、find、query、queryRelatedRecords、generateRenderer，资源：feature、attachment、html popup，支持gdbVersion参数。通过该参数切换图层数据源指向的可选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 影像服务支持新的操作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：返回影像服务的柱状图。【pre-release中未提到该项，疑似已取消】Metadata：返回影像服务的元数据，xml格式。Key Properties：返回影像服务的关键属性，始终返回json格式。2.3 栅格目录项（Raster catalog item）新增子资源Metadata：xml格式。Thumbnail：返回单个栅格目录项的缩略图。Raster Info：返回关联的栅格数据信息（宽度高度、波段数、像素类型等）。Key Properties：返回栅格目录项的关键属性，始终是json格式。2.4 影像服务资源新增属性缓存信息：影像服务资源新增initialExtent，fullExtent，singleFusedMapCache和tileInfo属性，用于标识服务的缓存信息。默认属性：影像服务资源包含defaultMosaicMethod，mosaicOperator，defaultCompressionQuality，defaultResamplingMethod等默认属性。默认镶嵌规则由defaultMosaicMethod和mosaicOperator组合而成。当defaultMosaicMethod是esriMosaicAttribute，影像服务对应采用sortField和sortValue。约束信息：影像服务通过allowRasterFunction、allowedMosaicMethods，maxRecordCoun， maxImageHeight、maxImageWidth、maxDownloadImageCount和maxMosaicImageCount属性，指示服务的约束信息。影像服务资源包含rasterFunctionInfos，rasterTypeInfos，mensurationCapabilities属性，标识所支持的栅格函数模板（用于导出图片），栅格类型（用于添加/更新栅格数据）和量算能力（用于量算）。影像服务资源包含hasHistograms，hasColormap，hasRasterAttributeTable属性，指示服务关联的资源是否可用。影像服务资源提供capabilities属性，指示所支持的操作。影像服务资源包含editFieldsInfo和ownershipBasedAccessControlForRasters两个JSON对象，包含编辑器跟踪的字段信息和对关联属性的访问控制。2.5 其他参数变化影像服务的Raster File资源支持新的rasterId参数。影像服务的Identify操作支持一个新增的time、renderingRule、returnGeometry、returnCatalogItems参数。Export Image操作支持新的noDataInterpretation参数。2.6 支持WMTS切片影像服务支持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操作的参数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、数量，或返回全部要素（有数量限制）。Create Replica：为要素服务子集创建复本（可指定图层及过滤条件、数据范围、空间参考等）。Synchronize Replica：通过replicaID在服务器端和客户端之间同步数据变化。Redefine Replica：更改复本的定义，包括添加/移除图层、更改图层定义、更改地理范围等。Unregister Replica ：取消要素服务中复本的注册。4.2 要素服务资源新增属性maxRecordCount、supportsRollbackOnFailure、hasVersionedData、supportsDisconnectedEditing和supportedQueryFormats。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 Features 操作支持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属性。图层资源包含editFieldsInfo属性，标识编辑器跟踪的字段。图层资源新增属性：defaultVisibility、maxRecordCount、ownershipBasedAccessControlForFeatures、syncCanReturnChanges、isDataVersioned、supportsRollbackOnFailure、supportedQueryFormats,、hasZ 和 hasM。图层资源将为relationships返回role、cardinality、keyField、isComposite、relationshipTable和keyFieldInRelationshipTable属性。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 Attachment、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数据类型GPMultiValue现在支持所有的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 Candidates操作支持新的searchExtent参数。对于由组合定位器发布的地理编码服务，Geocode服务资源可返回涉及的每个定位器名称。7 几何服务Project操作通过transformation和transformForward输入参数支持大地基准（datum）的转换。Buffer操作支持测地学（geodesic）缓冲区分析。Areas和Lengths操作支持calculationType参数。Lengths操作支持calculationType参数。geodesic参数已被弃用。下述操作将对输入的图形调用Sim