SENSOR_CATEGORY_LOCATION
The SENSOR_CATEGORY_LOCATION category contains sensors that provide geographic location information.
Platform-Defined Sensor Types
This category includes the following platform-defined sensor types.
Sensor type | Description |
---|---|
|
Sensors that transmit location information by using transmissions such as television or radio frequencies. |
|
Dead-reckoning sensors. These sensors first calculate the current location and then update the current location by using motion data. |
|
Global positioning system sensors. |
|
Lookup sensors, such as those that provide information based on the user's IP address. |
|
Other location sensors. |
|
Fixed-location sensors, such as those that use preset, user-provided information. |
|
Triangulation sensors, such as those that determine current location based on cellular phone tower proximities. |
Platform-Defined Data Fields
Platform-defined property keys for this category are based on SENSOR_DATA_TYPE_LOCATION_GUID:
{055C74D8-CA6F-47D6-95C6-1ED3637A0FF4}
This category includes the following platform-defined data fields.
Data field name and PID | Description |
---|---|
|
VT_LPWSTR Street address, first line. |
|
VT_LPWSTR Street address, second line. |
|
VT_R8 Altitude of the antenna, referenced to sea level, in meters. |
|
VT_R8 Altitude error referenced to the World Geodetic System (WGS 84) reference ellipsoid, in meters. |
|
VT_R8 Altitude referenced to the World Geodetic System (WGS 84) reference ellipsoid, in meters. |
|
VT_R8 Altitude error referenced to sea level, in meters. |
|
VT_R8 Altitude referenced to sea level, in meters. |
|
VT_LPWSTR City. |
|
VT_LPWSTR Country or region, represented as an ISO 3166 1-alpha-2 country/region code. |
|
VT_R8 Age of differential GPS data, in seconds. |
|
VT_I4 ID of the differential reference station. The range is 0000 to 1023. |
|
VT_R8 Accuracy of latitude and longitude values, in meters. A value of zero means that the accuracy level is not known. The Location API gives priority to sensors that provide a non-zero value for this field. |
|
VT_I4 Fix quality 0 = no fix 1 = GPS 2 = DGPS |
|
VT_I4 Fix type 0 = no fix 1 = GPS SPS Mode, fix valid 2 = DGPS SPS Mode, fix valid 3 = GPS PPS Mode, fix valid 4 = Real Time Kinematic 5 = Float RTK 6 = Estimated (dead reckoned) 7 = Manual Input Mode 8 = Simulator Mode |
|
VT_R8 The difference between the WGS-84 ellipsoid and mean sea level. Values less than zero indicate that mean sea level is below the reference ellipsoid. |
|
VT_I4 Operation mode. 0 = Manual. The GPS sensor is set to operate in 2-D or 3-D mode. 1 = Automatic. The GPS sensor can automatically switch between 2-D and 3-D modes. |
|
VT_I4 Selection mode. 0 = Autonomous. 1 = DGPS. 2 = Estimated (dead reckoned). 3 = Manual input. 4 = Simulator. 5 = Data not valid. |
|
VT_I4 Current data status. 1 = Data is valid. 2 = Data is not valid. |
|
VT_R8 Horizontal dilution of precision. |
|
VT_R8 Degrees latitude. North is positive. |
|
VT_R8 Degrees longitude. East is positive. |
|
VT_R8 Heading, in relation to magnetic north, in degrees. |
|
VT_R8 Magnetic variation. East is positive. |
|
VT_LPWSTR The current NMEA sentence string. |
|
VT_R8 Position dilution of precision. |
|
VT_LPWSTR Postal code. |
|
VT_I4 Number of satellites in view. |
|
VT_VECTOR|VT_UI1 Counted array that contains the azimuth of each satellite in view. Data for vector types is always serialized as VT_UI1 (an array of unsigned, 1-byte characters). This data field actually contains each value as an IEEE 8-byte real value (VT_ R8). Use -1 as a placeholder for empty values. For information about working with arrays, see Retrieving Vector Types. |
|
VT_VECTOR|VT_UI1 Counted array that contains the elevation of each satellite in view. Data for vector types is always serialized as VT_UI1 (an array of unsigned, 1-byte characters). This data field actually contains each value as an IEEE 8-byte real value (VT_R8). Use -91 as a placeholder for empty values. For information about working with arrays, see Retrieving Vector Types. |
|
VT_VECTOR|VT_UI1 Counted array that contains the ID of each satellite in view. Data for vector types is always serialized as VT_UI1 (an array of unsigned, 1-byte characters). This data field actually contains each value as a 4-byte unsigned integer (VT_UI4). For information about working with arrays, see Retrieving Vector Types. |
|
VT_VECTOR|VT_UI1 Counted array that contains pseudorandom noise codes for satellites in view. Data for vector types is always serialized as VT_UI1 (an array of unsigned, 1-byte characters). This data field actually contains each value as a 4-byte unsigned integer (VT_UI4). Use zero (0) as a placeholder for empty values. For information about working with arrays, see Retrieving Vector Types. |
|
VT_VECTOR|VT_UI1 Counted array that contains the signal-to-noise ratio for satellites in view. Data for vector types is always serialized as VT_UI1 (an array of unsigned, 1-byte characters). This data field actually contains each value as an IEEE 8-byte real value (VT_R8). Use zero (0) as a placeholder for empty values. For information about working with arrays, see Retrieving Vector Types. |
|
VT_I4 Number of satellites that are used in a solution. |
|
VT_VECTOR|VT_UI1 Counted array that contains pseudorandom noise codes for satellites that are used in a solution. Data for vector types is always serialized as VT_UI1 (an array of unsigned, 1-byte characters). This data field must contain each value as a 4-byte unsigned integer (VT_UI4). Use zero (0) as a placeholder for empty values. For information about working with arrays, see Retrieving Vector Types. |
|
VT_VECTOR|VT_UI2 Counted array that contains pseudorandom noise codes for satellites that are used in a solution. Data for vector types is always serialized as VT_UI2 (an array of unsigned, 2-byte characters). This data field must contain each value as a 4-byte unsigned integer (VT_UI4). Use zero (0) as a placeholder for empty values. For information about working with arrays, see Retrieving Vector Types. |
|
VT_R8 Speed, in knots. |
|
VT_LPWSTR State/province. |
|
VT_R8 Heading, in relation to true north, in degrees. |
|
VT_R8 Vertical dilution of precision. |
Requirements
Requirement | Value |
---|---|
Minimum supported client |
Windows 7 [desktop apps only] |
Minimum supported server |
None supported |
Header |
|
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for