What's new in the ArcGIS REST API

Map service

• At 10.2.2, Export Tiles and Estimate Export Tile Size are operations of the Map Server. The use of exportTiles/submitJob and estimateExportTilesSize/submitJob operations are deprecated.

Image service

• At 10.2.2, Export Tiles and Estimate Export Tile Size are operations of the Image Server. The use of exportTiles/submitJob and estimateExportTilesSize/submitJob operations are deprecated.

Map service

• Export Tiles and Estimate Export Tile Size tasks are supported in services that allow download of tiles for offline use.

Feature service

• The feature service includes a Sync capability which is used when working with maps offline. Sync-enabled feature services allow ArcGIS clients to create local copies of the data and sync changes back and forth.

Geocode service

• The findAddressCandidates method now supports the maxLocations parameter, which allows the maximum number of address candidates returned by a search to be specified in the request.

Image service

• The root resource now contains supportsStatistics, supportsAdvancedQueries.
• The query operation supports outStatistics, groupByFieldsForStatistics,orderByFields, returnDistinctValues.
• The following well known Raster functions are supported: Mask,Arithmetic,ContrastBrightness,ExtractBand,CompositeBand,MLClassify,Local,Threshold. Existing Statistics function supports a new syntax. The help document has been updated.
• In addition to well known functions, service defined raster function templates can be used in client defined raster function templates to perform multiple processings in one call.
• Export Tiles and Estimate Export Tile Size tasks are supported in services that allow download of tiles for offline use.

Network service

Solving a route, service area, or closest facility analysis for a certain time, such as now, became easier with this release. When specifying departure or arrival times in previous versions of ArcGIS, the time was always assumed to be in the time zone of the starting or ending location (a stop, for instance). At ArcGIS 10.2.1, you have the option of continuing to use that approach or indicating the time zone is Coordinated Universal Time (UTC) by setting startTimeIsUTC in Solve Route or timeOfDayIsUTC in Solve Closest Facility or Solve Service Area to True.

Map service

• Query operations on a Layer and Dynamic Layer now support specifying a gdbVersion parameter in conjunction with the outStatistics parameter.
• Layer and Dynamic layer now report a useStandardizedQueries property to indicate whether the layer supports standardized queries.
• The Renderer object supports two new optional properties: rotationType, which controls the origin and direction of rotation, and rotationExpression, which is a constant value or an expression that derives the angle of rotation based on the feature attribute value. When an attribute name is specified in rotationExpression, it's enclosed in square brackets, for example, [Rotation].
• Map Tile resource now supports a blankTile parameter, which allows clients to request the server to return a resource not found (HTTP 404) response instead of a blank or missing tile. When a blank or missing tile is returned, the response header will now include blank-tile:true.
• Map Service resource returns a new supportedExtensions property, which is a comma-separated list of extensions supported by the map service.

Feature service

Layer (Feature Service) resource now reports a useStandardizedQueries property to indicate whether the layer supports standardized queries.

Image service

• A Get Samples operation is now supported.
• A Compute Class Statistics operation is now supported.
• A Compute Tie Points operation is now supported.
• A Legend (Image Service) resource is now supported.
• The raster catalog item Raster Info resource now includes statistics.
• The root resource now contains allowComputeTiePoints useStandardizedQueries and useStandardizedQueries.
• The Export Image operation supports a compression parameter and png32 format.
• Raster functions have been enhanced to support the outputPixelType parameter and client-defined raster function templates.
• Mosaic rules now take a new mosaic operation "MT_SUM", and an optional itemRenderingRule parameter.
• Image Tile resource now supports a blankTile parameter that allows clients to request the server to return a resource not found (HTTP 404) response instead of a blank or missing tile. When a blank or missing tile is returned, the response header will now include blank-tile:true.

General

• Server Info resource now returns a owningSystemUrl property.
• Token service now supports Cross-Origin Resource Sharing (CORS).

Map service

• Map Server Query operations support a new returnDistinctValues parameter.
• Map Server Query operations support a geometry parameter to be used in conjunction with the outStatistics parameter.
• Legend resource returns height and width of the legend symbol.
• All Layers/Table, Layer, and Dynamic Layer resources now include an ownershipBasedAccessControlForFeatures flag to indicate the ownership access control configuration.

Feature service

• The Query - Feature Service operation supports spatialRel and time parameters.
• The Query - Feature Service operation supports a new JSON representation of the layerDefs parameter with the option to specify output fields.
• If ownership-based access control is enabled on features, the ownershipBasedAccessControlForFeatures property of a layer will include the allowOthersToQuery property.

Image service

• The Image Server Query operation supports a new pixelSize parameter.
• Image Service resource now includes a spatialReference property at the root level.

Geoprocessing service

GP Task resource now includes a description of the tool and its parameters.

Globe service

Globe Tile resource is newly supported.

Map service

• Map services now support the Dynamic Layer resource. Dynamic layers support query, queryRelatedRecords, and generateRenderer operations.
• Map services now support the WMTS resource for tiled map services. The WMTS resource supports WMTS Capabilities and WMTS Tile child resources.
• Export Map, Identify, Find operations and Legend and All Layers/Tables resources support a new dynamicLayers parameter.
• Map Service resource supports a new returnUpdates parameter that accepts a Boolean value. Pass this parameter to retrieve updated information from the map service.
• Map Service resource has new option and outSR input parameters to support the viewing of a map service footprint in arcgis.com map.
• Map Service resource now includes maxRecordCount, maxImageHeight, maxImageWidth, minScale, maxScale, hasVersionedData, and supportsDynamicLayers properties that indicate if a service supports dynamic layers; a tileServers property that advertises multiple subdomains on a map service endpoint; and a supportedQueryFormats property that indicates the supported query operation output formats.
• Map Service resource now includes new properties under timeInfo: timeRelation, defaultTimeInterval, defaultTimeIntervalUnits, and defaultTimeWindow and hasLiveData.hasLiveData that return a Boolean value. If true, the export and identify operations will default the value for the time parameter to be [<current server time - defaultTimeWindow>, <current server time>].
• Layer now supports a new generateRenderer operation. Use this operation to generate a class breaks or unique value renderer.
• Layer resource supports a new returnUpdates parameter that accepts a Boolean value. Pass this parameter to retrieve updated information from the layer.
• Layer resource now includes the maxRecordCount property, which represents the maximum number of records that can be returned by the find, identify, and query operations.
• Layer resource now includes the canModifyLayer property to indicate if a layer's renderer, data source, or join information can be modified.
• Layer resource now includes the supportsStatistics property to indicate if query operations support statistical functions and the supportsAdvancedQueries property to indicate if query operations support ordering the query result.
• Layer resource now includes hasLabels to indicate if the layer has labels defined on it, and canScaleSymbols to indicate if the layer symbology is scale dependent.
• Layer resource now includes supportedQueryFormats to indicate the output formats that are supported in a query.
• Layer resource now includes hasZ and hasM to indicate if the layer geometry contains Z and M values, respectively.
• Layer resource now includes isDataVersioned if the layer is versioned.
• Layer resource now includes hasLiveData, which returns a Boolean value. This value is true if the layer's data is updated frequently.
• Layer resource now includes effectiveMinScale and effectiveMaxScale, which represent the effective minimum and maximum scales at which the layer is visible.
• Layer resource now returns role, cardinality, keyField, composite, relationshipTableId, and keyFieldInRelationshipTable properties for relationships.
• The query operation on a Layer resource has three new parameters: orderByFields, outStatistics, and groupByFieldsForStatistics.
• The identify, find, query, queryRelatedRecords operations and feature resource accept two new parameters: returnZ and returnM to determine if the returned geometry would contain Z and M values respectively.
• The export, identify, find, query, queryRelatedRecords and generateRenderer operations and feature, attachment and html popup resources support the gdbVersion parameter. Use this parameter to specify an alternate geodatabase version.
• The identify, find, query, and queryRelatedRecords operations return an optional exceededTransferLimit property when the number of records returned by the operation exceeds the maximum number configured by the server administrator.
• TextSymbol has four new properties: text, borderLineSize, haloColor, and haloSize.
• The ClassBreaks renderer object has classificationMethod, normalizationField, normalizationType, normalizationTotal, defaultSymbol, backgroundFillSymbol, and classMinValue.
• The LabelClass object has a new whereproperty. Use this to determine the features that are labeled with the label class that defines it.

Image service

• The following new operations are now supported:Add Rasters, Update Raster, Delete Rasters, Measure, and Compute Histograms.
• Image Server resource supports the following child resources: Tile, Raster Attribute Table, Colormap, Histograms, Key Properties, and Uploads.
• Raster catalog item info supports the following child resources: Metadata, Thumbnail, Raster Info, and Key Properties.
• Image Service resource has a new input parameters option and outSR to support viewing of an image service footprint in arcgis.com map.
• Image Server resource now includes initialExtent, fullExtent, singleFusedMapCache, and tileInfo properties that indicate cache information of the service.
• Image Server resource now includes defaultMosaicMethod, mosaicOperator, defaultCompressionQuality, and defaultResamplingMethod properties that indicate service defaults. The default mosaic rule is composed of defaultMosaicMethod and mosaicOperator. When defaultMosaicMethod is esriMosaicAttribute, Image Server uses sortField and sortValue along with it.
• Image Server resource now includes allowRasterFunction, allowedMosaicMethods, maxRecordCount, maxImageHeight, maxImageWidth, maxDownloadImageCount, maxDownloadSizeLimit, and maxMosaicImageCount properties that indicate service constraints.
• Image Server resource now includes rasterFunctionInfosr, rasterTypeInfos, and mensurationCapabilities properties that indicate supported raster function templates (for exportimage), raster types (for add/update rasters), and mensuration capabilities (for mensuration).
• Image Server resource now includes hasHistograms, hasColormap, and hasRasterAttributeTable properties that indicate if a corresponding resource is available for the service.
• Image Server resource now includes capabilities properties that indicate supported operations.
• Image Server resource now includes editFieldsInfo and ownershipBasedAccessControlForRasters JSON objects containing editor tracking and access control related properties.
• Image Server Raster File resource supports a new rasterId parameter.
• Image Server Identify operation supports a few new parameters: time, renderingRule, returnGeometry, and returnCatalogItems.
• Image Server Export Image operation supports a new noDataInterpretation parameter.
• Image Server Export Image operation supports new well-known raster functions (Convolution, Remap, Clip, BandArithmetic, and Geometric) and customized raster function template in the renderingRule parameter.
• Image services now support WMTS resource for tiled image services. WMTS resource supports WMTS Capabilities and WMTS Tile child resources.