Page Comparison

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

Configuration

1. Download and install the area mapping application on your device
2. Navigate to the form builder for your app on CommCare HQ
3. Navigate to where you want to insert the question
4. Add an "Android App Callout" question type under the "Advanced" tab
5. Create an ID and label as you would a normal question
6. Under "Intent ID" write: org.commcare.mapping.AreaCalculator
7. Under "Logic" you can enforce the same things as you would a normal question, IE enforce this must be a realistic value, non-null, etc
8. That's it! To read more about what's going on under the hood see this page.

...

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. 

...

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.