An NMEA location instance.
Contains information about parsed NMEA location.
- Since
- 100.10
- (instancetype) initWithPosition: |
|
(AGSPoint *) |
position |
timestamp: |
|
(nullable NSDate *) |
timestamp |
horizontalAccuracy: |
|
(double) |
horizontalAccuracy |
verticalAccuracy: |
|
(double) |
verticalAccuracy |
velocity: |
|
(double) |
velocity |
course: |
|
(double) |
course |
lastKnown: |
|
(BOOL) |
lastKnown |
additionalSourceProperties: |
|
(NSDictionary< AGSLocationSourcePropertyKey, id > *) |
additionalSourceProperties |
|
|
| |
Creates a location object with timestamp and additional source properties.
An AGSLocation
object can be created from a variety of sources and using different technologies. By supplying the AGSLocation::additionalSourceProperties
property you can allow users to find out how the data was captured.
Information should be provided as an NSDictionary
of key-value pairs, where the AGSLocationSourceProperty
key describes the type of data held in the id
value. You can use any string for the key - but the Runtime SDK recognizes a number of well known keys which should be used if available. See AGSLocationSourcePropertyKey
.
- "floor" - The floor number of the
AGSLocation
object when in a building. Use AGSLocationSourcePropertyKeyFloor
. This key should be associated with an NSNumber
.
- "satelliteCount" - The number of satellites used to fix the
AGSLocation
. Use AGSLocationSourcePropertyKeySatelliteCount
. This key should be associated with an NSNumber
.
- "positionSource" - This key can be used to indicate the position source: GNSS, BLE, WIFI, CELL, IP, where GNSS indicates global navigation satellite system. It is possible to have multiple position sources. In that case positionSource is a list with comma-separated values. Use
AGSLocationSourcePropertyKeyPositionSource
. This key should be associated with an NSString
.
- "transmitterCount" - The number of transmitters used to create an indoor positioning system (IPS) position. Use
AGSLocationSourcePropertyKeyTransmitterCount
. This key should be associated with an NSNumber
.
Keys are case-sensitive.
- Parameters
-
position | A point geometry. |
timestamp | A timestamp when location was received. |
horizontalAccuracy | The horizontal accuracy in meters. Positive values or NaN are supported. |
verticalAccuracy | The vertical accuracy in meters. Positive values or NaN are supported. |
velocity | The location's velocity in meters per second. |
course | The location's course in degrees (clockwise), 0 being true north. |
lastKnown | Indicates whether this is an outdated device position retrieved and cached earlier and therefore not guaranteed to represent the current location. Setting this to YES will render with the AGSLocationDisplay::acquiringSymbol property, typically a grayed out location symbol. |
additionalSourceProperties | An NSDictionary of key-value pairs providing additional meta-data and properties about the source of this AGSLocation object. |
- See also
AGSLocation::additionalSourceProperties
- Since
- 100.10
+ (instancetype) locationWithPosition: |
|
(AGSPoint *) |
position |
timestamp: |
|
(nullable NSDate *) |
timestamp |
horizontalAccuracy: |
|
(double) |
horizontalAccuracy |
verticalAccuracy: |
|
(double) |
verticalAccuracy |
velocity: |
|
(double) |
velocity |
course: |
|
(double) |
course |
lastKnown: |
|
(BOOL) |
lastKnown |
additionalSourceProperties: |
|
(NSDictionary< AGSLocationSourcePropertyKey, id > *) |
additionalSourceProperties |
|
|
| |
Creates a location object with timestamp and additional source properties.
An AGSLocation
object can be created from a variety of sources and using different technologies. By supplying the AGSLocation::additionalSourceProperties
property you can allow users to find out how the data was captured.
Information should be provided as an NSDictionary
of key-value pairs, where the AGSLocationSourceProperty
key describes the type of data held in the id
value. You can use any string for the key - but the Runtime SDK recognizes a number of well known keys which should be used if available. See AGSLocationSourcePropertyKey
.
- "floor" - The floor number of the
AGSLocation
when in a building. Use AGSLocationSourcePropertyKeyFloor
. This key should be associated with an NSNumber
.
- "satelliteCount" - The number of satellites used to fix the
AGSLocation
object. Use AGSLocationSourcePropertyKeySatelliteCount
. This key should be associated with an NSNumber
.
- "positionSource" - This key can be used to indicate the position source: GNSS, BLE, WIFI, CELL, IP, where GNSS indicates global navigation satellite system. It is possible to have multiple position sources. In that case positionSource is a list with comma-separated values. Use
AGSLocationSourcePropertyKeyPositionSource
. This key should be associated with an NSString
.
- "transmitterCount" - The number of transmitters used to create an indoor positioning system (IPS) position. Use
AGSLocationSourcePropertyKeyTransmitterCount
. This key should be associated with an NSNumber
.
Keys are case-sensitive.
- Parameters
-
position | A point geometry. |
timestamp | A timestamp when location was received. |
horizontalAccuracy | The horizontal accuracy in meters. Positive values or NaN are supported. |
verticalAccuracy | The vertical accuracy in meters. Positive values or NaN are supported. |
velocity | The location's velocity in meters per second. |
course | The location's course in degrees (clockwise), 0 being true north. |
lastKnown | Indicates whether this is an outdated device position retrieved and cached earlier and therefore not guaranteed to represent the current location. Setting this to YES will render with the AGSLocationDisplay::acquiringSymbol , typically a grayed out location symbol. |
additionalSourceProperties | An NSDictionary of key-value pairs providing additional meta-data and properties about the source of this AGSLocation . |
- Returns
- A new location object.
- See also
AGSLocation::additionalSourceProperties
- Since
- 100.10
- (NSDictionary<AGSLocationSourcePropertyKey, id>*) additionalSourceProperties |
|
readnonatomiccopyinherited |
A set of key-value pairs providing additional meta-data and properties about the source of this AGSLocation
object.
An AGSLocation
object can be created manually or by a variety of AGSLocationDataSource
types
- for example from the default platform data source or external GPS. When user code receives a new
AGSLocation
object, it can be important to determine how the information was obtained.
In addition, mobile devices may provide different details about their in-built location services. For example, Android systems can provide data on the number of satellites used to find a position, whereas on iOS this information is not available. When a given property is not available to the data source the entry should be omitted from the the AGSLocation::additionalSourceProperties
property.
The AGSLocation::additionalSourceProperties
property provides a means for the creator of an AGSLocation
object to record flexible information such as:
- The confidence level associated with the location
- The method used to obtain the location
- The provenance of the location
Information should be provided as an NSDictionary
of key-value pairs, where the NSString
key describes the type of data held in the id
value. You can use any string for the key - but the Runtime SDK recognizes a number of well known keys which should be used if available. See AGSLocationSourcePropertyKey
.
- "floor" - The floor number of the
AGSLocation
when in a building. Use AGSLocationSourcePropertyKeyFloor
. This key should be associated with an NSNumber
.
- "satelliteCount" - The number of satellites used to fix the
AGSLocation
. Use AGSLocationSourcePropertyKeySatelliteCount
. This key should be associated with an NSNumber
.
- "positionSource" - This key can be used to indicate the position source: GNSS, BLE, WIFI, CELL, IP, where GNSS indicates global navigation satellite system. It is possible to have multiple position sources. In that case positionSource is a list with comma-separated values. Use
AGSLocationSourcePropertyKeyPositionSource
. This key should be associated with an NSString
.
- "transmitterCount" - The number of transmitters used to create an indoor positioning system (IPS) position. Use
AGSLocationSourcePropertyKeyTransmitterCount
. This key should be associated with an NSNumber
.
Keys are case-sensitive.
- Since
- 100.10
|
readnonatomicassigninherited |
The direction in which the device is traveling, measured in degrees starting at due north and continuing clockwise around the compass. Thus, north is 0
degrees, east is 90
degrees, south is 180
degrees, and so on. Course values may not be available on all devices. A negative value indicates that the direction is invalid.
- Since
- 100