Launch Live Tracking from Outside the Salesforce Maps Mobile App

Prerequisites
In order to utilize deep linking, the following must be completed.
 

• Requires user already authenticated in Salesforce Maps and Salesforce Maps app on the mobile device
• The user must be assigned the ‘Salesforce Maps’ and ‘Salesforce Maps Live Mobile Tracking’ permission set licenses.
• The user must be assigned the ‘SF Maps’ and ‘SF Maps Live Mobile Tracking’ permission sets.
• The user must be assigned to a Maps Permission Group with the ‘Enable Live Mobile Tracking’ permission.
• Android users must enable internal.sfmapsapi.com as a supported web address via their Android settings for the Salesforce Maps app by following these steps:
  • Navigate to Android settings
  • Click Apps
  • Click Salesforce Maps
  • Click Set As Default
  • Click Supported Web Addresses
  • Toggle on internal.sfmapsapi.com

Considerations
Please consider the following while utilizing the deep link.

• The use of this deep link only enables live tracking and cannot be utilized to disable live tracking.
• The use of the deep link creates an overlay modal on the current state of the Salesforce Maps app, and once the overlay is dismissed, anything currently plotted will be left in place if the app is already set up in the background.
• A user may be prompted to “open with Salesforce Maps” or “open with browser.” The deep link will only work when set to open with Salesforce Maps.
• The deep link will not work by copying directly into a browser as it requires “launching” in an app since the device effectively looks for apps to handle the link prior to launching and defaults to the browser if necessary. Starting in the browser bypasses the “looking” process and ends up staying in the browser. For testing, launching from Apple notes or an email should be sufficient.
• The use of this deep link is supported for both Android and iOS devices.

Creating an Action Within Salesforce
Please use the following code snippets in order to create an action inside of the Salesforce app to launch live tracking.
 

1. Create a Lightning Component using the following code snippets
   1. Component
      1. <aura:component implements="force:lightningQuickAction" >
         <aura:handler name="init" value="{!this}" action="{!c.doInit}"/>
         <lightning:navigation aura:id="navService"/>
         </aura:component>
   2. Controller
      1. ({
         doInit : function(cmp, event, helper) {
         var navService = cmp.find("navService");
         // Sets the route to /lightning/o/Account/home
         var pageReference = {
         "type": "standard__webPage",
         "attributes": {
         "url": "https://internal.sfmapsapi.com/mul?starttracking=true"
         }
         };
         navService.navigate(pageReference);
         }
         })
2. Create an action with the action type of lightning component and select the newly created lightning component
3. Add the action to a Salesforce page

Additional Information
Interested in launching the Salesforce Maps mobile app without launching live tracking? Simply use the URL below instead.
 

"https://internal.sfmapsapi.com/mul?"