Class NmeaLocationDataSource
An NMEA data source object.
Namespace: Esri.ArcGISRuntime.Location
Assembly: Esri.ArcGISRuntime.dll
Syntax
public class NmeaLocationDataSource : LocationDataSourceRemarks
This object will parse specific NMEA messages pushed into it. Valid GGA, GSA, GST, GSV, RMC, VTG messages are parsed and, depending upon the message type and contents, a LocationChanged or SatellitesChanged may be raised. The LocationChanged will return a NmeaLocation object. The SatellitesChanged will return an array of NmeaSatelliteInfo objects. This data source is based on NMEA version 4.11 (November 2018).
The Apple AppStore has guidelines and restrictions for apps that communicate with MFi accessories (for example: an external GPS receiver). Apps that use NMEA data need to satisfy the Apple requirements to be accepted in the store. Apps need to declare support via PPID in their submission and the MFi provider needs to list the bundle ID so Apple can cross reference it. For more information see the site, MFi Program.
Make sure the NmeaDataStream property is assigned to an NMEA stream prior to starting the datasource.
Constructors
| Name | Description |
|---|---|
| NmeaLocationDataSource() | Initializes a new instance of the NmeaLocationDataSource class. |
| NmeaLocationDataSource(SpatialReference) | Initializes a new instance of the NmeaLocationDataSource class. |
| NmeaLocationDataSource(SpatialReference, SpatialReference) | Initializes a new instance of the NmeaLocationDataSource class. |
| NmeaLocationDataSource(SpatialReference, SpatialReference, DatumTransformation) | Initializes a new instance of the NmeaLocationDataSource class. |
Properties
| Name | Description |
|---|---|
| NmeaDataStream | Gets or sets the NMEA datastream that this datasource is processing NMEA data from. This property must be set before starting the datasource, or if subclassing, during OnStartAsync(). |
| OutputDatumTransformation | Gets the DatumTransformation to be used in the project operation. |
| OutputSpatialReference | Gets the spatial reference that will be used to perform an optional project operation for the location. |
| ReceiverSpatialReference | Gets the SpatialReference that the GPS receiver is using for its reported NmeaLocation, the default is WGS84. |
Methods
| Name | Description |
|---|---|
| FromBluetooth(RfcommDeviceService) | Creates a NMEA LocationDataSource based on a serial port. |
| FromSerialPort(DeviceInformation, Nullable<UInt32>) | Creates a NMEA LocationDataSource based on a serial port. |
| FromStreamCreator(Func<NmeaLocationDataSource, Task<Stream>>, Func<NmeaLocationDataSource, Task>) | Returns a NmeaLocationDataSource that will create the NMEA stream on StartAsync(), and destroy on StopAsync() using the provided start/stop methods. |
| OnStartAsync() | Called when location tracking has started |
| OnStopAsync() | Called when location tracking has stopped |
Events
| Name | Description |
|---|---|
| SatellitesChanged | Raised when the satellite info has changed for the location data source. |
Applies to
| Target | Versions |
|---|---|
| .NET Standard 2.0 | 100.10 - 200.2 |
| .NET 6.0 | 100.13 - 200.2 |
| .NET 6.0 Windows | 100.13 - 200.2 |
| .NET 6.0 Android | 200.0 - 200.2 |
| .NET 6.0 iOS | 200.0 - 200.2 |
| .NET Framework | 100.10 - 200.2 |
| .NET 5 | 100.10 - 100.12 |
| .NET Core 3.1 | 100.10 - 100.12 |
| Android | 100.10 - 100.15 |
| iOS | 100.10 - 100.15 |
| UWP | 100.10 - 200.2 |