ArcGIS API for JavaScript ^3.26

The following are new features in version 1.4 of the ArcGIS JavaScript API.

Microsoft Virtual Earth maps and geocoding

Version 1.4 allows for connections to Microsoft Virtual Earth map layers and geocoding. The Virtual Earth road and aerial maps can add detailed context to your Web applications, while the Virtual Earth geocoder can place points on the map from addresses or place names.

Virtual Earth services require a subscription, as well as an extra page configured on your Web server that allows you to get authentication tokens.

New classes include:

• VETiledLayer
• VEGeocoder
• VEAddress
• VEGeocodeResult

Routing

The ArcGIS JavaScript API can now work with ArcGIS Server network analysis services to find routes and driving directions. The routing is done through the new Route Task and its associated classes. The Route Task makes it easy to do simple point-to-point routing and get driving directions. Because ArcGIS Network Analyst does the routing work on the server, you can also do complex routing that avoids barriers, complies with time windows, and finds the best path to multiple stops.

New classes include:

• RouteTask
• RouteResult
• DirectionsFeatureSet
• RouteParameters
• DataLayer
• NAOutputLine
• NAUTurn

Renderers

A renderer defines how you symbolize a set of graphics. Previously with the ArcGIS JavaScript API, you had to symbolize each graphic separately as it was added to the map. Now you can choose to do the work with renderers that automatically supply symbology based on attributes in your data. The simple renderer, unique value renderer, and class breaks renderer included with Version 1.4 make it easier to do thematic mapping with the ArcGIS JavaScript API. For more information, see Symbolizing graphics with renderers.

New classes include:

• Renderer
• SimpleRenderer
• UniqueValueRenderer
• ClassBreaksRenderer

Multiple graphics layers

Version 1.4 supports multiple graphics layers in the map, which makes it much easier to organize different types of graphics. For example, you can put polygon graphics representing counties in one graphics layer and point graphics representing traffic incidents in another graphics layer. Then you can easily add or remove either layer as needed.

Updated classes include:

• GraphicsLayer: includes new constructors. Also added renderers property.
• Map: added graphicsLayerIds property. Other changes include the first parameter in reorderLayer is Layer instead of id; the addLayer method returns Layer.

Updates to Geometry classes

The following updates were made to the Geometry classes:

• Geometry: setSpatialReference method returns Geometry.
• Point: new method update; setX and setY methods return Point.
• Multipoint: addPoint method returns Multipoint.
• Polyline: new methods insertPoint and setPoint; addPath method returns Polyline.
• Polygon: new methods insertPoint and setPoint; addRing method returns Polygon.
• Extent: update method returns Extent.

Changes to namespace classes

The following changes were made to namespace classes:

• esri.geometry namespace: new methods geographicToWebMercator, getScale, and webMercatorToGeogrpahic.
• esri.Units: new class containing constants representing units of measure.

dojo.Deferred added as the return object to asynchronous task methods

The return object dojo.Deferred was added to asynchronous task methods. This object monitors the status of a request and manages the communication of asynchronous threads. Classes that have methods that return dojo.Deferred object include:

• FindTask
• GeometryService
• Geoprocessor
• IdentifyTask
• Locator
• QueryTask
• RouteTask
• VEGeocoder

Performance improvements

Performance improvements in drawing vector graphics in Internet Explorer. Drawing graphics with polygons is approximately twice as fast at 1.4 as compared to earlier versions of the API.

Support for Dojo 1.3.1

When you reference the ArcGIS JavaScript API in your code, you also get a reference to version 1.3.1 of the Dojo Toolkit.

Bug fixes

The following are the identification numbers and summaries for bug fixes and enhancements in version 1.4:

• NIM042985: Map navigation operations cause excessive memory consumption in the JavaScript API versions 1.2 and 1.3 when using Internet Explorer 7.
• NIM043335: Cache PNG32 image shows with wrong background in Internet Explorer 6.
• NIM043427: Custom PictureMarkerSymbol disappears when zooming in when using Internet Explorer.
• NIM043431: Visibility of the Dynamic MapService layer freezes when it's display is toggled too quickly.