Hide Table of Contents
What's New archive
What's new in Version 1.2

The following are new features in the ArcGIS JavaScript API version 1.2:

Support for Image Services

You can add ArcGIS Server Image Services to the map using ArcGISImageServiceLayer. Image services represent file-based raster datasets or raster collections published with the ArcGIS Server Image extension. You can control the image type, compression type for JPG, image bands, and interpolation type.

Support for Dojo 1.2.

When you reference the ArcGIS JavaScript API in your code, you also get a reference to version 1.2 of the Dojo Toolkit. See the Dojo 1.2 Release Notes for migration information and a full list of improvements.

More flexibility with cached and dynamic layers

You can now define which tile levels of a cached service are exposed in the map. For example, you may want to use ArcGIS Online data for small scales only, then switch to your own cached data at large scales. Or you may want to make a cached service available at large scales only in order to focus the map on a certain geographic area.

You can also force dynamic maps to conform to the scale levels in a tiling scheme. This allows you to show a cached map at small scales, then easily switch to a dynamic map at large scales.

Refreshable map layers

Map service layers have a refresh() method. This is useful if back-end editors are modifying the data and you want to ensure the end user of the application sees the most recent data from the server.

Improved graphics performance

The performance of the graphics layer is improved when adding a large number of graphics to the map.

Projection of dynamic map services on the fly

Dynamic map services can be projected on the fly to match the spatial reference you set for the map. Previously, the spatial reference was defined by the base layer. Now the map can be defined using any spatial reference. Valid only with dynamic map layers.

New methods for the geometry service

GeometryService has new methods that allow for creating points in polygons for labeling purposes, and determining spatial relations of geometries. These geometries do not have to come from a map service; they can be geometries returned from a task or a query to a non-ArcGIS Web service.

Changes to the ArcGIS JavaScript API version 1.2


  • New properties: disableCilentCaching, layerDefintions, useJSON, visibleLayer
  • New properties moved from ArcGISMapServiceLayer: copyright, description, layerInfos, units
  • New methods: setDisableClientCaching
  • New constructor options: imageParameters, useMapImage
  • The imageParameters parameter in exportMapImage is optional.


  • New class



  • New constructor option: displayLevels
  • New properties moved from ArcGISMapServiceLayer: copyright, description, layerInfos, units


  • New class


  • Added Constants Table
  • New methods: labelPoints, relation
  • New events: onLabelPointsComplete, onRelationComplete


  • New class


  • New property moved from ArcGISMapServiceLayer: url
  • New events: onUpdate


  • New constructor option: lods
  • New properties: isShiftDoubleClickZoom
  • New methods: centerAndZoom, disableShiftdoubleClickZoom, enableShiftDoubleClickZoom
  • Change in behavior: "double click zoom" (disableDoubleClickZoom, enableDoubleClickZoom) previously required using the shift key. This is no longer the case. If you want to continue using "shift double click zoom" use enableShiftDoubleClickZoom/disableShiftDoubleClickZoom instead.


  • New class

esri namespace

  • New properties: version
  • New methods: filter
Show Modal