MapMatchedLocation (API Reference)
Class MapMatchedLocation
Describes a map-matched location in the world at a given time.
-
Field Summary
FieldsModifier and TypeFieldDescriptionThe bearing orientation points to the direction of travel, and has the same angle as the street where it is matched to.doubleConfidence level (between 0 and 1) of the matched location.The geographic coordinates of the map-matched location.Horizontal accuracy measure of location.booleanDetermines if the travel direction on a one-way street is against the allowed traffic direction.longOffset from start of segment in centimeters.Reference to the current segment.Speed in meters per second.Timestamp of the map matched position. -
Constructor Summary
ConstructorsConstructorDescriptionMapMatchedLocation(GeoCoordinates coordinates, Double bearingInDegrees) Creates a new instance. -
Method Summary
-
Field Details
-
coordinates
The geographic coordinates of the map-matched location.
-
bearingInDegrees
The bearing orientation points to the direction of travel, and has the same angle as the street where it is matched to. Therefore, it must not necessarily be the same as the bearing of a location source. Starts at 0 in the geographic north and rotates in a clockwise direction around the compass. It means that for going north it's equal to 0, for northeast it's equal to 45, for east it's equal to 90, and so on. If it cannot be determined, the value is
null. Otherwise, it is guaranteed to be in the range [0, 360). -
segmentReference
Reference to the current segment. The ratio of
segmentOffsetInCentimetersto the segment length is betweenSegmentReference.offsetStartandSegmentReference.offsetEnd. -
segmentOffsetInCentimeters
public long segmentOffsetInCentimetersOffset from start of segment in centimeters.
-
confidence
public double confidenceConfidence level (between 0 and 1) of the matched location. A low confidence value means that the map-matched vehicle location is not reliable and it may not be clear which part of the road the vehicle has taken. This can happen when the accuracy or frequency of the provided location updates is poor. If the confidence level is too small then, for example, overspeed warnings may be also inaccurate.
-
isDrivingInTheWrongWay
public boolean isDrivingInTheWrongWayDetermines if the travel direction on a one-way street is against the allowed traffic direction. For two-way streets, this value is always
false. This feature is supported in tracking mode and when deviating from a route. Note that the travel direction is determined based on the map-matched location. -
horizontalAccuracyInMeters
Horizontal accuracy measure of location. Estimated based on accuracy of input location and confidence of this map-matched location. Currently this value is not being provided by the Navigator.
-
speedInMetersPerSecond
Speed in meters per second.
Note: This is a beta release of this feature, so there could be a few bugs and unexpected behaviors. Related APIs may change for new releases without a deprecation process.
-
timestamp
Timestamp of the map matched position.
Note: This is a beta release of this feature, so there could be a few bugs and unexpected behaviors. Related APIs may change for new releases without a deprecation process.
-
-
Constructor Details
-
MapMatchedLocation
Creates a new instance.
- Parameters:
coordinates-The geographic coordinates of the map-matched location.
bearingInDegrees-The bearing orientation points to the direction of travel, and has the same angle as the street where it is matched to. Therefore, it must not necessarily be the same as the bearing of a location source. Starts at 0 in the geographic north and rotates in a clockwise direction around the compass. It means that for going north it's equal to 0, for northeast it's equal to 45, for east it's equal to 90, and so on. If it cannot be determined, the value is
null. Otherwise, it is guaranteed to be in the range [0, 360).
-
-
Method Details