Question Type: Geo Location

Contents

About

The Geo Location question type takes location data and uses it in forms. It can be used as a:

  • Selector (Location): Opens a map view on a mobile device and allows mobile users to select a location. This can also use dispatched coordinates.
    • Users have the option to tap an icon to get driving directions in their default map/directions app on their mobile device (ProntoForms for iOS 8.2.1 and Android 7.5 and up)
  • Stamp: Acquires the current location for use in forms.
    • A stamp is collected whenever the page containing the stamp question is opened in the form.

An example of a Geo Location question on a large-screen iOS device is shown below:

2019-01-11-iOS-Geolocation01.png

Form Builder

In the Form BuilderClosed The Form Builder is the tool that form designers use to create forms. In the Form Builder, accessed from the ProntoForms Web Portal, form designers can add and edit pages, sections, and questions, as well as attach data destinations and configure the form's settings., the Geo Location question appears as shown below:

2019-01-11-FB-Geolocation01.png

The Question Edit screen for the Geo Location question type has two tabs: General and Help OptionsClosed Help Options are ways to add help content, such as YouTube videos, web pages, text, or images, to questions in a form. Mobile users simply tap the help icon next to a question to see the help that the form designer provided.. This article will go through each of the tabs.

2019-01-11-FB-Geolocation02.png

General

Unique ID 

The Unique IDClosed A Unique ID refers to the specific identifier of a question, form page, form section, or Data Destination. Unique IDs are used as reference points when pulling data for conditional logic, Analytics projects, Data Destinations, and Documents. is the reference for the question. For more information on Unique IDs, read: Overview: Unique IDs. It can either be auto-generated based on the question text, or customized.

Control Types

The Geo Location question type supports two controls: Geo Stamp and Geo Location.

  • Geo Stamp: When mobile users open the page containing the Geo Stamp question, the question collects a location. Users cannot edit the Geo Stamp question.
  • Geo Location: Geo Control allows users to acquire GPS coordinates on a map. It attempts to acquire location information when the user hits the Geo Location control map in the form. It can also be used to open driving directions in the mobile device's default map app.
Tips for Form Designers:
  • Geo Stamps are best used to take a snapshot of where your mobile user is when they're filling out forms. It's useful, for example, to verify that an inspection was done at the inspection site.
  • Geo Locations allow interaction from the user and can be dispatched to.
    • Driving Directions: Use this control with a dispatched address and your mobile users can open driving directions directly from the ProntoForms mobile app.

Restrictions

Restrictions control how your mobile users interact with a question. They can be set on the question itself or controlled by Conditional Logic.

The following table shows which restrictions you can set for the question type. Note that:

  • indicates a restriction that you can configure.

  • * indicates a restriction that is always on.

  • ✘* indicates a restriction that is always off.

Required Read-Only Hidden on Device Hidden on Reports

Keep question width to 100%

(Side-by-Side SectionsClosed Side-by-Side Sections display questions and answers in a condensed, two-column layout. This can make it easier and faster for field users to scan, complete, and confirm the answers in a form. only)

Geo Stamp ✘* ✓*
Geo Location

* Geo Stamp questions automatically collect location data. Users cannot interact with the answer, and therefore Geo Stamps are Read-Only by default. Required is disabled for Stamp because if location services are unavailable, this data cannot be found, which can interfere with data collection.

Help Options

Adding "Help" content to forms gives mobile users access to support and other resources out in the field. Help content is available to users through a button embedded beside a question. Any question in the form can include a link to YouTube videos, web pages, or work instructions. 

For more information on Help Content, please read: Add Help Options to Questions

Driving Directions

Mobile users can use dispatched or selected Geo Location coordinates to launch driving directions from the ProntoForms mobile app. Simply tap the directions icon in the Map view once you've selected a location.

Note: This feature is only available on ProntoForms for iOS 8.2.1 and Android 7.5 and later.

2019-01-22-iOS-GeoLocDriving.png

Technical Details

Location Services

Location Services must be enabled for ProntoForms on your mobile device in order for a Geo Location to be collected. This is an OS-level setting.

Note: The mobile device battery may discharge more quickly when Location Services is enabled.

Read how to enable Location Services on your device.

Location Accuracy and Working Indoors

As GPS technology only functions in areas where there is satellite visibility, most GPS devices do not work well indoors. On iPhone and Android devices, assisted GPS is used to determine location, using network information in addition to satellite data. Although less precise, these technologies can provide a location when indoors where a GPS signal is not available.

  • Mobile users who work primarily outdoors are good candidates to use the Geo Location capability on any of the supported devices.
  • Where some form of Geo Stamp/Control is still desired, although location precision is not as critical, the Android and iPhone Geo Location capability offer a network-based location that can usually be acquired indoors.

Location Fixes

Location fixes are split into two classifications depending on the accuracy: Fine and Coarse. This accuracy is determined by the system services used for the fix. GPS would be considered Fine, while Network would be considered Coarse. ProntoForms stores the most recent location fine AND coarse location fix; whenever a new fix is returned, it replaces the previous fix for that accuracy.

The logic to determine whether to grab the fine location fix or the coarse location fix is as follows:

  1. If a fine location fix was acquired within the last 5 minutes, use it.
  2. Otherwise, if only one of the fine or coarse location fixes are available and it is still considered valid (obtained within the last 5 minutes), use that.
  3. Finally, if both fine and coarse location fixes are available, grab the most recently obtained that is valid (within 5 minutes).

Consequently, in areas of poor satellite visibility, the Geo Location information displayed in the form may be up to 5 minutes old. Note that the date/time collected with the Geo Location information will show the time the fix was acquired.

Dispatching into Geo Location Questions

When dispatching into Geo Location data using Bulk DispatchClosed The term "dispatch" refers to the act of sending a form to a mobile user or customer. Typically, a dispatched form includes some information pre-filled to give the recipient context for the work to be done. Dispatch can be manual or automated (using a Dispatch Data Destination or the ProntoForms REST API)., you must convert your addresses into latitude and longitude coordinates.

If you need assistance doing this, web-based tools such as LatLong.Net may prove helpful. ProntoForms does not endorse any particular service.

If dispatching via the Web Portal, simply enter an address and verify that it is correct on the map display:

2019-01-15-Dispatch-Geolocation03.png