Open Method (DeviceLocationService)

In This Topic

Connects to a new device location source such as a GPS/GNSS device via a COM port. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

Visual Basic (Declaration)
C#

Public Sub Open( _
   ByVal source As DeviceLocationSource, _
   Optional ByVal props As DeviceLocationProperties _
)

public void Open( 
   DeviceLocationSource source,
   DeviceLocationProperties props
)

Parameters

source: A DeviceLocationSource.
props: A DeviceLocationProperties.

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.
System.ArgumentNullException	Value cannot be null: source
System.ArgumentException	DeviceLocationSource ComPort cannot be null

Remarks

At a minimum, a ComPort must be specified in the DeviceLocationSource parameter.

Example

var sp = new SerialPortDeviceLocationSource()
{
  ComPort = "COM4",
};
            
await QueuedTask.Run(() =>
{
  DeviceLocationService.Instance.Open(sp);
});

Connect to a Device Location Source

{
    var newSrc = new SerialPortDeviceLocationSource();
    //Specify the COM port the device is connected to
    newSrc.ComPort = "Com3";
    newSrc.BaudRate = 4800;
    newSrc.AntennaHeight = 3;  // meters
                               //fill in other properties as needed

    var props = new DeviceLocationProperties();
    props.AccuracyThreshold = 10;   // meters

    // jump to the background thread
    //Note: Run within a QueuedTask
    //open the device
    DeviceLocationService.Instance.Open(newSrc, props);
}

Requirements

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

ArcGIS Pro version: 3.0 or higher.

Reference

DeviceLocationService Class
DeviceLocationService Members

Send feedback