Class LengthLocationMap


  • public class LengthLocationMap
    extends java.lang.Object
    Computes the LinearLocation for a given length along a linear Geometry. Negative lengths are measured in reverse from end of the linear geometry. Out-of-range values are clamped.

    Note:
    This class is intended for internal use only, and it might be made package-private in a future version of this library

    • Constructor Detail

      • LengthLocationMap

        public LengthLocationMap​(Geometry linearGeom)
    • Method Detail

      • getLocation

        public static LinearLocation getLocation​(Geometry linearGeom,
                                                 double length)
        Computes the LinearLocation for a given length along a linear Geometry.
        Parameters:
        linearGeom - the linear geometry to use
        length - the length index of the location
        Returns:
        the LinearLocation for the length
      • getLocation

        public static LinearLocation getLocation​(Geometry linearGeom,
                                                 double length,
                                                 boolean resolveLower)
        Computes the LinearLocation for a given length along a linear Geometry, with control over how the location is resolved at component endpoints.
        Parameters:
        linearGeom - the linear geometry to use
        length - the length index of the location
        resolveLower - if true lengths are resolved to the lowest possible index
        Returns:
        the LinearLocation for the length
      • getLocation

        public LinearLocation getLocation​(double length)
        Compute the LinearLocation corresponding to a length. Negative lengths are measured in reverse from end of the linear geometry. Out-of-range values are clamped. Ambiguous indexes are resolved to the lowest possible location value.
        Parameters:
        length - the length index
        Returns:
        the corresponding LinearLocation
      • getLocation

        public LinearLocation getLocation​(double length,
                                          boolean resolveLower)
        Compute the LinearLocation corresponding to a length. Negative lengths are measured in reverse from end of the linear geometry. Out-of-range values are clamped. Ambiguous indexes are resolved to the lowest or highest possible location value, depending on the value of resolveLower
        Parameters:
        length - the length index
        Returns:
        the corresponding LinearLocation