# Android User Guide

**URL:** <https://discuss.88.io/t/android-user-guide/353>\
**Category:** android identity\
**Tags:** android\
**Created:** [August 31, 2021, 2:00pm UTC](https://discuss.88.io/t/android-user-guide/353 "2021-08-31T14:00:00Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![nocovid](https://discuss.88.io/user_avatar/discuss.88.io/nocovid/32/2693_2.png) [@nocovid](https://discuss.88.io/u/nocovid)\
**Post date:** [August 31, 2021, 2:00pm UTC](https://discuss.88.io/t/android-user-guide/353/1 "2021-08-31T14:00:00Z")

</div>

# 1. Introduction

This page is about setting up [Android mobile phones](https://en.wikipedia.org/wiki/Android_(operating_system)).

For assistance with Virtual Vaccine, please visit the [Contact Trace Support](https://discuss.88.io/t/contact-trace-support/407) page.

These are general instructions for the Virtual Vaccine project, each community application created from that project will be slightly different due to local customisation.

# 2. Android Chrome Browser

The [88.io](http://88.io) Web App and associated programs runs inside the Android Chrome browser.

## 2.1. Most Common Error

The most common error is disabling location access for Android Chrome browser or for the Web App (e.g. [app.contracttrace.com.au](http://app.contracttrace.com.au)).

When the Location is disabled, the Web Pin and QR Scan features will not work (Touch Pin will still be OK).

 ![android_geolocation_error](https://discuss.88.io/uploads/default/original/1X/6b3ba92b734b9fc3b35f45792ac1e33143cdc29d.jpeg)

There are two places where the Location needs to be enabled

1. Settings -\> Location
2. Chrome -\> Menu (the three dot icon) -\> Settings -\> Site settings -\> Location

## 2.2. [app.contacttrace.com.au](http://app.contacttrace.com.au)

[app.contacttrace.com.au](http://app.contacttrace.com.au) needs Location access to function fully (but basic features like QR code scan and Touch pins will still work without location access).

**Allow LOCATION Access in Chrome (43 seconds video)**

https://video.contacttrace.com.au/videos/embed/48fbe1d3-7678-4ca6-a7eb-df05ea73d6b2?warningTitle=0&peertubeLink=0

**Allow LOCATION Access in Chrome - Step by Step**

1. When running [app.contacttrace.com.au](http://app.contacttrace.com.au) for the first time, there will be a pop-up window saying "[app.contacttrace.com.au](http://app.contacttrace.com.au) wants to use your device's location", Select "Allow" [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2021/01/android_location_popup.png "popup")

2. On the address bar, tap on the ![android_chrome_dot](https://discuss.88.io/uploads/default/original/1X/07138899c3b7dad9cbcfb5f54a43f9f10dca97ed.png) dot icon and select "Settings" [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2021/01/android_chrome_settings.png "chrome\_settings"). Then scroll down to "Site settings" [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2021/01/android_chrome_settings_sitesettings.png "chrome\_sitesettings"), select "Location" and confirm it is enabled for [https://app.contacttrace.com.au](https://app.contacttrace.com.au) [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2021/01/android_chrome_location.png "chrome\_location")

3. If Location is NOT working, check Location by going to the Android "Settings" app and select "Location" to confirm "Location" is enabled [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2021/01/android_location.png "android\_location")

## 2.3. [qrscan.contacttrace.com.au](http://qrscan.contacttrace.com.au)

[qrscan.contacttrace.com.au](http://qrscan.contacttrace.com.au) needs Camera access to function.

**Allow CAMERA Access in Chrome (42 seconds video)**

https://video.contacttrace.com.au/videos/embed/c8def184-8553-4196-b2cb-ab9dc8688075?warningTitle=0&peertubeLink=0
### Allow Camera Access in Chrome - Step by Step

[app.contacttrace.com.au](http://app.contacttrace.com.au) will run [qrscan.contacttrace.com.au](http://qrscan.contacttrace.com.au) when QR Code scanning is required.

1. When running [qrscan.contacttrace.com.au](http://qrscan.contacttrace.com.au) for the first time, there will be a pop-up window saying "[qrscan.contacttrace.com.au](http://qrscan.contacttrace.com.au) wants to use your camera", Select "Allow" [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2021/01/android_qrscan_location_popup.png). If qrscan pop-up window appears more than once, simply Select "Allow".

2. On the address bar, tap on the ![android_chrome_dot](https://discuss.88.io/uploads/default/original/1X/07138899c3b7dad9cbcfb5f54a43f9f10dca97ed.png) dot icon and select "Settings" [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2021/01/android_qrscan_settings.png "qrscan\_settings") Then scroll down to "Site settings" [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2021/01/android_chrome_settings_sitesettings.png "chrome\_sitesettings"), select "Camera" and confirm it is enabled for [https://qrscan.contacttrace.com.au](https://qrscan.contacttrace.com.au) [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2021/02/android_chrome_camera.png "android\_chrome\_camera")

## 2.4. [map.contacttrace.com.au](http://map.contacttrace.com.au)

[map.contacttrace.com.au](http://map.contacttrace.com.au) needs Location access to function fully (but basic features like browsing locations will still work without location access).

**Allow LOCATION Access in Chrome (41 seconds video)**

https://video.contacttrace.com.au/videos/embed/b3df8ae3-9c74-4540-b71d-6396bf1c9982?warningTitle=0&peertubeLink=0

The Map is available from [https://app.contacttrace.com.au](https://app.contacttrace.com.au) under the "Main" menu [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2021/02/android_map.png "android\_map")

When using the Map for the first time, a pop-up window will appear, Select Allow [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2021/02/android_map_popup.png "android\_map\_popup")

To change to a different "Map View", click on the button on the top right hand corner [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2021/02/android_map_types.png "android\_map\_types"). To do a "Category Search", click on the "Magnifying Glass" icon [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2021/02/android_map_category_search.png "android\_map\_category\_search")

# [88.io](http://88.io) Native Android App

Personal Map supports importing data from ANY Android mobile app that exports GPX, KML, GeoJSON. You can find some examples [on the discussion forum](https://discuss.contacttrace.com.au/search?q=%23android%20%23tips "on the discussion forum").

However, our own [geo.88.io](http://geo.88.io) Android App is strongly recommended due its many extra features and you ability to improve it by [joining in its development](https://repository.88.io/contacttrace/geo88io.apk "joining in it development").

For more details of the Citizen Synergy Android App please visit:  
[https://web.contacttrace.com.au/citizen-synergy-android-app/](https://web.contacttrace.com.au/citizen-synergy-android-app/)

## Set Up

Video below shows the setting up of Android phone (including downloading the Android mobile app):

https://video.contacttrace.com.au/videos/embed/f964fde7-295e-48e3-84ba-9b321e45107a?warningTitle=0&peertubeLink=0
1. Tapping the "Mobile App" button on Android will download our own **geo88io.apk** app (previously called citizen synergy)..
2. Once geo88io.apk has been downloaded click on it to install.
3. Allow installation of the app, see Android video above for details.
4. After install, tap on the "Service status" switch to run the service (it will turn to green).
5. Allow the Location and the Storage permissions.
6. Click on "History" to see that service is now logging your locations.

### Import Data

 ![android_import_pin](https://discuss.88.io/uploads/default/original/1X/56d35fd0d2154786c45937b36d703290b2a89c79.png)

**How to import pins**

a. Click on the fourth button on the right and select "Import Pin".

b. Open the "Files" folder and browse to /Documents/88.io/

 ![android_files](https://discuss.88.io/uploads/default/original/1X/5e28edc63cfee1b21a2b0cbbea8076ee57f5028c.png)

c. If the import is successful, a pop-up confirmation window will be displayed.

 ![android_records](https://discuss.88.io/uploads/default/original/1X/570a3faff3839011881c4316e4314a0da98cc868.png)

d. One or more orange pins will be on the map.

 ![android_pin](https://discuss.88.io/uploads/default/original/1X/c367ba34832a0733518e3367ff45a3ee5319f28d.png)

### Export Data

 ![android_phonemap](https://discuss.88.io/uploads/default/original/1X/27336394a9d323af9ca648aa90846dede6707e68.png)

**Go to PHONE MAP -\> 3. Location Files**

To save the pins to a .gpx file, a minimum of 2 pins is required. Select the "Save to Phone" (asp) button and there will be an option to encrypt the file. Tap on "Cancel" to save without encryption.

 ![android_save_gpx_file](https://discuss.88.io/uploads/default/original/1X/e5bc8d293b2671901f4cb6f05cf1e1b989926cd9.png)

To import the .gpx file stored in the phone, select the "Read from Phone" (arp) button and select the "Files" folder and go to the "Download" folder which is the default storage location for most Android devices.

 ![android_files](https://discuss.88.io/uploads/default/original/1X/5e28edc63cfee1b21a2b0cbbea8076ee57f5028c.png)

# Prevent Screen Turning Off

Some phones (e.g. Samsung) STOP collection of Bluetooth Signals when the screen is off.

As can be seen below for a Samsung phone, Bluetooth is not collected when its screen was off.

 ![cs_app_history](https://discuss.88.io/uploads/default/original/1X/34edc44bd4b432974babda443ed0b6533d495df0.jpeg)

Citizen Synergy Android App has a special **NO SCREEN OFF** feature.

If you keep the app displayed on your screen, then your phone's automatic screen off will be disabled - allowing Bluetooth signal collection to continue on those troublesome phones that switches Bluetooth scans off when screen is off.

Note this is OPTIONAL we should have enough data from continuous collection of GNSS, WiFi and Cell Tower signals - which still happens when the screen is off.

# Custom Ringtone

Custom Ringtone notification is available only to Guest Aliases (Share) and Member Aliases (Change).

Available "Send Phone" numbers:  
61282050080  
61282050081  
61282050082  
61282050083  
61282050084  
61282050085  
61282050086  
61282050087  
61282050088  
61282050089  
61282050090  
61282050091  
61282050092  
61282050093  
61282050094  
61282050095  
61282050096  
61282050097  
61282050098  
61282050099

## SET UP

Go to ALIAS -\> 4.Notification -\> Ringtone.

 ![ringtone_part1](https://discuss.88.io/uploads/default/original/1X/868f526c22283593ab0eb887ef0d3615ecd44b39.png)

Send Phone = the Caller ID (DNIS number) displayed on the receiving mobile phone  
Receive Phone = the receiving mobile phone number  
Text Code = the unique digits used by senders to ring you  
Expiry Date = ringtone will no longer active after this date

If the ringtone has been created successfully, it will be shown as below.  
 ![ringtone_part2](https://discuss.88.io/uploads/default/original/1X/2fd58a07481be7946d5023b63259b44c7727a97c.png)

### ADD THE SEND PHONE NUMBER TO THE MOBILE'S ADDRESS BOOK

 ![android_contact](https://discuss.88.io/uploads/default/original/1X/3cd5fcd6dd96e7968fbf82ef083dcf527f6c2450.png)

**Example:**

Name: Covid Exposure Warning  
Mobile: +61 2 8205 0080  
Ringtone: Space Bell

When there is an incoming call from +61 2 8205 0080 number, the Space Bell ring tone will be played. With Android devices, external ringtones can be easily copied to the phone and audio files, such as .mp3 files can also be used as a ring tone.

# Chrome Troubleshooting

You need to ALLOW [app.contacttrace.com.au](http://app.contacttrace.com.au) access to the following from your Android Chrome browser:

1. Location Service
2. Camera Service
3. Add to Home

Allow Android Location

CHROME SET UP

When logging on to [https://app.contacttrace.com.au](https://app.contacttrace.com.au) for the first time, there will be a pop-up window:

_"[app.contacttrace.com.au](http://app.contacttrace.com.au) wants to use your device's location"_

Select "Allow" [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2020/11/android_device_location_small.png "Allow")

If Location Services is NOT working, check Chrome Site settings:

1. Open the Google Chrome app
2. Tap the upper right ![3dots](https://discuss.88.io/uploads/default/original/1X/26d35e68f6c62da578d177ebe1a571f4130c616a.png) menu
3. Tap Settings
4. Tap "Site settings" [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2020/08/android_chrome_site_settings.png "Site settings")
5. Enable "Location" [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2020/08/android_chrome_site_settings_location_enabled.png "Location")

ANDROID SET UP

1. Open the "Settings" app
2. Tap "Location" [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2020/08/android_settings_location.png "Location") and enable it. On some devices, the "Location" image may be different

For some Android phones, the "Location" or "Location service" could be under "Additional Settings".

1. Open the "Settings" app
2. Tap "Additional settings" [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2020/08/android_additional_settings.png "Additional settings")
3. Tap "Safety and privacy" [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2020/08/android_safety_privacy.png "Safety and privacy")
4. Scroll down and tap on "Disabled" [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2020/08/android_safety_privacy_location.png "Disabled")
5. Enable "Location service" [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2020/08/android_safety_privacy_location_enabled.png "Location service")

Allow Android Camera

When logging on to [https://app.contacttrace.com.au](https://app.contacttrace.com.au) for the first time, there will be a pop-up window:

**"[app.contacttrace.com.au](http://app.contacttrace.com.au) wants to use your camera"**

Select "Allow" [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2020/11/android_camera_location_small.png "Allow")

Add to Android Home

1. Open Chrome and navigate to [https://app.contacttrace.com.au](https://app.contacttrace.com.au)
2. Tap the upper right ![3dots](https://discuss.88.io/uploads/default/original/1X/26d35e68f6c62da578d177ebe1a571f4130c616a.png) menu
3. On the row of options, tap on "Add to Home screen" [[show Image]](https://web.contacttrace.com.au/wp-content/uploads/2020/11/android_web_shortcut2.png "Add to Home screen")
4. Enter "Contact Trace" as the title for the shortcut and tap on "Add" [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2020/11/android_web_shortcut3.png "Add")
5. The shortcut is shown on the "Home Screen" [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2020/08/android_web_shortcut4.png "Home Screen")

Traccar can be downloaded under the "Track" menu on [https://app.contacttrace.com.au](https://app.contacttrace.com.au). [[show image]](https://web.contacttrace.com.au/wp-content/uploads/2020/12/traccar_download.png)

The traccar settings for Android [[show Image]](https://web.contacttrace.com.au/wp-content/uploads/2020/12/android_traccar.png)

---

<div class="post-metadata">

**Author:** ![admin](https://discuss.88.io/user_avatar/discuss.88.io/admin/32/38_2.png) [@admin](https://discuss.88.io/u/admin)\
**Post date:** [December 29, 2021, 3:45am UTC](https://discuss.88.io/t/android-user-guide/353/2 "2021-12-29T03:45:04Z")

</div>


