Class GLRoute


public class GLRoute extends GLNativeObject
GLMapRouteData used store route data.
  • Method Details

    • getNumberOfTargetPoints

      public int getNumberOfTargetPoints()
      Returns number of target points
      Returns:
      number of target points
    • getTargetPoint

      public GLRoutePoint getTargetPoint(int index)
      Returns target point
      Parameters:
      index - index of target point
      Returns:
      target point
    • getTrackData

      public GLMapTrackData getTrackData(int trackColor)
      Returns track data that can be used to display track of route
      Parameters:
      trackColor - color of route track
      Returns:
      track data of route
    • getTrackCoordinates

      @Nullable public int[] getTrackCoordinates()
      Returns track coordinates in pairs (x, y) If track contains several lines - (-1, -1) split one segment from other
      Returns:
      track coordinates
    • getLanguage

      @NonNull public String getLanguage()
      Returns language of instructions
      Returns:
      language of instructions
    • getLength

      public double getLength()
      Returns total length of the track
      Returns:
      length of the track in meters
    • getDuration

      public double getDuration()
      Returns estimated duration of the track
      Returns:
      duration of the track in seconds
    • getNumberOfLegs

      public int getNumberOfLegs()
      Returns number of legs
      Returns:
      number of legs
    • getLengthOfLeg

      public double getLengthOfLeg(int index)
      Returns length of leg
      Parameters:
      index - index of leg
      Returns:
      length of leg
    • getDurationOfLeg

      public double getDurationOfLeg(int index)
      Returns duration of leg
      Parameters:
      index - index of leg
      Returns:
      duration of leg
    • getManeuvers

      @NonNull public GLRouteManeuver[] getManeuvers()
      Returns all maneuvers of route
      Returns:
      array of maneuvers
    • getNextManeuver

      @Nullable public GLRouteManeuver getNextManeuver(@NonNull GLRouteManeuver maneuver)
      Returns next maneuver that goes after the given maneuver
      Parameters:
      maneuver - maneuver
      Returns:
      next maneuver after the given maneuver
    • getPreviousManeuver

      @Nullable public GLRouteManeuver getPreviousManeuver(@NonNull GLRouteManeuver maneuver)
      Returns previous maneuver that goes before the given maneuver
      Parameters:
      maneuver - maneuver
      Returns:
      previous maneuver after the given maneuver
    • getFirstManeuver

      @Nullable public GLRouteManeuver getFirstManeuver()
      Returns last maneuver in route
      Returns:
      last maneuver in route
    • getLastManeuver

      @Nullable public GLRouteManeuver getLastManeuver()
      Returns last maneuver in route
      Returns:
      last maneuver in route
    • getHeightData

      @Nullable public GLRouteElevation getHeightData()
      Returns height data that was previously requested for this route
      Returns:
      height data
    • getAlternates

      @NonNull public GLRoute[] getAlternates()
      Alternative routes
      Returns:
      alternative routes
    • switchToAlternate

      public GLRoute switchToAlternate(int alternativeIndex)
      Switch to alternative route
      Parameters:
      alternativeIndex - index of alternative
      Returns:
      switched route
    • ParseFromJSON

      @Nullable public static GLRoute ParseFromJSON(@NonNull String json)
      Creates GLRoute from json String
      Parameters:
      json - json string that was returned by GLRoute#toJSON
      Returns:
      GLMapRouteData or null if data is invalid
    • toJSON

      public String toJSON()
      Serialize route to json
      Returns:
      json string
    • findInsertionIndex

      public static int findInsertionIndex(@NonNull MapPoint pt, @NonNull MapPoint[] points)
      Finds index where given point must be inserted to array of reference points. It's used, for example, to add way point to route.
      Parameters:
      pt - At input - point to insert. At output - point that is located on route.
      points - Array of reference points
      Returns:
      -1 if given point is too far from track.
    • getNextShortInstruction

      @Nullable public String getNextShortInstruction(@NonNull GLRouteManeuver maneuver)
      Parameters:
      maneuver - First maneuver to start search
      Returns:
      First non empty short instruction from given maneuver to the end of route
    • getApproachAlert

      @Nullable public String getApproachAlert(@NonNull String instruction, double distance)
      Adds 'In `distance` `units` ' before instruction
      Parameters:
      instruction - Instruction text
      distance - in meters
      Returns:
      Instruction with approach alert