ArcGIS Pro 3.7 API Reference Guide
ArcGIS.Desktop.Mapping.DeviceLocation Namespace / MapDeviceLocationService Class / GetDeviceLocationOptions Method
Example

In This Topic
    GetDeviceLocationOptions Method (MapDeviceLocationService)
    In This Topic
    Gets the MapDeviceLocationOptions currently used by the MapDeviceLocationService.
    Syntax
    Public Function GetDeviceLocationOptions() As MapDeviceLocationOptions
    public MapDeviceLocationOptions GetDeviceLocationOptions()

    Return Value

    Exceptions
    ExceptionDescription
    The active map view cannot be null
    Remarks
    There must be an active map view. If the active map view is null an System.InvalidOperationException will be thrown
    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 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);
    }
    Requirements

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

    ArcGIS Pro version: 3.0 or higher.
    See Also