The September 2021 release of ArcGIS Survey123 (version 3.13) includes several significant improvements to the user experience for draw and annotate questions in the Survey123 field app. These changes incorporate numerous requests and feedback from our Survey123 community and seek to enhance the drawing experience to make it more useful and more efficient in the field. The key highlights in version 3.13 are as follows:
In this blog post we'll do a quick recap on image annotation in Survey123, delve into the new user experience and explain what’s new, and touch on the enhancements still to come.
Before we check out the latest enhancements, here’s an overview of image annotation in ArcGIS Survey123.
Draw and annotate are staple features of Survey123. By applying the annotate appearance to an image question, an author can allow users to mark up a photo captured with the device’s camera, an existing image file, or a snapshot of a map. Similarly, an image question with the draw appearance provides a blank canvas for users to sketch on.
Draw and annotate questions are useful in a range of applications. For example, an asset inspection field crew might take photos of equipment and mark-up any faults with the drawing tools. A law enforcement officer might take a snapshot of a map and then sketch a diagram of where an incident took place.
To add draw and annotate questions to your survey:
For more information on controlling image size for image questions, see Images. For more information on the draw and annotate appearances, see Appearance. There's also an Images and Annotation sample XLSForm in Suvey123 Connect to help you get started.
The September 2021 release brings with it several improvements to the user interface (or canvas interface, as we like to call it). The canvas interface is documented here. The canvas can be in one of two modes: explore or draw. Here’s a quick tour:
In explore mode you can zoom and pan the canvas; zoom to the actual size (100%) of the canvas; adjust the zoom to fit the canvas on screen; or fill the screen with the canvas. Manipulate the view either by selecting the buttons or directly on the canvas itself using touch or mouse (on desktop).
Select the explore mode button (1) to enable explore mode. Select again to reveal the explore options menu (2). Several of these options are also available as buttons on the toolbar (3).
In draw mode, select the drawing tool preview in the bottom left of the canvas or the draw mode button to open the drawing tools palette. The drawing tools palette has been enhanced to include more drawing tools (including marker symbols and vertex-by-vertex lines) and greater control over color, line style, transparency, fill, and text style.
Select either the drawing tool settings preview or the draw mode button to reveal the drawing tools palette. The drawing tools palette in Survey123 version 3.13 offers many improvements, including:
An overview of the drawing tools palette:
The drawing tools palette can be expanded or collapsed (2) and the state of the palette is remembered per question. When the palette is collapsed, switching to another drawing tool requires only a single selection, so once you’ve set up your drawing tools palette you can collapse it to make selecting tools faster:
There are eight default colors to choose from, plus a ninth swatch for setting a custom color; however, any color swatch can be customized by pressing and holding it.
Note (3) and (4) launch the default color picker dialog for your device’s OS.
The image below shows the default color palette on the left, and a customized palette on the right:
Each drawing tool has text enabled by default. The position of the text varies depending on the drawing tool. For example, for straight lines the text is positioned above the midpoint of the line and rotated to the same angle as the line itself (perfect for adding dimensions!). For shapes, text is positioned in the horizontal and vertical center of the polygon, and for markers the label is placed underneath the symbol itself. To disable text for a drawing tool, select the No label option from the text menu.
You can also add a text label on its own using the label tool (1). This allows you to create “sticky note” labels (see an example, below) with background fill and outline that can be positioned wherever you like on your image.
Before we get into the details about image size, let’s define the term "viewable canvas area". The viewable canvas area is the region in the app between the title bar and the toolbar, where the canvas or image is presented and you can add graphic elements (lines, text, symbols, and so on). The size and resolution of the viewable canvas area is dependent on the device’s screen dimensions, and the size of the application window when running the field app on desktop.
Prior to the September 2021 release, the image size for draw and annotate questions was limited to the dimensions of the viewable canvas area. Photos taken with the camera or added from file would be resized to fit the viewable canvas area. When adding an image to the canvas, users were often seeing their annotated images reduced to a much smaller size than their original image, which is not ideal if you need to do detailed annotation work. With the latest release, you can configure your survey so that the original size of your source images is preserved.
In general, the size of the canvas for draw and annotate questions (and hence the dimensions of the image attachments that are submitted) can be specified in the following ways:
The following special cases also apply:
You can add a default image to draw or annotate, and its original size will be honored in the annotated image. This is useful for standardizing the image size submitted for a question, regardless of the device. You can also personalize this default; for example, for draw questions where users will draw a sketch, you could add gridlines on a white background, with your company logo in the lower corner. The Transmission Tower Inspection Community sample survey in Survey123 Connect is a good example of how default images can be used effectively for asset inspections.
Customer feedback told us that when it comes to annotating a new image captured with the camera or selecting an existing image from file, it would be useful to retain any EXIF information from the original image file and apply it to the new annotated image. From version 3.13, any EXIF data in the source image is now copied to the annotated image.
Customer feedback also told us that it’s not useful to show the pin on the map when taking a map snapshot, as this can interfere with the annotations. The map pin is now hidden from the canvas (but is still visible in the map window when specifying the map extent).
The Survey123 team is working on expanding the draw and annotate tools to include more features for editing and customization.
Users will be able to select any graphic element on the canvas and manipulate or delete it. This includes being able to modify the drawing order of elements on the canvas (bring to front, send to back, and so on) as well as rotate and modify individual graphic elements.
The Survey123 field app ships with the default drawing tools palette containing eight tools that users can configure in the app. We’ve received requests from organizations that wish to standardize the drawing tools so that annotated images are consistent across surveys and across their organization.
The Survey123 team is working on a method to allow survey authors to design custom drawing tools palettes and set these on a per-question basis. For example, a utilities company might have specific symbols and line styles that relate to electrical or gas works. Custom palettes can help make image annotation in the field more efficient and consistent.
Join the ArcGIS Survey123 Early Adopter Community for more details and to get started testing with the latest beta versions.
We hope you enjoy the latest improvements to the user experience for drawing and image annotation in ArcGIS Survey123. Please share your feedback in the comments below, we’d love to hear from you!
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.