Question Type: Geo Location
- Form Builder
- Driving Directions
- Technical Details
- Dispatching into Geolocation Questions
- 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:
In the Form Builder, the Geolocation question appears as shown below:
The Question Edit screen for the Geolocation question type has two tabs: General and Help Options 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.
The Unique ID 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.
The Geolocation 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 Get Location control map in the form. It can also be used to open driving directions in the mobile device's default map app.
Restrictions control how your mobile users interact with a question. They can be set on the question itself, or controlled by Conditional Logic.
|Required||Read-Only||Hidden on Device||Hidden in Reports|
|Geo Stamp||✘||✓ *||✓||✓|
* 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.
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 Content to Questions
Mobile users can use dispatched or selected Geolocation coordinates to launch driving directions from the ProntoForms 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 above.
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.
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 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:
- If a fine location fix was acquired within the last 5 minutes, use it.
- 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.
- 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.
When dispatching into Geolocation data using Bulk Dispatch 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: