11 Use the Oracle IoT Fleet Monitoring Mobile App

Drivers are integral to the success of your fleet operations. Drivers use the Oracle IoT Fleet Monitoring Mobile Application to update and review trip and vehicle information, and to start and complete trips or shipments.

With the Oracle IoT Fleet Monitoring Mobile Application, drivers can:

  • View trip information including planned stops and estimated trip duration.

  • Start trips, complete trips, and cancel trips.

  • Start shipments and track shipments.

There are two flavors of the Oracle IoT Fleet Monitoring Mobile app, one for the private fleet drivers and another for the third party carrier drivers. Drivers need to install the Oracle IoT Fleet Monitoring app from Google Play or Apple App Store. A private fleet driver can launch and log-in into the installed app where as a third party carrier's driver receives a URL link in an email, using which the driver can launch and log-in into the installed app on the mobile device.

Use the Mobile App as a Private Fleet Driver

As a private fleet driver, you can use the Oracle IoT Fleet Monitoring mobile app to manage and monitor vehicles and trips or shipments on a mobile device.

Before you log in to the Oracle IoT Fleet Monitoring mobile app, you must have an user account and know the URL of the Oracle IoT Fleet Monitoring Cloud Service server.

Note:

If you have previously installed the Oracle IoT Fleet Monitoring mobile app, complete steps 3 to 6 of the procedure to open the application.
  1. Install the Oracle IoT Fleet Monitoring mobile app:
    1. Open an internet browser on your Apple or Android device.
    2. Browse to the Apple App Store or Google Play.
    3. Search for Oracle IoT Fleet Monitoring.
    4. Install the Oracle IoT Fleet Monitoring application on your mobile device.
  2. Open the Oracle IoT Fleet Monitoring mobile app and then read and agree to the legal terms. You'll see the End User License Agreement screen at the first launch of the app.
  3. Enter the user name for the Oracle IoT Fleet Monitoring Cloud Service server in the Username field.
  4. Enter the password for the Oracle IoT Fleet Monitoring Cloud Service server in the Password field.
  5. Enter the Oracle IoT Fleet Monitoring Cloud Service URL in the Server field.
    The URL is of the form https://iot-host-name or https://iot-host-name/fm
  6. Tap the Forward (Forward icon) button.
  7. If you have more than one organizations, select the organization to log in to, and tap Continue.

    To configure your device as a third party carrier's driver, see Use the Mobile App as a Third Party Carrier's Driver.

Create a New Trip With an Existing Trip Template

Use an existing trip template to assign a vehicle to an existing trip route.

  1. Tap Create a Trip from a Template.
  2. Tap an existing trip template.
  3. Tap the Forward (Forward icon) icon.
  4. Select or search for a vehicle to assign to the trip.
  5. Tap Start Trip.
  6. To complete or cancel the ongoing trip, select one of these options:
    • Tap Complete to indicate that the trip is complete.
    • Tap Cancel to cancel the trip.

Repeat a Recent Trip

Repeat a recent trip when the same trip is taken again.

  1. Tap Repeat Recent Trip.
  2. Tap a recent trip.
  3. Tap the Forward (Forward icon) icon.
  4. Optionally changed the vehicle assigned to the trip.
  5. Tap Start Trip.
  6. To complete or cancel the ongoing trip, select one of these options:
    • Tap Complete to indicate that the trip is complete.
    • Tap Cancel to cancel the trip.

Create a Custom Trip

Create a custom trip to create a new route for a vehicle.

  1. Tap Create a Custom Trip.
  2. Tap Set Start Location. If the location permissions have not been set, then the Android location permissions dialog box is displayed.
  3. If you are using the app on a mobile device running Android version prior to 10, then click Allow to grant location permission.
  4. If you are using the app on a mobile device running Android version 10 or later, then click While using the app or Only this time. If you select the Deny option, then an error message stating that the location authorization request is declined is displayed.
  5. Enter the starting address for the trip.
  6. Tap Confirm Location
  7. (Optional) To add a stop to the trip route, tap Set Stop Location, enter the address for the stop, select a duration in the Choose Duration list, and then tap Confirm Location . Repeat this step to add additional stops to the trip route.
  8. Tap Set Finish Location. If the location permissions have not been set, then the Android location permissions dialog box is displayed. See Steps 3 and 4 for more information about setting location permissions.
  9. Enter the finish address for the trip and then select a duration in the Choose Duration list.
  10. Tap Confirm Location
  11. Tap the Forward (Forward icon) button.
  12. Tap Create Trip.
  13. Select or search for a vehicle to assign to the trip.
  14. On the Trip Confirmation screen, optionally change the assigned vehicle for the trip.
  15. Tap Start Trip.
  16. To complete or cancel the ongoing trip, select one of these options:
    • Tap Complete to indicate the trip is complete.
    • Tap Cancel to cancel the trip.

Change a Vehicle Assignment

Change your vehicle assignment when an assigned vehicle is unavailable due to maintenance or a breakdown.

  1. Tap the Forward (Forward icon) icon in the Assigned Vehicle area of the Welcome screen.
  2. Search for a vehicle or tap Select to select a vehicle in the Assigned Vehicle list.
  3. Tap Confirm.
  4. Tap the Back (Back icon) icon at the top of the screen to return to the Welcome screen.

Start Trips

A registered driver after logging into the Oracle IoT Fleet Monitorring app can view the assigned trips and start a specific trip.

As a private fleet driver, you can use the Oracle IoT Fleet Monitoring app to assign a vehicle to a trip and start it. Ensure that you have installed and configured the app in your mobile device.
  1. Before you access the Oracle IoT Fleet Monitoring mobile app, view the workflow to start a trip as a private fleet driver or a third-party driver from About Private Fleet Trips and About Third-Party Carrier Trips.
  2. Access the Oracle IoT Fleet Monitoring mobile app. To sign in as a private fleet driver, enter your driver credentials and the instance URL in this format: https://myiotcs.mydomain.oraclecloud.com. To sign as a third-party driver, use the link and other security information you've received in the email.
  3. Tap Start a Trip.
  4. If a vehicle is not assigned to you, tap the Edit Edit icon icon at the top of the screen.
  5. Tap Select to select a vehicle in the Assigned Vehicle list. Tap Confirm.
  6. Tap the Back Back icon icon at the top of the screen to return to the Trips list.
  7. Tap a trip in the trips list and then tap Start Trip.
  8. (Optional) Tap the List List icon icon at the top of the screen to view detailed information about the current trip including scheduled stops and the duration between stops.
  9. Click the Map Map icon icon to return to the map view.
  10. (Optional) At the bottom-right corner of the trip map, tap the Remark button to enter any comments en-route and then tap the Save button. For example, you can enter comments such as "Reached Stop <stop name> on time".
  11. After reaching the last stop, you can tap Complete to indicate the trip is complete. If required, you can force complete a trip that is en-route anytime by tapping Complete.
  12. On the Confirmation screen, if the delivery is complete, select YES. Otherwise, select No. Enter remarks, if any, in the text area and then tap Proceed.
    On the Trip Overview screen, the trip appears as completed.
The trip delivery status and corresponding remarks, if any, from the Fleet Monitoring mobile app are propagated to Oracle Fleet Monitoring and are displayed in the corresponding DELIVERY COMPLETED and DELIVERY REMARKS columns of the Trips Summary view as well as transmitted over to Oracle Transportation Management system.

Start a Shipment

Start a shipment that you will be transporting in your vehicle so its progress can be monitored by the Fleet Manager.

Note:

The Shipment business object will be deprecated in a future release. Hence it is recommended to use Trips for real-time monitoring of in-transit movements.
  1. Tap Start a Shipment.
  2. If a vehicle is not assigned to you, tap the Edit (Edit icon) icon at the top of the screen.
  3. Tap Select to select a vehicle in the Assigned Vehicle list.
  4. Tap Confirm.
  5. Tap the Back (Back icon) icon at the top of the screen to return to the Shipments list.
  6. Tap a shipment in the Shipments list and then tap Start First Shipment.
  7. (Optional) Tap the List (List icon) icon at the top of the screen to view detailed information about the current trip including scheduled stops and the duration between stops. Click the Map (Map icon) icon to return to the map view.
  8. (Optional) At the bottom-right corner of the map, tap the Remark button to enter any comments en-route and then tap the Save button. For example, you can enter comments such as "Reached Stop <stop name> on time".
  9. After reaching the last stop, you can tap Complete to indicate the shipment is complete. If required, you can force complete a shipment that is en-route anytime by tapping Complete.
  10. On the Confirmation screen, if the delivery is complete, select YES. Otherwise, select No. Enter remarks, if any, in the text area and then tap Proceed.
    On the Shipment Overview screen, the shipment appears as completed.

Track a Shipment

Shipment tracking lets third-party carriers identify the location and progress of a shipment in Oracle Transportation Management. To begin shipment tracking, a driver receives an email notification with a link that opens the Oracle IoT Fleet Monitoring Mobile Application. After the driver correctly answers the challenge questions, the driver starts the shipment and then location data is sent to Oracle Transportation Management.

Note:

  • The shipment tracking feature is available only on Android devices.

  • Install the Oracle IoT Fleet Monitoring Mobile Application on the driver’s mobile device before tracking a shipment. If the Oracle IoT Fleet Monitoring Mobile Application is not installed before the driver selects the tracking link, an error message appears on the driver's mobile device.

  1. Install the Oracle IoT Fleet Monitoring Mobile Application on the driver’s mobile device:
    1. Open an internet browser on your mobile Android device.
    2. Browse to Google Play.
    3. Search for Oracle IoT Fleet Monitoring.
    4. Install the Oracle IoT Fleet Monitoring Mobile Application on the driver’s mobile device.
    5. Read and agree to the Shipment Monitoring application legal terms.
  2. Open the email with the shipment tracking link and then select the tracking link. The app opens.
  3. If the location permissions have not been set, then you need to provide the location permissions as follows:
    1. If you are using an app version prior to 21.2.1 on Android version prior to 10, then the Android location permissions dialog box is displayed. Click Allow to grant location permission.
    2. If you are using app version 21.2.1 or later on Android version prior to 10, then you are prompted with an in-app notice to permit the app to use your location data. Select Accept. In the resulting Android location permissions dialog box, click Allow to grant location permission. If you decline the in-app notice, then the app will not work and an error message stating that the location authorization request is declined is displayed.
    3. If you are using an app version prior to 21.2.1 on Android version 10 or later, then the Android location permissions dialog box is displayed with the options While using the app, Only this time, and Deny. This older version app does not have the option to request for background location permission. If you select the While using the app or Only this time option, then you can get the location pings only when the app is running in the foreground. If you select the Deny option, then an error message stating that the location authorization request is declined is displayed. It is recommended that you update the app to the latest version to allow background location permission so that location pings are available even when the app is running in the background or closed.
    4. If you are using app version 21.2.1 or later on Android version 10 or later, then you are prompted with an in-app notice to permit the app to use your location data. Select Accept. In the resulting Android location permissions dialog box, click Allow in settings. If you decline the in-app notice, the app will not work and an error message stating that the location authorization request is declined is displayed. In the resulting Location permission screen, select Allow all the time.

      You can alternatively select Allow only while using the app. However, it is recommended to select the Allow all the time option to access shipment location even when the app is running in the background or when the app is closed.

      If you select the Ask every time or Deny option, then an error message stating that the location authorization request is declined is displayed.

  4. After accepting location permissions, a Storage permission screen is displayed. Select Allow to permit the app to access your device storage. The app uses the storage to store device data to communicate with Oracle Internet of Things Cloud Service.
  5. On the User Verification screen, successfully answer the two challenge questions. You have three attempts to answer the challenge questions correctly. If you fail to answer the challenge questions correctly, you can retry the questions after a five minute time-out.
    Challenge questions appear only for the first shipment. Challenge questions do not appear for subsequent shipments.
  6. Tap Proceed.
  7. Review the shipment details and then tap Start Shipment.
  8. When the shipment is complete, tap Complete Shipment and then tap Yes.

Apply Best Practices

Review and apply the best practices when you configure your mobile device and instal the Oracle IoT Fleet Monitoring mobile app for seamless communication and data flow between the app and Oracle IoT Fleet Monitoring Application.

Best Practices

As a driver, when you use the Oracle IoT Fleet Monitoring Mobile application, apply these best practices on your mobile device for seamless and continuous communication between the app and the Oracle IoT Fleet Monitoring Application.

  • When you are on an active trip or shipment, avoid clearing the Oracle IoT Fleet Monitoring mobile app's cache in your device.
  • Ensure your mobile device is charged and has sufficient battery power.