esri.dijit.ImageServiceMeasure
This widget allows you to perform measurements on image services. It only supports services with mensuration support. Mensuration is a method of applying geometric rules to find the lengths of lines, areas of surfaces, or volumes using information obtained from lines and angles. It can also include measuring the height and absolute location of a feature.
Any Image service with a georeferenced raster dataset can provide distance, area, point and centroid locations. Height measurements can be obtained when a sensor model exists. Sun angle information is required to make measurements using the shadows.
This widget includes the following tools:
This widget contains an instance of the ImageServiceMeasureToolbar in the measureToolbar property. This property exposes the methods and events available in the ImageServiceMeasureToolbar to an instance of this widget so you can work with the result of the measure operation programmatically.
Name | Summary |
---|---|
new esri.dijit.ImageServiceMeasure(params, srcNode) | Creates an instance of the ImageServiceMeasure widget. |
esri/dijit/ImageServiceMeasure | Download source
Name | Type | Summary |
---|---|---|
fillSymbol | SimpleFillSymbol | Symbol to be used when drawing a polygon or extent. |
lineSymbol | SimpleLineSymbol | Symbol to be used when drawing a line. |
markerSymbol | SimpleMarkerSymbol | Symbol to be used when drawing a point. |
measureToolbar | ImageServiceMeasureTool | The instance of ImageServiceMeasureTool associated with this widget. |
Name | Return type | Summary |
---|---|---|
destroy() | None | Destroys the ImageServiceMeasure widget. |
startup() | None | Finalizes the creation of the widget. |
< > params |
Required | An Object containing constructor options. See the object specification table below for more details about each option. |
< > srcNode |
Required | Reference or id of the HTML element where the widget should be rendered. |
params
properties: < > angularUnit |
Optional | The angular unit in which directions of line segments will be calculated. Possible Values: esriDURadians | esriDUDecimalDegrees (default) |
< > areaUnit |
Optional | The area unit in which areas of polygons will be calculated. The value of this property can be changed at runtime by choosing a different unit from the Area Units dropdown on ImageServiceMeasureToolbar. Default value: SQUARE_KILOMETERS. |
< > displayMeasureResultInPopup |
Optional | Defines whether to show the widget result in a popup or in the widget's result area when the widget has 'toolbar' layout. Default value: false |
< > fillSymbol |
Optional | Symbol to be used when drawing a polygon or extent. |
< > layer |
Required | Image service layer with which the toolbar is associated. |
< > layout |
Optional | Defines the layout of the widget. Possible Values: toolbar| dropDown (default). |
< > lineSymbol |
Optional | Symbol to be used when drawing a line. |
< > linearUnit |
Optional | The linear unit in which height, length, or perimeters will be calculated. The value of this property can be changed at runtime by choosing a different unit from the Linear Units dropdown on ImageServiceMeasureToolbar. Default value: KILOMETERS. |
< > map |
Required | Map instance with which the toolbar is associate. |
< > markerSymbol |
Optional | Symbol to be used when drawing a point. |
SimpleFillSymbol
> fillSymbolSimpleLineSymbol
> lineSymbolSimpleMarkerSymbol
> markerSymbolImageServiceMeasureTool
> measureToolbardraw-start
, draw-end
, and measure-end
events fired by this widget.