> For the complete documentation index, see [llms.txt](https://docs.globalalerting.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.globalalerting.com/devices/gap-guardian-app/gap-guardian-v3-user-guide.md).
# GAP Guardian v3 User Guide
## Getting Started
GAP Guardian can be installed from the [Apple](https://apps.apple.com/us/app/gap-guardian/id1274453909) or [Google](https://play.google.com/store/apps/details?id=com.globalalerting.gapguardian) app stores.
To run the app on iOS, your device needs to be running a minimum of iOS 12.0.0.
To run the app on Android, your device needs to be running a minimum of Android 11.
### App Permissions
The app requires access to certain device functionality in order to function correctly. Please follow the instructions below depending on your device's operating system.
{% tabs %}
{% tab title="iOS" icon="apple" %}
You will be prompted to allow the app access to use Bluetooth. Tap the "Allow" button.
You will also be prompted to allow the app to use location services.
Tap "Allow While Using App". Later you may be prompted to permit the app to use your location when it runs in the background. If this happens, tap "Always Allow". You may also be prompted to allow the app to send you notifications. Tap "Allow".
After logging in, you will also be prompted to allow notifications and access to motion data. Tap "Allow" to both prompts.
{% endtab %}
{% tab title="Android" icon="android" %}
You will be prompted to allow the app to use location services.
Tap "OK" at the "About location data" prompt.
At the next prompt, select "Precise" and "While using the app".
When prompted to grant permissions for alarms and reminders, toggle the "Allow permission" slider.
{% endtab %}
{% endtabs %}
### Logging In
Enter your user name in the "Username" text box then tap "Next".
When prompted for a password, enter it and tap "Password" text box and tap "Login".
If you only have one device assigned to you on the Portal, your credentials will be validated, and the Dashboard will load.
If you have more than one device assigned to you, you will be asked to select which device you are using.
Finally, you may be prompted to accept your service provider's terms and conditions before proceeding to the Dashboard.
## Navigation
The Dashboard screen shows all the app functions available to you.
{% hint style="info" %}
Some functions may not be available to you. Contact your GAP administrator for further information.
{% endhint %}
### Language
You can change the display language used by the app.
The following languages are currently supported:
* English
* French
* Spanish
* Italian
* German
* Polish
* Bulgarian
* Portuguese
* Ukrainian
* Turkish
* Russian
* Japanese
* Korean
* Simplified Chinese
* Arabic
To change the display language:
1. Tap "Settings".
2. Tap "App Language".
3. Tap the language you want to use.
## SOS
SOS mode raises an emergency alert on the GAP Portal. It is used to indicate that you are in danger and require assistance.
### Activating SOS Mode
To activate SOS mode, press and hold the "SOS" button until the animation around the edge of the icon completes a full circle. When complete, a red banner will display, and the "SOS" button will pulsate. An SOS message will be sent at regular intervals to the Portal.
### Cancelling SOS Mode
To cancel SOS mode, tap "SOS" and tap "Yes" at the warning prompt.
### Changing SOS Settings
#### SOS Message Interval:
To configure the SOS message interval:
1. Tap "Settings"
2. Tap "SOS"
3. Tap "SOS Message Frequency"
4. Select your chosen interval from the list.
#### Phone Call
To trigger a phone call when SOS mode is started:
1. Tap "Settings".
2. Tap "SOS".
3. Tap toggle the "Call ... " option.
#### Haptic Feedback
To enable haptic feedback when an SOS is acknowledged:
1. Tap "Settings".
2. Tap "SOS".
3. Toggle the "Vibrate" option.
## Monitor Me
Monitor Me is a customisable, user-initiated monitoring mode which allows you to decide what aspects of monitoring you would like to activate when Monitor Me is switched on. These include:
* How often you should be required to check in
* How often your position should be reported
* If man-down detection should be enabled
* If a call should be initiated so that a remote operator can listen in
### Configuring Monitor Me
{% hint style="info" %}
Monitor Me settings cannot be changed when Monitor Me is active. Stop Monitor Me prior to making changes to Monitor Me settings.
{% endhint %}
To configure your Monitor Me settings, tap the "Settings" button then "Monitor Me". You can configure the following values:
* Whether you should be prompted to add a note when starting Monitor Me ("Annotation on start")
* Whether you should be prompted to add a note when stopping Monitor Me ("Annotation on stop")
* How often you should check in ("Check-In Frequency")
* How late you can check-in ("Check-in Buffer")
* How often your location should be reported ("Position Reporting Frequency")
* How long your device can be motionless before an alert is sent to the Portal ("Man-Down")
* How long until an alert is sent to the Portal if you've been motionless ("Cancel Man-Down Alarm")
* How sensitive the motion detection is ("Movement Sensitivity")
* Whether man-down alerts should be supressed when the device is charging ("Charging Mode")
* Whether a phone call should be triggered when Monitor Me is started ("Call ... ")
### Starting Monitor Me
To start Monitor Me, tap "Monitor Me". The edge of the button will rotate whilst Monitor Me is activating, after which point, the button will pulsate to indicate it is active. The banner will also temporarily display a notification to that effect.
The "Check In" button will change to show a countdown timer, indicating when you are next required to check in. If you do not check in when required, a banner will be shown reminding you to check in.
### Checking In
To check in, tap "Check In". The edge of the button will rotate whilst the check in is performed. The banner will also temporarily display a notification to that effect.
If you don't have data connectivity, you may be prompted to attempt a check-in via an SMS message.
If your app is configured to request an annotation when performing a check-in, you will be prompted to enter some text before completing the check-in. When complete, tap the "Check In" button. You need not enter any text if you do not want to. You can turn check-in annotations on or off via the "Settings" screen.
If your app is configured to require a photo when performing a check-in, you will be prompted to take a photo before completing the check-in. When complete, tap the "Use Photo" button. You can turn Photo Check-In on or off via the "Settings" screen.
#### Stopping Monitor Me
To stop Monitor Me, tap the "Monitor Me" button and then tap "Yes" at the warning prompt. The edge of the button will rotate whilst Monitor Me is stopping, after which point the button stop pulsating. The banner will also temporarily display a notification to that effect.
## Check-In Schedules
In addition to Monitor Me, your administrator can create Check-In Schedules, requiring you to check in at predefined intervals or certain times of the day. These are assigned remotely to your device via the GAP Portal or GAP Admin, by your administrator.
### Enabling the Check-In Schedule
To enable your assigned Check-In Schedule, tap "Settings" then "Check-In Schedule" and then toggle the "Enable Check-In Schedule" option. The details of your assigned schedule will be displayed.
If there is no Check-In Schedule assigned to your device, an error message will be displayed.
If Monitor Me is active, your next check-in will be calculated based on the chosen Monitor Me interval and your assigned Check-In Schedule.
### Disabling the Check-In Schedule
To disable your assigned Check-In Schedule, tap "Settings" then "Check-In Schedule" and then flick the "Enable Check-In Schedule" option to "off".
### Configuring Notification Sounds
iOS users can change their notification sound by tapping "Settings" then "Notification Sounds". Android users should use the functionality built into the Android operating system (where supported).
## Tracking
When tracking mode is active, your location information will be sent to the Portal on a set interval or when you move more than approx. 200M.
### Starting Tracking Mode
To start tracking, tap "Tracking".
When tracking mode is enabled, the "Tracking" button on the Dashboard will pulsate.
### Configuring Tracking Mode
To configure tracking based on a particular interval, tap "Settings" then "Tracking". Set the "Location Change Mode" toggle to off then tap the "Position Report Frequency" option and select your chosen frequency.
In this mode, you can also configure whether position reports should only be sent when you have moved more than a set distance using the "Movement Buffer" option.
To configure the tracking based on a significant movement (approx. 200M), tap "Settings" then "Tracking". Set the "Location Change Mode" toggle to on.
In this mode, you can also configure the maximum frequency position reports will be sent using the "Minimum Report Interval" option.
### Stopping Tracking Mode
To deactivate tracking, tap the "Tracking" button and then tap "Yes" at the warning prompt.
## Messages
The Messages screen allows you to converse via text messages with a GAP Portal operator.
When you receive a message, a notification will be displayed and a red badge indicating the number of unread messages will be shown on the Dashboard screen and on your device's app launcher screen (on supported Apple, Samsung and Sony devices only).
### Sending Messages
To send a message to a recipient with whom you've not conversed previously, tap "Messages" then the "+" at the top-left hand side of the screen. Select a recipient from the "Choose Recipient" screen. Enter your message in the text box at the bottom of the screen and tap "Send".
### Replying to Messages
To reply to a message, tap "Messages" then the name of the sender. Enter your message in the text box at the bottom of the screen and tap Send.
## Maps
The Maps screen allows you to view your current location, recent track. nearby devices, geofences, travel alerts and points of interest on a map.
### Configuring Maps
To view items on the map, tap the "Maps" screen then tap the "hamburger" icon at the top right-hand side of the screen. Toggle items on or off using the sliders.
To change the map type, tap the "hamburger" icon at the top right-hand side of the screen. Tap the "Map Type" option and select either "Street", "Satellite" or "Hybrid" as required.
### Contacting Other Users
Tap the "Maps" screen then tap the "hamburger" icon at the top right-hand side of the screen. Toggle the "Show nearby devices" on using the slider. You can optionally set the distance within which you can view nearby devices via the "Only show devices nearer than" click-through menu. If you would like to see the emergency state for devices shown on the map, toggle the "Show emergency state" option to on.
Devices will be shown on the map using the same icons as the GAP Portal. Tap on a pushpin for more information. You can call, e-mail or message the user via the relevant buttons on the right-hand side of the pop-up menu.
## Travel Alerts
To view travel alerts, tap "Travel Alerts". Tap on an alert to view further details.
You can sort travel alerts by distance, country name, risk level and date using the sort icon on the top right-hand side of the screen.
## Itineraries
To view itineraries, tap "Itineraries". Tapping on an individual itinerary will open the detail view.
## Documents
To view documents, tap "Documents".
Tapping on a folder will open that folder.
Tapping on a document will open the document (if the file format is supported by your device).
To navigate back up the folder structure, tap the back icon on the banner.
## Quick Call
The Quick Call function presents you with two buttons to initiate phone calls to numbers configured by your administrator.
To initiate a quick call, tap "Quick Call" then tap the button representing the number you wish to dial.
## Photos
The "Take Photo" function allows you to take a photo and upload it to GAP (where it can be viewed in the device's inbox).
To take a photo, tap "Take Photo" on the Dashboard.
If prompted to grant the app access to your camera, tap "Allow".
Tap the white button at the bottom of the screen.
If you are happy with the photo, tap "Use Photo", otherwise, tap "Retake". If you want to enter some accompanying text, do so in the "Notes" box then tap "Upload Photo".
## Notes
To take a note, tap "Notes". Enter your text in the text box and tap "Upload".
## My Info
The My Info function allows you to update information stored in your user profile.
To amend your info, tap "My Info". Complete the form as required and tap "Update".
## Location Service Settings
You can configure how the app obtains a location from the device's operating system using the Location Service settings screen. On this screen you can configure:
* How long the app will remember its last position ("Remember Location")
* How long the app will spend trying to obtain a new position ("Location Timeout")
* How accurate you would ideally like the position data to be ("Location Accuracy")
* If you'd like to use the position of the nearest beacon if the position returned by the device's operating system is inaccurate ("iBeacon Fallback Threshold")
To configure location service settings, tap "Settings" then tap "Location Service".
## Privacy Settings
You can configure whether your location is provided along with certain message types via the "Privacy" screen under "Settings".
To configure privacy settings, tap "Settings" then tap "Privacy". Toggle each option as required.
{% hint style="info" %}
Location information is always provided in SOS messages.
{% endhint %}
## Analytics Settings
You can opt in to provide usage information to help us improve the app.
To turn app analytics on or off, tap "Settings" then tap "Analytics". Toggle the "Allow analytics" option as required.
## Log
The Log screen contains information on the app's activities, including any warnings and errors.
### Viewing the Log
To view the log, tap "Settings" then tap "Log".
You can filter and re-order the log using the "Display Options" icon at the top right-hand corner of the Log screen.
### Uploading the Log
To send a copy of the log to the GAP Portal, tap "Upload".
## App Tester
To perform basic testing to verify the functionality of the app, tap "Settings" then "App Tester".
To begin a test, tap the Start button.
## Deactivation
Deactivating the app will delete your settings and return the app to the Login screen. You will need to login again before the app will function.
To deactivate the app, tap "Settings" then tap the "Deactivate" link at the bottom of the screen.
