Area Mapping App Integration

This page will walk you through the steps of integrating Dimagi's area mapping application with your CommCare 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 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. 

Open

Saving Coordinates

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

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.