ArcGIS Pro 3.7 API Reference Guide
ArcGIS.Desktop.Mapping.DeviceLocation Namespace / MappingDeviceLocationNavigationMode Enumeration
Example Example

In This Topic
    MappingDeviceLocationNavigationMode Enumeration
    In This Topic
    Specifies how the current map view is repositioned using the open device source location (i.e via GPS/GNSS).
    Syntax
    Members
    MemberDescription
    KeepAtCenter Keep map view centered at the device location.
    KeepWithinView Center map view at the device location only when the device location goes outside of the current extent.
    None Map view's extent does not get changed automatically.
    Example
    Get Current Map Device Location Options
    {
        //Gets the current device location options used by the MapDeviceLocationService
        var options = MapDeviceLocationService.Instance.GetDeviceLocationOptions();
        //Device location visibility on the map
        var visibility = options.DeviceLocationVisibility;
        //MappingDeviceLocationNavigationMode
        var navMode = options.NavigationMode;
        //Heading of the location from the device points to the top of the screen
        var trackUp = options.TrackUpNavigation;
        //Show accuracy buffer on the map
        var showBuffer = options.ShowAccuracyBuffer;
    }
    Set Current Map Device Location Options
    {
        //Note: Run within a QueuedTask
        //Check there is a source first...
        if (DeviceLocationService.Instance.GetSource() == null)
            //Setting DeviceLocationOptions w/ no Device Location Source
            //Will throw an InvalidOperationException
            return;
    
        if (!MapDeviceLocationService.Instance.IsDeviceLocationEnabled)
            //Setting DeviceLocationOptions w/ no Device Location Enabled
            //Will throw an InvalidOperationException
            return;
    
        MapDeviceLocationService.Instance.SetDeviceLocationOptions(
          new MapDeviceLocationOptions()
          {
              DeviceLocationVisibility = true,
              NavigationMode = MappingDeviceLocationNavigationMode.KeepAtCenter,
              TrackUpNavigation = true
          });
    }
    Set map view to always be centered on the device location
    {
        // Get the MapDeviceLocationOptions currently used by the MapDeviceLocationService
    
        var currentOptions = MapDeviceLocationService.Instance.GetDeviceLocationOptions();
        if (currentOptions == null)
            return;
        // Set the device location visibility on the map to true
        currentOptions.DeviceLocationVisibility = true;
        //Set the navigation mode to keep the device location at the center of the map
        currentOptions.NavigationMode = MappingDeviceLocationNavigationMode.KeepAtCenter;
        //Note: Run within a QueuedTask
        //Sets the MapDeviceLocationOptions to be updates with these values
        MapDeviceLocationService.Instance.SetDeviceLocationOptions(currentOptions);
    }
    Inheritance Hierarchy

    System.Object
       System.ValueType
          System.Enum
             ArcGIS.Desktop.Mapping.DeviceLocation.MappingDeviceLocationNavigationMode

    Requirements

    Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

    ArcGIS Pro version: 3.0 or higher.
    See Also