...
The Geo Location feature works in conjunction with rules that use the the form.positionUpdated identifier. You can set up the rule to execute every time the position is updated. See Business Rules for examples of rules that will do this.
You can also collect information associated with your location. For example, a section of a Police Incident Report, shown in the image, captures the location where the form was filled in plus the address information associated with it. The last position update will be in the submission metadata of your form or flow but it is NOT automatically added to the XML Document. You must create controls (perhaps hidden) and rules to add the location information to the form XML document. This form has The Position Address section of the Police Incident Report form controls and rules to show longitude, latitude, accuracy and/or errors plus the address information.
...
Latitude and Longitude display the coordinates of the user location. Accuracy represents the radius of a circle representing the accuracy of the location in meters - a low Accuracy value means the position is more precise. You can display a position error code and the text description of error message in your form if desired. Error message codes can be 1, 2 or 3:
1 - Permission Denied - You will get this error code if the user says no to the access question.
2 - Position Unavailable - This error code means the device running the browser cannot get the GPS satellite signal (tunnel, underground).
...
3 - Timeout - The device running the browser times out trying to get the location information.
You will never see coordinates and error codes in the same form. You get one or the other.
Click on the Toolbar in the Forms Designer to display the Form Properties panel. Select one of three options from the Geo Location dropdown to turn the this feature on:
- None - (no location) - this is the default
- On Load - at start time
- Custom - allows the designer to specify a periodic refresh. The default value is 30 seconds. Choosing this method will fire a rule in the specified time. For example, if the field to the right of the Geo Location Dropdown was set to 10, the rule would fire every 10 seconds. See below for more details.
...
You can also turn on/off/modify the feature by clicking on a form activity in a flow which will display the form Properties panel. The Loc Timeout is a value that must pass before the Timeout error codes/messages will appear on your form. You can To capture additional information based on the location via a Business Rule such as position address or other information as shown in the Position Address image above and you can or to embed a Google map in your form. To activate this part of the Geo Location feature, you must have you need a connection to google.com and you must check the Detailed Loc. checkbox on the Properties Panel. The map will only display in use mode.
...