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