{"id":66731,"date":"2015-03-16T10:50:11","date_gmt":"2015-03-16T10:50:11","guid":{"rendered":"http:\/\/www.esri.com\/arcgis-blog\/products\/product\/uncategorized\/measuring-distances-and-area-with-arcgis-runtime-sdk-for-net\/"},"modified":"2023-08-23T11:53:03","modified_gmt":"2023-08-23T18:53:03","slug":"measuring-distances-and-area-with-arcgis-runtime-sdk-for-net","status":"publish","type":"blog","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/api-net-win-desktop\/developers\/measuring-distances-and-area-with-arcgis-runtime-sdk-for-net","title":{"rendered":"Measuring distances and area with ArcGIS Runtime SDK for .NET"},"author":6351,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_acf_changed":false,"_searchwp_excluded":""},"categories":[738191],"tags":[23641,23451,24291],"industry":[],"product":[36871,36601],"class_list":["post-66731","blog","type-blog","status-publish","format-standard","hentry","category-developers","tag-net","tag-arcgis-runtime","tag-runtime","product-api-net-win-desktop","product-developers"],"acf":{"short_description":"The ArcGIS Runtime SDK for .NET enables developers to build connected or offline Windows apps that provide end users with focused editing...","flexible_content":[{"acf_fc_layout":"content","content":"

The ArcGIS Runtime SDK for .NET<\/a> enables developers to build connected or offline Windows apps that provide end users with focused editing workflows across native Microsoft platforms (Desktop, Store, Phone).\u00a0 A common developer requirement is to implement a measure tool for calculating distances and areas based on a geometric shape sketched by a user who is interacting with the map.\u00a0 The Editor<\/em> provides support for drawing shapes that aid in building a functional measure tool.<\/p>\n

This blog post aims to help you build your own measure tool by introducing the following Editor concepts:<\/p>\n

I.\u00a0\u00a0\u00a0\u00a0 Sketching with the Editor.<\/p>\n

II.\u00a0\u00a0\u00a0 Editor vs. Map Navigation.<\/p>\n

III.\u00a0\u00a0 Customizing Editor Symbology.<\/p>\n

IV.\u00a0\u00a0 Tracking Editor\u2019s progress.<\/p>\n

Two universal apps<\/a> \u00a0(Simple and Advanced measure tool) will be used to provide examples that help clarify these concepts; these apps target both\u00a0 Windows Store<\/a> and Windows Phone<\/a> platforms and illustrate that the ArcGIS Runtime SDK for .NET implementation helps facilitate creating shared logic between apps.\u00a0 The Simple measure tool will cover concepts from the first two sections, while the Advanced measure tool will build on those concepts and cover sections III and IV. \u00a0Demo code can be obtained here<\/a>.<\/p>\n

I \u2013 Sketching with the Editor.<\/span><\/strong><\/p>\n

In order to measure distance and area on the map, you can work with the Editor <\/em>to sketch geometries<\/a> as graphics on the topmost layer of the map.\u00a0 The MapView<\/em><\/a> control maintains a Graphics overlay collection which can be used to create and display these geometries on a temporary basis. \u00a0The MapView control also provides convenient access to an Editor instance<\/a> that will support geometry creation via the RequestShapeAsync<\/em> method. \u00a0Calling RequestShapeAsync<\/em> will return geometry based on a specified DrawShape<\/em> parameter.<\/p>\n

\"\"<\/a><\/p>\n

Tip:\u00a0 RequestShapeAsync<\/em> is an awaitable task that uses the (TAP) Task-based asynchronous pattern<\/a>.<\/p>\n

The following code puts the map in sketch mode and returns a polyline geometry upon completion of the asynchronous task.<\/p>\n

Example DrawShape<\/em> parameters and the geometry types that are returned based on a user sketch are listed in the following table:<\/p>\n\n\n\n\n\n\n\n
\n

DrawShape Parameter<\/strong><\/p>\n<\/td>\n

Return Geometry<\/strong><\/td>\n<\/tr>\n
Point<\/td>\nMapPoint<\/td>\n<\/tr>\n
Polyline,\u00a0 LineSegment,\u00a0 Freehand<\/td>\nPolyline<\/td>\n<\/tr>\n
Polygon, Triangle, RectangleCircle, Ellipse, Arrow<\/td>\nPolygon<\/td>\n<\/tr>\n
Envelope<\/td>\nEnvelope<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Once a geometry is returned, it can be analyzed using the GeometryEngine<\/em><\/a> to compute area and length (including Geodesic calculations).<\/p>\n

II \u2013 Editor vs. Map Navigation.<\/span><\/strong><\/p>\n

While digitizing a new geometry for measurement, you may need to interact with the map.\u00a0 For example, you may need to change the current map position by panning to a new location or zooming to an area of interest.<\/p>\n

It is helpful to gain some familiarity with some of the Editor properties and commands that can be used to distinguish whether or not the Editor needs to respond to a platform event.\u00a0 Some of the key properties and commands are listed in the following table:<\/p>\n\n\n\n\n\n\n\n
Name<\/strong><\/td>\nProperty \/ Command<\/strong><\/td>\nUse When:<\/strong><\/td>\n<\/tr>\n
IsActive<\/td>\nProperty<\/td>\nIndicate when the Editor is in the middle of a sketch or edit<\/td>\n<\/tr>\n
IsSuspended<\/td>\nProperty<\/td>\nIndicate when the Editor has been suppressed from responding to a platform event property<\/td>\n<\/tr>\n
Cancel<\/td>\nCommand<\/td>\nDeactivate the Editor without returning geometry<\/td>\n<\/tr>\n
Complete<\/td>\nCommand<\/td>\nAllow the Editor to return geometry before it is deactivated<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

The following code example illustrates how to enable a Suspend button (based on the IsActive property) and a Complete command.<\/p>\n

\"\"<\/a><\/p>\n

III Customizing Editor Symbology.<\/span><\/strong><\/p>\n

The following image shows the default symbology used by the edit tools of the Editor:<\/p>\n

\"\"<\/a><\/p>\n

There are various use cases for overriding the Editor symbology:<\/p>\n