Versions Compared

Key

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

...

CommCare supports a feature called Automatic GPS Capture to help you automatically capture GPS locations.

Automatic GPS Capture

...

This feature will allow forms filled out on CommCare for Android to automatically capture a GPS location with no intervention from the mobile user.  

...

  • The phone's GPS must be on for this feature to work. If it is switched off, CommCare will prompt the user if they want to turn on GPS. This message will pop up each time they enter a form for which auto capture is on.

  • The accuracy reported with every location actually comes with a 68% probability, see details on Android's Accuracy here. So an accuracy of 4000m doesn’t mean the location is within 4000m, it means that there’s a 2/3rd chance that the correct location is within 4000m and a 1/3rd chance that it isn’t.

Setting up Automatic GPS Capture

  1. Make sure that your application is running the appropriate versions of CommCare. Both the client and the application content must be updated:

    1. The CommCare client version from the Play Store must be 2.14 or greater. See https://dimagi.atlassian.net/wiki/x/vQXKfw.

    2. Your application version on the settings page for your application must also be set to 2.14. More information found at https://dimagi.atlassian.net/wiki/x/bzPKfw.

  2. Turn on Auto GPS Capture on CommCareHQ

    1. For all forms (when GPS capture will be active in all forms in an application)

      1. Navigate to the application settings page

      2. Under Android settings check the box for "Auto Capture Location (all forms)" and save

    2. For one form (when GPS capture will be active in only some forms in an application)

      1. Navigate to the specific form that you wish to auto capture GPS location

      2. Click the check box "Auto Capture Location (all forms)" and save

  3. Make a new version of your application and deploy it to your phone.  Your phone will now attempt to automatically capture GPS locations for the forms you have selected.

...

One can use the standard Export Forms routine to export GPS data. To do so, select Show Advanced Settings in the Export Settings page and then include the Location field. To further break down the location and include latitude, longitude, altitude and accuracy in separate columns of the export, enable Expand Checkbox Questions.

Understanding GPS Data

Deciphering GPS Data

GPS data in CommCare is captured in decimal degrees. It has 4 components, separated by a space character:

...