• 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 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).

      • 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).

    • Method Detail

      • equals

        public boolean equals​(java.lang.Object obj)
        Overrides:
        equals in class java.lang.Object
      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class java.lang.Object