ArcGIS API for JavaScript (legacy) ^3.46

Scale driven sizing for polygon markers and outlines

Easily define renderers that calculate symbol size based on attribute values as well as map scale. Applies to polygon markers and polygon outline width.

• The createSizeRenderer method supports the following values for its optimizeForScale parameter. For example, map-scale or true indicates that the size range is optimized only for the current map scale. Next, visible-scale-range indicates that the range is optimized for all scales in the layer's visible scale range.
• Added support for sizeInfo.stops. Each stop has value and size properties.
• Added support for sizeInfo.expression.
• Added support for sizeInfo.minSize and sizeInfo.maxSize to be an actual SizeInfo object itself.

BlendRenderer

A new BlendRenderer class was added. BlendRenderer allows you to easily identify a predominant attribute of a feature among two or more competing attributes. For example:

• What is the most predominant pet in an area? Dogs or cats?
• What is the most predominant type of household in a neighborhood? Owner-occupied or renter-occupied?

Each attribute is assigned a unique color. The value of the color's opacity is calculated based on the value of that attribute for a given feature. Meaning the higher the attribute value, the more dominant the attribute becomes.

Layer list widget

The LayerList widget allows users to turn layers on and off. NOTE: This is currently in beta.

Elevation profile widget

The Elevation profile widget allows users to view an elevation profile along a path. NOTE: This is currently in beta.

Support for OGC Web Feature Services

The Open Geospatial Consortium Web Feature Service Interface Standard (WFS) provides an interface allowing requests for geographical features across the web using platform-independent calls. For more information about the Web Feature Service, see the following Wikipedia article, and the OGC Web Feature Service home page. For more details, see the WFSLayer API Reference (beta at version 3.14) and the WFSLayer sample.

Extend Operations Dashboard

Developers and partners can write new widgets, map tools, and feature actions for Operations Dashboard using ArcGIS API for JavaScript. Administrators can add extensions to their organizations for publishers to use inside of their operation views.

DataReviewer

A new series of tasks that work to integrate data quality control features into your application. These tasks leverage ArcGIS Data Reviewer for Server capabilities allowing you to implement:

• automated validation of data using rules authored in ArcMap
• data quality reporting that highlights issues in your data
• workflows that let you identify data errors using redlining and mark-up tools
• workflows that let you track and report errors through an iterative correction process

See the Working with DataReviewer help topic and the ArcGIS Resource Center to learn more about using ArcGIS Data Reviewer.

Directions widget changes

The 3.14 Directions widget has been migrated to use the Search widget. In order to feed a custom geocoder/feature services into this widget, use the new searchOptions property.

GeometryEngine changes

Prior to 3.14, the unit parameter in several GeometryEngine methods, such as buffer(), geodesicArea(), offset(), etc. required a number value from this list. While these numbers are still supported, all unit parameters in these methods can take string values (e.g. "miles", "meters", "square-feet", etc.) starting in version 3.14. This should make using and reading geometryEngine methods easier. See the documentation for more details.

Starting with 3.14, the input arrays for geometries and buffer values in GeometryEngine.buffer() and GeometryEngine.geodesicBuffer() do not have to be the same length. Refer to the documentation for additional details.

Image server related changes

• RasterLayer class is no longer in beta.
• Two new methods added to RasterLayer, setImageFormat and setUseMapTime.
• PixelBlock class is no longer in beta.
• A new OPERATION_SUM constant added to MosaicRule.
• A new ImageServiceMeasureTask class was added.
• A new ImageServiceMeasureParameters class was added.
• A new ImageServiceMeasureTool class was added.
• A new ImageServiceMeasure class was added.
• A new ImageSpatialReference class was added.
• A new beta ObliqueViewer widget was added.

New locales

• Version 3.14 adds support for Traditional Chinese (Taiwan) (language code "zh-tw"). Add the following line snippet to any code sample to see it in Traditional Chinese (Taiwan).

  <script> var dojoConfig = {locale: "zh-tw"}; </script>

• Version 3.14 adds support for Traditional Chinese (Hong Kong) (language code "zh-hk"). Add the following line snippet to any code sample to see it in Traditional Chinese (Hong Kong).

  <script> var dojoConfig = {locale: "zh-hk"}; </script>

API enhancements

• esri/dijit
  • New class ElevationProfile (beta)
  • New class ImageServiceMeasure
  • New class LayerList (beta)
  • New class ObliqueViewer
• New class ImageSpatialReference
• New class ImageServiceMeasureParameters
• New class ImageServiceMeasureTask
• New class BlendRenderer
• New class ImageServiceMeasureTool
• esri/opsdashboard
  • New class DataSourceProxy
  • New class ExtensionBase
  • New class ExtensionConfigurationBase
  • New class FeatureActionConfigurationProxy
  • New class FeatureActionFeatures
  • New class featureActionProxy
  • New class GraphicsLayerProxy
  • New class MapToolConfigurationProxy
  • New class MapToolProxy
  • New class MapWidgetProxy
  • New class WidgetConfigurationProxy
  • New class WidgetProxy
• New class WFSLayer (beta)
• esri/tasks/datareviewer
  • New class BatchValidationJob
  • New class BatchValidationJobInfo
  • New class BatchValidationParameters
  • New class BatchValidationTask
  • New class DashboardResult
  • New class DashboardTask
  • New class GetResultsQueryParameters
  • New class ReviewerAttributes
  • New class ReviewerFilters
  • New class ReviewerLifecycle
  • New class ReviewerResultsTask
  • New class ReviewerSession
  • New class SessionOptions
• New constant OPERATION_SUM on class MosaicRule
• New constants DEFAULT_CURVE_EXTENSION, KEEP_END_ATTRIBUTES, NO_END_ATTRIBUTES, NO_EXTEND_AT_FROM, NO_EXTEND_AT_TO, RELOCATE_ENDS on class TrimExtendParameters
• New properties showCloseIcon, showSelectAnalysisLayer on class AggregatePoints
• New properties showCloseIcon, showSelectAnalysisLayer on class CalculateDensity
• New properties showCloseIcon, showSelectAnalysisLayer on class ConnectOriginsToDestinations
• New properties showCloseIcon, showSelectAnalysisLayer on class CreateBuffers
• New properties showCloseIcon, showSelectAnalysisLayer on class CreateDriveTimeAreas
• New properties showCloseIcon, showSelectAnalysisLayer on class CreateViewshed
• New properties showCloseIcon, showSelectAnalysisLayer on class CreateWatersheds
• New properties showCloseIcon, showSelectAnalysisLayer on class DeriveNewLocations
• New properties showCloseIcon, showSelectAnalysisLayer on class DissolveBoundaries
• New properties showCloseIcon, showSelectAnalysisLayer on class EnrichLayer
• New properties showCloseIcon, showSelectAnalysisLayer on class ExtractData
• New properties showCloseIcon, showSelectAnalysisLayer on class FindExistingLocations
• New properties showCloseIcon, showSelectAnalysisLayer on class FindHotSpots
• New properties showCloseIcon, showSelectAnalysisLayer on class FindNearest
• New properties showCloseIcon, showSelectAnalysisLayer on class FindSimilarLocations
• New properties showCloseIcon, showSelectAnalysisLayer on class InterpolatePoints
• New properties showCloseIcon, showSelectAnalysisLayer on class MergeLayers
• New properties showCloseIcon, showSelectAnalysisLayer on class OverlayLayers
• New properties showCloseIcon, showSelectAnalysisLayer on class PlanRoutes
• New properties showCloseIcon, showSelectAnalysisLayer on class SummarizeNearby
• New properties showCloseIcon, showSelectAnalysisLayer on class SummarizeWithin
• New properties showCloseIcon, showSelectAnalysisLayer on class TraceDownstream
• New property editToolbar on class Editor
• New property overviewMap on class OverviewMap
• New property travelMode on class ClosestFacilityParameters
• New property showLabels on class PrintTemplate
• New property travelMode on class RouteParameters
• New property travelMode on class ServiceAreaParameters
• New methods setImageFormat(), setUseMapTime() on class RasterLayer
• New method getLatestObservations() on class StreamLayer
• New method getServiceDescription() on class ClosestFacilityTask
• New method getServiceDescription() on class RouteTask
• New method getServiceDescription() on class ServiceAreaTask
• Editor widget has a public editToolbar property, providing access to the widget's Edit toolbar.

New samples

• BlendRenderer
  • Minority demographics
  • Los Angeles housing status
  • Lawrence, KS by age and population size
• Smartmapping
  • Lawrence, KS by age and population size
• DataReviewer
  • Data reviewer samples no longer available as of February 2022.
• Elevation profile widget
  • User-specified input geometry
• Layer list widget
  • Layer list widget
• Search widget
  • Search using a suggestion template
• WFS layer
  • WFS layer

Bug fixes

• BUG-000086204: Fixed an IE10 and IE11 issue when editing vertices and snapping to line/polygon features didn't work correctly.
• BUG-000085838: Fixed an issue where polar projection coordinates displayed incorrectly when using the measurement widget.
• NIM094815: The mouse-drag event now works correctly using IE10 and IE11.
• NIM101882/BUG-000085005: Draw tools now creates the starting vertex point at the correct position using IE10 and IE11.
• BUG-000083753: Using IE10 or IE11, there is no longer an additional vertex added when creating a polyline or polygon.
• BUG-000086260: Fixed an issue where if two or more KML layers overlapped one another, the layers did not display correctly.
• BUG-000085097: Fixed an issue where searching for features would fail if the service used did not support pagination.
• NIM102402: Fixed an issue where if using a map image layer, it would change position when panning using specific mouse buttons.
• BUG-000087742: Fixed an issue where fields with coded value domains showed "required" even if the field was nullable.
• BUG-000087358: Fixed an issue where using cacheBust:true rendered SimpleFillSymbol incorrectly.
• BUG-000087174: Fixed an issue where it was not possible to create multiple KML layers.
• BUG-000087251: It is now possible to add and edit features using the Editor toolbar if the map contains a WMTS layer.
• BUG-000086146: Fixed an IE11 issue where tiles would not load while panning unless mouse button is released.
• BUG-000086150: Fixed an an issue specific to 3.13 where legends would fail if using JSON data.
• BUG-000085436: Fixed an issue where polyline vertexes were showing multiple endpoints when using IE11.
• BUG-000084867: Fixed an issue where using the Esc key would result in an "uncaught type error" while aborting a sketch.
• BUG-000084429: Fixed an issue where if using Chrome, the mouse would remain in Pan mode.
• BUG-000086624: Fixed an issue where clicking the edge of the map causes the InfoWindow to be displayed.
• BUG-000087378: Fixed an issue where a feature's geometry display was affected in the map viewer if the query request uses the quantization parameter.
• ENH-000084434: A default symbol value is now used in renderers if the normalization field value is zero.
• Editing:
  • BUG-000086767: Fixed an issue where editing always applied attributes from the first edited feature on subsequent edits.
  • NIM102567: Editors can now add attachments to hosted feature services.
• Map resizing:
  • NIM099625: Fixed an issue where hidden maps became corrupt after map auto-resize.
  • NIM091498: Fixed an issue where map disappeared when the view and orientation of iPad/iPhone and Android was changed.
  • BUG-000087082: Fixed an issue where map with vertical scroll bar drew at a wrong position using 'Draw' toolbar when map is scrolled.
• Documentation:
  • BUG-000086784: Corrected API documentation to state that add() is not supported with FeatureLayer or LabelLayer classes.
  • BUG-000087582: Fixed BasemapToggle documentation to reflect the correct object property names for basemaps property.
  • BUG-000086608: Fixed broken sample to now work as described.

Web Optimizer changes and enhancements

• Now includes options for put-selector, and xstyle packages in the user-interface.
• Provide user feedback when logging in with an invalid account such as a public account. See prerequisites
• Updates to support locales Thai (th), Turkish (tr), Traditional Chinese (Taiwan) (zh-tw), Traditional Chinese (Hong Kong) (zh-hk).

Additional Resources on GitHub

Use the repository on GitHub for the JS API TypeScript definitions.

Additional packages

Version 3.14 of the ArcGIS API for JavaScript includes Dojo 1.10.4, dgrid version 0.3.17, dstore version 1.1.0, put-selector version 0.3.6 and xstyle version 0.1.3. The dstore package inclusion is new for 3.14.