Add a Geo Location Widget

When a SOTI SNAP application containing this widget is successfully installed on your device, the application requests the device's location data. Access to the location data requires an application to include the Geo Location widget.

About this task

Use the Geo Location widget in a SOTI SNAP application to retrieve the geographical location of the device.

Procedure

  1. In the Canvas, open the Widgets tab.
  2. Double-click or drag and drop the Geo Location widget onto the app canvas.
  3. In the Geo Location Properties panel, enter a name for the widget in the Name field.
  4. Enter a hint in the Display text field indicating what actions the app user should perform or what types of files they should upload.
  5. Turn on Display on device if you want this widget to appear to the app user.
  6. Choose whether this widget is required.
  7. Select the Report Format Settings you wish to use.
    • Select Default to use address, city, country, latitude, and longitude.
    • Select an option from the dropdown on the top-right of Report Format Settings to customize your geolocation report format.
      Report Format Settings Menu

      Options are:

      • Address
      • Area
      • City
      • State
      • Country
      • Postal Code
      • Country Code
      • Latitude
      • Longitude
  8. Optional: Add a requirement rule to the widget.
    Use requirement rules to specify whether the app user must configure this widget or can skip it.
    1. Select Requirement Rule to open the Set Requirement Rule dialog box.
    2. Select whether the requirement rule requires meeting all or any conditions.
    3. From the Field list, select an app field or variable and an operator. Enter the value required for the widget to be visible.
    4. Select Add Condition to add another condition.
    5. Select OK to save.
  9. Optional: Add a visibility rule to the widget.
    Use visibility rules to control when a widget is visible to the app user. For example, you can create a condition that a widget should only appear after the app user fills in a field or submits a form.
    1. Select Visibility Rule to open the Set Visibility Rule dialog box.
    2. Select whether the visibility rule requires meeting all or any conditions.
    3. From the Field list, select an app field or variable and an operator. Enter the value required for the widget to be visible.
    4. Select Add Condition to add another condition.
    5. Select Save.
  10. Move to the Format tab to customize the widget's appearance.
  11. Select Save in the SOTI Snap banner to apply your changes.
    Save app button

Results

Tip: Select Preview to see how the widget appears in your app.