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 | Meaning |
---|---|
SENSOR_TYPE_LOCATION_BROADCAST |
Sensors that transmit location information through transmissions such as television or radio frequencies. |
SENSOR_TYPE_LOCATION_DEAD_RECKONING |
Dead-reckoning sensors. These sensors first calculate the current location and then update the current location by using motion data. |
SENSOR_TYPE_LOCATION_GPS |
Global positioning system sensors. |
SENSOR_TYPE_LOCATION_LOOKUP |
Lookup sensors, such as those that provide information based on the user's IP address. |
SENSOR_TYPE_LOCATION_OTHER |
Other location sensors. |
SENSOR_TYPE_LOCATION_STATIC |
Fixed-location sensors, such as those that use preset, user-provided information. |
SENSOR_TYPE_LOCATION_TRIANGULATION |
Triangulation sensors, such as those that determine the current location based on cellular phone tower proximities. |
Platform-defined Data Fields
This category includes the following platform-defined data fields.
Data type | Type | Meaning |
---|---|---|
SENSOR_DATA_TYPE_ADDRESS1 |
VT_LPWSTR |
Street address, first line. |
SENSOR_DATA_TYPE_ADDRESS2 |
VT_LPWSTR |
Street address, second line. |
SENSOR_DATA_TYPE_ALTITUDE_ANTENNA_SEALEVEL_METERS |
VT_R8 |
Altitude of the antenna, that is referenced to sea level, in meters. |
SENSOR_DATA_TYPE_ALTITUDE_ELLIPSOID_ERROR_METERS |
VT_R8 |
Altitude error referenced to the World Geodetic System (WGS 84) reference ellipsoid, in meters. |
SENSOR_DATA_TYPE_ALTITUDE_ELLIPSOID_METERS |
VT_R8 |
Altitude referenced to the World Geodetic System (WGS 84) reference ellipsoid, in meters. |
SENSOR_DATA_TYPE_ALTITUDE_SEALEVEL_ERROR_METERS |
VT_R8 |
Altitude error referenced to sea level, in meters. |
SENSOR_DATA_TYPE_ALTITUDE_SEALEVEL_METERS |
VT_R8 |
Altitude referenced to sea level, in meters. |
SENSOR_DATA_TYPE_CITY |
VT_LPWSTR |
City. |
SENSOR_DATA_TYPE_COUNTRY_REGION |
VT_LPWSTR |
Country or region, represented as an ISO 3166 1-alpha-2 country code. |
SENSOR_DATA_TYPE_DGPS_DATA_AGE |
VT_R8 |
Age of differential GPS data, in seconds. |
SENSOR_DATA_TYPE_DIFFERENTIAL_REFERENCE_STATION_ID |
VT_I4 |
ID of the differential reference station. The range is 0000 to 1023. |
SENSOR_DATA_TYPE_ERROR_RADIUS_METERS |
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 will give priority to sensors that provide a non-zero value for this field. |
SENSOR_DATA_TYPE_FIX_QUALITY |
VT_I4 |
Fix quality. 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 |
SENSOR_DATA_TYPE_FIX_TYPE |
VT_I4 |
Fix type. 0 = no fix 1 = 2d fix 2 = 3d fix |
SENSOR_DATA_TYPE_GEOIDAL_SEPARATION |
VT_R8 |
The difference between the WGS-84 ellipsoid and the mean of sea level. Values less than zero indicate that the mean sea level is below the reference ellipsoid. |
SENSOR_DATA_TYPE_GPS_OPERATION_MODE |
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. |
SENSOR_DATA_TYPE_GPS_SELECTION_MODE |
VT_I4 |
Selection mode. 0 = Autonomous. 1 = DGPS. 2 = Estimated (dead reckoned). 3 = Manual input. 4 = Simulator. 5 = Data not valid. |
SENSOR_DATA_TYPE_GPS_STATUS |
VT_I4 |
Current data status. 1 = Data is valid. 2 = Data is not valid. |
SENSOR_DATA_TYPE_HORIZONAL_DILUTION_OF_PRECISION |
VT_R4 |
Horizontal dilution of precision. |
SENSOR_DATA_TYPE_LATITUDE_DEGREES |
VT_R8 |
Degrees latitude. North is positive. |
SENSOR_DATA_TYPE_LONGITUDE_DEGREES |
VT_R8 |
Degrees longitude. East is positive |
SENSOR_DATA_TYPE_MAGNETIC_HEADING_DEGREES |
VT_R4 |
Heading, in relation to magnetic north, in degrees. |
SENSOR_DATA_TYPE_MAGNETIC_VARIATION |
VT_R4 |
Magnetic variation. East is positive. |
SENSOR_DATA_TYPE_NMEA_SENTENCE |
VT_LPWSTR |
The current NMEA sentence string. |
SENSOR_DATA_TYPE_POSITION_DILUTION_OF_PRECISION |
VT_R4 |
Position dilution of precision. |
SENSOR_DATA_TYPE_POSTALCODE |
VT_LPWSTR |
Postal code. |
SENSOR_DATA_TYPE_SATELLITES_IN_VIEW |
VT_I4 |
Number of satellites in view. |
SENSOR_DATA_TYPE_SATELLITES_IN_VIEW_AZIMUTH |
VT_VECTOR|VT_UI1 |
Counted array that contains azimuth of each satellite in view. Data for vector types is always serialized as VT_UI1 (an array of unsigned, one-byte characters). This data field must contain each value as an IEEE eight-byte real value (VT_ R8). Use -1 as a placeholder for empty values. |
SENSOR_DATA_TYPE_SATELLITES_IN_VIEW_ELEVATION |
VT_VECTOR|VT_UI1 |
Counted array that contains elevation of each satellite in view. Data for vector types is always serialized as VT_UI1 (an array of unsigned, one-byte characters). This data field must contain each value as an IEEE eight-byte real value (VT_R8). Use -91 as a placeholder for empty values. |
SENSOR_DATA_TYPE_SATELLITES_IN_VIEW_ID |
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, one-byte characters). This data field must contain each value as a four-byte unsigned integer (VT_UI4). |
SENSOR_DATA_TYPE_SATELLITES_IN_VIEW_PRNS |
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, one-byte characters). This data field must contain each value as a four-byte unsigned integer (VT_UI4). Use zero as a placeholder for empty values. |
SENSOR_DATA_TYPE_SATELLITES_IN_VIEW_STN_RATIO |
VT_VECTOR|VT_UI1 |
Counted array that contains signal-to-noise ratio for satellites in view. Data for vector types is always serialized as VT_UI1 (an array of unsigned, one-byte characters). This data field must contain each value as an IEEE eight-byte real value (VT_R8). Use zero as a placeholder for empty values. |
SENSOR_DATA_TYPE_SATELLITES_USED_COUNT |
VT_I4 |
Number of satellites that are used in a solution. |
SENSOR_DATA_TYPE_SATELLITES_USED_PRNS |
VT_VECTOR|VT_UI1 |
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, one-byte characters). This data field must contain each value as a four-byte unsigned integer (VT_UI4). Use zero as a placeholder for empty values. |
SENSOR_DATA_TYPE_SPEED_KNOTS |
VT_R4 |
Speed, in knots. |
SENSOR_DATA_TYPE_STATE_PROVINCE |
VT_LPWSTR |
State/province. |
SENSOR_DATA_TYPE_TRUE_HEADING_DEGREES |
VT_R4 |
Heading, in relation to true north, in degrees. |
SENSOR_DATA_TYPE_VERTICAL_DILUTION_OF_PRECISION |
VT_R4 |
Vertical dilution of precision. |
Important Each platform-defined location data type PROPERTYKEY is based on a common GUID that is named SENSOR_DATA_TYPE_LOCATION_GUID. As it is a reserved base value, do not use this GUID to define your own property keys.
Requirements
Minimum supported client |
Windows 7 |
Minimum supported server |
None supported |
Version |
Available in Windows 7. |
Header |
Sensors.h |
Send comments about this topic to Microsoft
Build date: 11/29/2012