What's New in the Latest Release

Current release: 10.11

10.11

What's new in the ArcGIS REST API for 10.1 SP1

General:

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

Map Service Changes:

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

Feature Service Changes:

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

Image Service Changes:

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

GP Service Changes:

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

Globe Service Changes:

Globe Tile resource is newly supported.

10.1

What's new in the ArcGIS REST API for 10.1

Map Service Changes:

Map services now support Dynamic Layer resource. Dynamic layers support query, queryRelatedRecords, and generateRenderer operations.
Map services now support WMTS resource for tiled map services. WMTS resource supports WMTS Capabilities and WMTS Tile child resources.
Export Map, Identify, Find operations and Legend, All Layers / Tables resources support a new dynamicLayers parameter.
Map Service resource supports a new parameter returnUpdates that accepts a boolean value. Pass this parameter to retrieve updated information from the map service.
Map Service resource has new input parameters option and outSR to support viewing of a map service footprint in arcgis.com map.
Map Service resource now includes maxRecordCount, maxImageHeight, maxImageWidth, minScale, maxScale, hasVersionedData, supportsDynamicLayers property that indicates if a service supports dynamic layers, tileServers property that advertises multiple sub domains on a map service endpoint, and supportedQueryFormats that indicates the supported query operation output formats.
Map Service resource now includes new properties under timeInfo - timeRelation, defaultTimeInterval, defaultTimeIntervalUnits, defaultTimeWindow, and hasLiveData.
hasLiveData returns a boolean value. If true, export and identify operations will default the value for 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 parameter returnUpdates that accepts a boolean value. Pass this parameter to retrieve updated information from the layer.
Layer resource now includes the property maxRecordCount that represents the maximum number of records that can be returned by find, identify, and query operations.
Layer resource now includes canModifyLayer property to indicate if a layer's renderer, data source, or join information can be modified.
Layer resource now includes supportsStatistics property to indicate if query operations support statistical functions and 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 that returns a boolean value. This value is true if the layer's data gets 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, isComposite, relationshipTableId and keyFieldInRelationshipTable properties for relationships.
query operation on a Layer resource has 3 new parameters: orderByFields, outStatistics, and groupByFieldsForStatistics.
Operations: identify, find, query, queryRelatedRecords and resource: feature accept two new parameters - returnZ and returnM to determine if the returned geometry would contain Z and M values respectively.
Operations: export, identify, find, query, queryRelatedRecords and generateRenderer, and resources: feature, attachment and html popup support gdbVersion parameter. Use this parameter specify an alternate geodatabase version.
Operations: identify, find, query, and queryRelatedRecords return an optional property exceededTransferLimit when the number of records returned by the operation exceeds the maximum number configured by the server administrator.
TextSymbol has 4 new properties - text, borderLineSize, haloColor, haloSize.
ClassBreaks renderer object has classificationMethod, normalizationField, normalizationType, normalizationTotal, defaultSymbol, backgroundFillSymbol and classMinValue.
LabelClass object has a new property - where. Use this to determine the features that are labeled with the label class that defines it.

Image Service Changes:

The following new operations are now supported:
Add Rasters Update Raster Delete Rasters Measure Compute Histograms
Image Server resource newly supports the following child resources:
Tile Raster Attribute Table Colormap Histograms Key Properties Uploads
Raster catalog item info supports the following child resources:
Metadata Thumbnail Raster Info Key Properties
Image Service resource has new input parameters option and outSR to support viewing of a image service footprint in arcgis.com map.
Image Server resource now includes initialExtent, fullExtent, singleFusedMapCache, tileInfo properties that indicate cache information of the service.
Image Server resource now includes defaultMosaicMethod, mosaicOperator, defaultCompressionQuality, defaultResamplingMethod properties that indicates service defaults. The default mosaic rule is composed of defaultMosaicMethod and mosaicOperator. When defaultMosaicMethod is esriMosaicAttribute, image service uses sortField and sortValue along with it.
Image Server resource now includes allowRasterFunction, allowedMosaicMethods, maxRecordCount, maxImageHeight, maxImageWidth, maxDownloadImageCount,maxDownloadSizeLimit, maxMosaicImageCount properties that indicates service contraints.
Image Server resource now includes rasterFunctionInfos, rasterTypeInfos, 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, hasRasterAttributeTable properties that indicate if a corresponding resource is available for the service.
Image Server resource now includes capabilities properties that indicates 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, 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, Geometric) and customized raster function template in renderingRule parameter.
Image services now support WMTS resource for tiled Image services. WMTS resource supports WMTS Capabilities and WMTS Tile child resources.

Network Analysis Service Changes:

Closest facility operation now supports timeOfDay and timeOfDayUsage parameters.
Service area operation now supports timeOfDay and useHierarchy parameters.
CompressedGeometry returned by Route and Closest facility operations is capable of containing M- and Z- values.
Route and Closest facility operations have a new directionsOutputType parameter.
Route, Closest facility and Service area operations now support an optional url property to specify input locations.
Route, Closest facility and Service area operations now support a new esriNAOutputLineTrueShapeWithMeasure value for outputLines.
Route, Closest facility and Service area operations now support a new returnZ parameter.
Network layer resource now includes hasZ and hasM properties to indicate if it is Z or M aware.

Feature Service Changes:

Feature Service supports the following service level operations:
Query Apply Edits Create Replica Synchronize Replica Unregister Replica
Feature Service now supports the layer resource operation Generate Renderer.
Feature Service resource now includes maxRecordCount, hasVersionedData, allowGeometryUpdates, supportsDisconnectedEditing and supportedQueryFormats properties.
Feature Service resource property capabilities now returns additional Create, Delete, Update and Uploads capabilities.
Feature Service resource has new input parameters option and outSR to support viewing of a feature service footprint in arcgis.com map.
In Layer resource fields have an additional nullable property.
Layer resource now includes editFieldsInfo property about editor tracking fields.
Layer resource now includes ownershipBasedAccessControlForFeatures property of a layer which includes allowOthersToUpdate and allowOthersToDelete properties.
Layer resource now includes defaultVisibility, maxRecordCount, syncCanReturnChanges, isDataVersioned, supportsRollbackOnFailureParameter, supportedQueryFormats, hasZ and hasM properties.
Layer resource now returns role, cardinality, keyField, composite, relatedTableId and keyFieldInRelatedTable properties for relationships.
Feature Service resource Query and Layer resource Query now support maxAllowableOffset, geometryPrecision, orderByFields, groupByFieldsForStatistics, outStatistics, gdbVersion, returnZ and returnM parameters.
Query Related Records now supports maxAllowableOffset, geometryPrecision, gdbVersion, returnZ and returnM parameters.
Apply Edits, Add Features, Update Features, Delete Features, Add Attachment, Update Attachment and Delete Attachments operations now support gdbVersion parameter.
Apply Edits, Add Features, Update Features, Delete Features and Delete Attachments operations now support rollbackOnFailure parameter.
Feature, Attachment Infos, Attachment and HTML Popup resources now support gdbVersion parameter.
Feature resource now supports returnZ and returnM parameters.
Feature Service resource now includes the property enableZDefaults for a service configured with default Z values.
Layer resource now includes effectiveMinScale and effectiveMaxScale, which represent the effective minimum and maximum scales at which the layer is visible.

GP Service Changes:

GP Service resource now includes maximumRecords and currentVersion properties.
All GP Data types are now supported in a GPMultiValue.
If a GP service is associated with a result map service, the GP Result can be accessed directly using the associated map service resource.
Cancel job operation is newly supported. This operation can be used to cancel an asynchronous GP job before it is completed.
For GP Services that support uploads, you can specify an uploaded item as input to GPDataFile and GPRasterData.
submitJob, execute operations and GP Result resource now support returnZ and returnM parameters.
GPDataFile and GPRasterData now supports input using itemID of an uploaded item.
GPFeatureRecordSetLayer now returns hasZ and hasM properties if the feature geometry contains Z and M values.
GPFeatureRecordSetLayer and GPRecordSet returns fields property for the fields in the response.

Gecode Service Changes:

Geocode Addresses operation is newly supported. This operation can be used to perform batch geocoding.
Find Address Candidates operation supports a new searchExtent parameter.
Geocode Service resource now returns the name of participating locators for geocode services published using a composite locator.

Geometry Service Changes:

Project operation now supports datum transformation using transformation and transformForward input parameters.
Buffer operation now supports geodesic buffering.
Areas and Lengths operation now supports a new calculationType parameter.
Lengths operation now supports a new calculationType parameter. The geodesic parameter is deprecated.
The following operation will call Simplify on the input geometries: Auto Complete, Buffer, Cut, Difference, Intersect, Label Points, Offset, Project, Relation, Reshape and Union.
The following operation call Simplify on the input geometry under specific conditions: Areas and Lengths, Densify and Distance.

Schematic Service:

Schematic Service is a new service introduced at 10.1 for displaying, generating, updating, and laying out schematic diagrams.

Printing Tools:

Export Web Map task is newly added in 10.1. This task is part of a pre-configured Printing tools GP Service.

General:

You can now view footprints of Map Service, Image Service, Feature service and folder resources in ArcGIS.com map by clicking on the View Footprint in ArcGIS.com link in the Services Directory.
Server Info resource now returns shortLivedTokenValidity and fullVersion.
geometry containing Z and M values are now supported. Also featureSet may contain hasZ and hasM properties to indicate if its geometry contains Z or M values.
Spatial Reference Object defined using a well-known ID now includes an additional latestWkid property.
Spatial Reference Object defined using a well-known ID can optionally include a definition of Vertical Coordinate System (VCS) using vcsWkid and latestVcsWkid properties.
Item Info, Thumbnail and Metadata resources are now supported in Map Service, Geocode Service, GP Service, Geometry Service, Image Service, Globe Service and Geodata Service.
Uploads resource is now supported in GP Service, Image Service, Geodata Service, Feature Service and Mobile Service. This is the parent resource for upload related operations and resources.
Uploads Info resource returns maxUploadFileSize property of a service.
You can configure cross-origin access setting for ArcGIS Server using the allowedOrigins property in rest configuration file.

REST API Admin Changes:

From 10.1 onwards the REST API administrative endpoint http://<host>:<port>/<instance>/arcgis/rest/admin is no longer supported. The REST Admin tasks are now supported in the ArcGIS Server's Admin API (http://<host>:<port>/<instance>/admin/system/handlers/rest).

10 SP2

What's new in the ArcGIS REST API for 10.0 SP2

Image Service ExportImage operation now supports RGB color value as input to nodata.

10 SP1

What's new in the ArcGIS REST API for 10.0 SP1

Map services now support a Map Service Legend resource.
Map, Feature and Image service's Query operation supports a returnCountOnly parameter.
The following json responses now have an additional property currentVersion indicating the current version of the REST handler.
- Map Server resource and Map Server layers/tables.
- Individual layers/tables in the All Layers resource.
- Feature Server resource and Feature layers.
- Image Server resource.
- Geocode Server resource.
- Network Service resource and Network layers.

The Map Service resource now includes scale information (minScale and maxScale) for layers.

What's new in the ArcGIS REST API for 10

Map Service Changes:

The Map Service resource now supports standalone tables in addition to layers.
The layer resource now represents either a table or a layer.
The layer / table response now includes information regarding the relationships it participates in.
The layer / table response now includes its domains and sub-types.
The layer / table response now includes its renderer and labeling info for feature layers.
The query operation can now return only the object / feature IDs in addition to returning a featureset. Clients can accomplish "paging" with this functionality.
The query operation now supports querying based on objectIds.
The query operation now supports f=amf.
The query operation now supports a new spatial relationship esriSpatialRelRelation and an associated relationParam.
The query operation now returns additional fields array (JSON and AMF only) that contains array of field information for returned values.
The query, identify and find operations now support generalizing the output geometry when the maxAllowableOffset parameter is set.
A new query related records operation has been added.
A new feature resource has been added.
Time-aware map services and layers are now supported
- Map Service: includes a new timeInfo property in the response
- Layer: includes a new timeInfo property in the response
- Export Map: supports new time and layerTimeOptions parameters
- Identify: supports new time and layerTimeOptions parameters
- Query: supports a new time parameter
Features can now have attachments
- Layer: includes a new hasAttachments property in the response
- New attachment infos and attachment resources have been added.
- New HTML popup resource returns information about the HTML popup associated with a feature.
A new resource has been added to get all layers and tables in a map service.
Identify and Find operations now support a new layerDefs parameter. The Export operation supports a new JSON syntax for the layerDefs parameter.

Feature Service:

This is a new service introduced at 10 for editing features and records.
The Feature Service resource publishes editable layers and tables.
The layer resource represents the editable layer or table.
The query and query related records operations can be performed on layers and tables.
The query operation now supports a new spatial relationship esriSpatialRelRelation and an associated relationParam.
The add, update, delete and apply edits operations can be used for editing features.
The feature resource represents a feature in a layer or table.
The attachment infos resource returns information about attachments associated with a feature.
The attachment resource represents an individual attachment associated with a feature.
The HTML popup resource returns information about the HTML popup associated with a feature.
The add attachment, update attachment and delete attachments operations can be used for editing attachments.

Geometry Service Changes

The following new operations were added:
Convex Hull Densify Distance Generalize Offset Trim / Extend Autocomplete Cut Difference Intersect Reshape Union
The Lengths operation now supports units and geodesic distances.
The Areas and Lengths operation now supports lengthUnit and areaUnit parameters.

Network Analysis Service Changes

A new solve closest facility operation has been added.
A new solve service area operation has been added.
The solve route operation now supports the following new parameters: attributeParameterValues, polylineBarriers and polygonBarriers

Image Service Changes:

The Image Service resource now returns the accessible fields of the image service.
The Export Image operation now supports a new mosaicRule parameter. The mosaicProperties and viewpointProperties parameters have been deprecated.
The Export Image operation now supports a new renderingRule parameter.
The Export Image operation now supports a new jpgpng format.
A new query operation has been added to query the raster catalog.
A new download rasters operation and raster file resource have been added.
New raster catalog item, raster image, raster thumbnail and raster info resources have been added.
The Image Server query and export operations, now support an additional time parameter.
The Image Server supports a new identify operation.

GP Service Changes

Support for a new GPMultiValue data type has been added. It is supported both as an input parameter as well as a result parameter. Both submit job and execute operations support GPMultiValue parameters.
The GPDate input parameter for the submit job and execute operations now accepts a numeric input - the number of milliseconds since epoch (January 1, 1970) in UTC. The original JSON structure input for GPDate parameters has been deprecated.
The GPDate result parameter for the submit job and execute operations is now a number - the number of milliseconds since epoch (January 1, 1970) in UTC. The original string representation for GPDate result parameters has been deprecated.

Geocode Service

Find Address Candidates supports a new outSR parameter that enables clients to specify an output spatial reference.
Locators published using ArcGIS 10 support a new single line address field.
Reverse Geocode supports a new outSR parameter that enables clients to specify an output spatial reference.

Mobile Service:

The standalone mobile service was introduced at 10.
The Mobile Service and Mobile Layer resources can be viewed in the Services Directory.

Service Extensions:

Support for REST-enabled service extensions was introduced at 10.
Currently, REST only supports extensions to map services.

Spatial Reference Objects now support wkt in addition to wkid.

Resources and operations that support spatial references as input, now support this object as well.
These resources and operations include:
Export Map, Identify, Find, Query Layer, Execute Task, Submit Job, GP Result, Export Image, Solve Route as well as all Geometry Service operations.

Programmatic access to the REST Admin:

Server Info:

Server Info Resource

9.3.1

What's new in the ArcGIS REST API for 9.3.1

The Solve Route operation added to the Route Network Layer:

Solve Route

The following resources / operations have undergone a few changes:

Catalog: currentVersion property in the catalog response. The value of currentVersion for the 9.3.1 release will be 9.31
Map Service: supportedImageFormatTypes property in the map service response
Export Map: Export maps in the png32 format for map services that include PNG32 in their supportedImageFormatTypes property

9.3 SP1

What's new in the ArcGIS REST API for 9.3 SP1

The following operations were added to the Geometry Service:

The following resources / operations have undergone a few changes:

Catalog: sitemap and geositemap formats are supported
GP Result: exceededTransferLimit property in a GPRecordSet response
GP Task: executionType property in the GP Task response
Project: esriGeometryEnvelope geometry type is supported as input