Class MapMatchedLocation
- Last UpdatedJun 10, 2025
- 3 minute read
- java.lang.Object
-
- com.here.sdk.navigation.MapMatchedLocation
-
public final class MapMatchedLocation extends java.lang.Object
Describes a map-matched location in the world at a given time.
-
-
Field Summary
Fields Modifier and Type Field Description java.lang.Double
bearingInDegrees
The bearing orientation points to the direction of travel, and has the same angle as the street where it is matched to.double
confidence
Confidence level (between 0 and 1) of the matched location.GeoCoordinates
coordinates
The geographic coordinates of the map-matched location.java.lang.Double
horizontalAccuracyInMeters
Horizontal accuracy measure of location.boolean
isDrivingInTheWrongWay
Determines if the travel direction on a one-way street is against the allowed traffic direction.long
segmentOffsetInCentimeters
Offset from start of segment in centimeters.SegmentReference
segmentReference
Reference to the current segment.
-
Constructor Summary
Constructors Constructor Description MapMatchedLocation(GeoCoordinates coordinates, java.lang.Double bearingInDegrees)
Creates a new instance.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description boolean
equals(java.lang.Object obj)
int
hashCode()
-
-
-
Field Detail
-
coordinates
@NonNull public GeoCoordinates coordinates
The geographic coordinates of the map-matched location.
-
bearingInDegrees
@Nullable public java.lang.Double 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
@NonNull public SegmentReference segmentReference
Reference to the current segment. The ratio of
segmentOffsetInCentimeters
to the segment length is betweenSegmentReference.offsetStart
andSegmentReference.offsetEnd
.
-
segmentOffsetInCentimeters
public long segmentOffsetInCentimeters
Offset from start of segment in centimeters.
-
confidence
public double confidence
Confidence 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 isDrivingInTheWrongWay
Determines 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
@Nullable public java.lang.Double 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.
-
-
Constructor Detail
-
MapMatchedLocation
public MapMatchedLocation(@NonNull GeoCoordinates coordinates, @Nullable java.lang.Double bearingInDegrees)
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).
-
-