Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

titleThis feature requires a CommCare Software Plan

...

Multiexcerpt include macro
macro_uuid77a79df7-a5d1-4f8f-828d-6c8d8a40e9b2
nameSoftware Plan - Pro
templateDataeJyLjgUAARUAuQ==
pageCommCare Help Site Design Guidance
addpanelfalse

This page will walk you through the steps of integrating Dimagi's area mapping application with your CommCare ODK app.

Configuration

  1. On your Android device, download the Area Calculator application from the Google Play Store

  2. In the Form Builder, add a Android App Callout type question

    1. Then, under the "Templates" dropdown of this question, select the "Area Calculator" question

...

Displaying Extra Information

You have the option to display extra information at the top of the screen when the Area Calculator app is opened. These options can be added as Extra values in the formbuilder. Below are the key/value pairs that have to be filled out in order to display your information. 

...

    1. type

...

Saving Images

In order to capture an image of the map and the polygon around the surveyed area, follow the steps below. 

  1. Add an extra to the Area Calculator question with key: image and value: 'true'

  2. Add an image capture question to the form

  3. Add a key/value pair to the Response section of the Area Calculator question, with key: image and value: drag and drop the image capture question

The image of the map and polygon will now be saved to the image capture question when the form is submitted. 

...


Saving Coordinates

In order to capture the coordinates of the polygon, follow the steps below. 

Image Removed

 

  1. Add an extra to the Area Calculator question with key: coordinates and value: 'true'

  2. Add a hidden value to the form to save the coordinates in

  3. Add a key/value pair to the Response section of the Area Calculator question, with key: coordinates and value: drag and drop the hidden value created in step 2 above

The coordinates of the polygon will now be saved to the hidden value as a string of lat/lng doubles when the form is submitted. 

Info

Note: The Area Mapper tool in CommCare is designed to measure the surface area of a region by creating a polygon around the surveyed area. However, it's important to note that this tool measures the 'planar' or 'flat' area enclosed by the polygon, not the actual surface area of a sloped or uneven terrain. The tool is most accurate when used on level ground.