Getting started

1. Sign in to the Platform Manager

1. Open the invitation email from your organization's administrator (team@platform.2gis.ru sender) with the Invitation to Platform Manager subject. If you did not receive the email, check your Spam folder or contact your administrator.

2. In the email, click Accept invitation or follow the link in the email.

3. In the opened dialog, verify your email address, create a password for the Platform Manager, and click Sign up.

4. Enter your registration details:

   • last name, first name, and middle name
   • phone number
   • email address
   • password

5. Click Sign up.

6. Open the Platform Manager:

7. Make sure you have access to the project you will be working on and an active CityLens license. If you do not have access, contact your organization's administrator.

2. Install the mobile application

Before installing the mobile application, make sure that the device you will use for recording meets the requirements for mobile devices.

Install the application depending on the operating system of your device:

iOS

The application is installed on iOS devices via TestFlight, the official Apple beta testing service.

1. Install the TestFlight application:

   1. Open the TestFlight page in App Store.
   2. Click Get and Install.

2. Accept the invitation to TestFlight from the Urbi manager:

   1. Open the invitation email to TestFlight or follow the link sent by the manager. The invitation must be accepted on a device with the same Apple ID used in the App Store. If you did not receive the invitation, check your Spam folder or contact the Urbi manager.
   2. Click Start testing.
   3. If the TestFlight application requests you to sign in to your Apple ID, use the same account as in the App Store on this device.
   4. Accept the beta testing terms.

3. Install the CityLens application:

   1. Find the CityLens application (or Cityscan depending on the build) in TestFlight or scan the QR code:

      QR code

      

   2. Click Install and wait for the download to complete.

In the future, you will be able to update the application via TestFlight.

Android

The application is installed on Android devices using F-Droid, a repository of free software for Android.

1. Install the F-Droid application:

   1. Download the F-Droid application from the official website or scan the QR code:

      QR code

      

   2. Open the downloaded .apk file and wait for the installation to complete.

2. Add the CityLens application repository to F-Droid:

   1. Open the F-Droid application.

   2. Go to the Settings section.

   3. Set the maximum value for the Automatic updates period option.

   4. Go to the Repositories section and click +.

   5. In the opened dialog, click Scan QR code and scan the QR code:

      QR code

      

   6. Click Add repository.

3. Install the CityLens application:

   1. Open the F-Droid application.
   2. Go to the Latest section and make sure that the added repository appears in the list.
   3. Find the CityLens application (or Cityscan depending on the build) and click Install.
   4. The application will request access to the device's files and resources. Click Allow and wait for the installation to complete. If the application does not install, check if installing applications from unknown sources is allowed in the device settings.

In the future, you will be able to update the application via F-Droid.

3. (Android only) Grant permissions for the application

Settings names

Depending on the device model, setting names may differ.

1. Allow background activity for the application:

   1. Go to the Settings → Applications → CityLens (or Cityscan depending on the build) → Battery usage section.
   2. Select Allow working in the background.

2. Disable battery optimization:

   1. Go to the Settings → Battery → Battery optimization section.
   2. Find the CityLens application (or Cityscan depending on the build) and select Do not optimize.

3. Allow application auto-start:

   1. Go to the Settings → Battery → Background usage limits section.
   2. Make sure the CityLens application (or Cityscan depending on the build) is not in the Sleeping applications list.

4. Allow the application to send notifications:

   1. Go to the Settings → Applications → CityLens (or Cityscan depending on the build) → Notifications section.
   2. Enable Allow notifications and Show notifications on the lock screen options.

5. Check that the application works in the background. While the application is running, you should receive incoming calls and push notifications, and the application should work when the screen is locked.

4. Configure the application

1. Open the application and tap Sign in with Platform ID.

2. Sign in using the login and password you created when signing up in the Platform Manager.

3. (Recommended) Download an offline map of the territory you plan to drive so that you do not depend on network quality:

   1. Go to the Settings → Maps section.
   2. Select and download the required territories of cities or regions.

5. Prepare for recording

1. In your mobile device settings, enable Wi-Fi (you do not need to connect to any network) and keep it turned on during the recording session. This improves the accuracy of location data and the display of objects and tracks on the map.
2. (Android only) If your device may not have enough storage to record all detour tracks, prepare an external storage device (a flash drive) and a cable to connect it. During recording, you will be able to export tracks to the external storage.
3. Make sure that your device is fully charged. Using the power saving mode is not recommended.
4. Safely mount the device in the car: see the camera and mounting requirements.
5. Review the recording conditions requirements.

What's next?

• Take a photo or record a video while driving.