程序包 ai.nextbillion.kits.directions.models

类 RouteOptions

java.lang.Object
ai.nextbillion.kits.directions.models.DirectionsJsonObject
ai.nextbillion.kits.directions.models.RouteOptions
所有已实现的接口:
Serializable
public abstract class RouteOptions extends DirectionsJsonObject
Provides information connected to your request that help when a new directions request is needing using the identical parameters as the original request.

For example, if I request a driving (profile) with alternatives and continueStraight set to true. I make the request but loose reference and information which built the original request. Thus, If I only want to change a single variable such as the destination coordinate, i'd have to have all the other route information stores so the request was made identical to the previous but only now using this new destination point.

Using this class can provide you wth the information used when the DirectionsRoute was made.

另请参阅:

  • 嵌套类概要

    嵌套类
    修饰符和类型
    类
    说明
    static class 
    RouteOptions.Builder
    This builder can be used to set the values describing the RouteOptions.

  • 构造器概要

    构造器
    构造器
    说明
    RouteOptions()
     

  • 方法概要

    修饰符和类型
    方法
    说明
    abstract String
    accessToken()
    A valid Nbmap access token used to making the request.
    abstract Boolean
    alternatives()
    Whether to try to return alternative routes (true) or not (false, default).
    abstract String
    annotations()
    A comma-separated list of annotations.
    List<String>
    annotationsList()
    A list of annotations.
    abstract String
    approaches()
    Indicates from which side of the road to approach a waypoint.
    List<String>
    approachesList()
    Indicates from which side of the road to approach a waypoint.
    abstract Boolean
    bannerInstructions()
    Whether to return banner objects associated with the route steps (true) or not (false, default).
    abstract String
    baseUrl()
    The same base URL which was used during the request that resulted in this root directions response.
    abstract String
    bearings()
    Influences the direction in which a route starts from a waypoint.
    List<List<Double>>
    bearingsList()
    Influences the direction in which a route starts from a waypoint.
    static RouteOptions.Builder
    builder()
    Build a new instance of this RouteOptions class optionally settling values.
    abstract Boolean
    continueStraight()
    The allowed direction of travel when departing intermediate waypoints.
    abstract List<ai.nextbillion.kits.geojson.Point>
    coordinates()
    A list of Points to visit in order.
    abstract String
    exclude()
    Exclude certain road types from routing.
    static RouteOptions
    fromJson(String json)
    Create a new instance of this class by passing in a formatted valid JSON String.
    abstract String
    geometries()
    The format of the returned geometry.
    abstract String
    language()
    The language of returned turn-by-turn text instructions.
    abstract String
    overview()
    Displays the requested type of overview geometry.
    abstract String
    profile()
    The routing profile to use.
    abstract String
    radiuses()
    The maximum distance a coordinate can be moved to snap to the road network in meters.
    List<Double>
    radiusesList()
    The maximum distance a coordinate can be moved to snap to the road network in meters.
    abstract String
    requestUuid()
    A universally unique identifier (UUID) for identifying and executing a similar specific route in the future.
    abstract Boolean
    roundaboutExits()
    Whether to emit instructions at roundabout exits (true) or not (false, default).
    abstract String
    snappingClosures()
    A semicolon-separated list of booleans affecting snapping of waypoint locations to road segments.
    List<Boolean>
    snappingClosuresList()
    A list of booleans affecting snapping of waypoint locations to road segments.
    abstract Boolean
    steps()
    Whether to return steps and turn-by-turn instructions (true) or not (false, default).
    abstract RouteOptions.Builder
    toBuilder()
    Convert the current RouteOptions to its builder holding the currently assigned values.
    static com.google.gson.TypeAdapter<RouteOptions>
    typeAdapter(com.google.gson.Gson gson)
    Gson type adapter for parsing Gson to this class.
    abstract String
    user()
    The same user which was used during the request that resulted in this root directions response.
    abstract Boolean
    voiceInstructions()
    Whether to return SSML marked-up text for voice guidance along the route (true) or not (false, default).
    abstract String
    voiceUnits()
    A type of units to return in the text for voice instructions.
    abstract WalkingOptions
    walkingOptions()
    To be used to specify settings for use with the walking profile.
    abstract String
    waypointIndices()
    Indicates which input coordinates should be treated as waypoints.
    List<Integer>
    waypointIndicesList()
    Indicates which input coordinates should be treated as waypoints.
    abstract String
    waypointNames()
    A semicolon-separated list of custom names for entries in the list of coordinates(), used for the arrival instruction in banners and voice instructions.
    List<String>
    waypointNamesList()
    A semicolon-separated list of custom names for entries in the list of coordinates(), used for the arrival instruction in banners and voice instructions.
    abstract String
    waypointTargets()
    A semicolon-separated list of coordinate pairs used to specify drop-off locations that are distinct from the locations specified in coordinates.
    List<ai.nextbillion.kits.geojson.Point>
    waypointTargetsList()
    A list of points used to specify drop-off locations that are distinct from the locations specified in coordinates.

    从类继承的方法 ai.nextbillion.kits.directions.models.DirectionsJsonObject

    toJson

    从类继承的方法 java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • 构造器详细资料

    • RouteOptions

      public RouteOptions()

  • 方法详细资料

    • builder

      public static RouteOptions.Builder builder()
      Build a new instance of this RouteOptions class optionally settling values.
      返回:
      RouteOptions.Builder

    • baseUrl

      @NonNull public abstract String baseUrl()
      The same base URL which was used during the request that resulted in this root directions response.
      返回:
      string value representing the base URL

    • user

      @NonNull public abstract String user()
      The same user which was used during the request that resulted in this root directions response.
      返回:
      string value representing the user

    • profile

      @NonNull public abstract String profile()
      The routing profile to use. Possible values are DirectionsCriteria.PROFILE_DRIVING_TRAFFIC, DirectionsCriteria.PROFILE_DRIVING, DirectionsCriteria.PROFILE_WALKING, or DirectionsCriteria.PROFILE_CYCLING. The same profile which was used during the request that resulted in this root directions response. NbmapDirections.Builder ensures that a profile is always set even if the NbmapDirections requesting object doesn't specifically set a profile.
      返回:
      string value representing the profile defined in DirectionsCriteria.ProfileCriteria

    • coordinates

      @NonNull public abstract List<ai.nextbillion.kits.geojson.Point> coordinates()
      A list of Points to visit in order. There can be between two and 25 coordinates for most requests, or up to three coordinates for DirectionsCriteria.PROFILE_DRIVING_TRAFFIC requests. Note that these coordinates are different than the direction responses DirectionsWaypoints that these are the non-snapped coordinates.
      返回:
      a list of Points which represent the route origin, destination, and optionally, waypoints

    • alternatives

      @Nullable public abstract Boolean alternatives()
      Whether to try to return alternative routes (true) or not (false, default). An alternative route is a route that is significantly different than the fastest route, but also still reasonably fast. Such a route does not exist in all circumstances. Up to two alternatives may be returned. This is available for DirectionsCriteria.PROFILE_DRIVING_TRAFFIC, DirectionsCriteria.PROFILE_DRIVING, DirectionsCriteria.PROFILE_CYCLING.
      返回:
      boolean object representing the setting for alternatives

    • language

      @Nullable public abstract String language()
      The language of returned turn-by-turn text instructions. The default is en (English). Must be used in conjunction with RouteOptions.Builder.steps(Boolean).
      返回:
      the language as a string used during the request, if english, this will most likely be empty

    • radiuses

      @Nullable public abstract String radiuses()
      The maximum distance a coordinate can be moved to snap to the road network in meters. There must be as many radiuses as there are coordinates in the request, each separated by ;. Values can be any number greater than 0, the string unlimited or empty string.
      返回:
      a string representing the radiuses separated by ;.

    • radiusesList

      @Nullable public List<Double> radiusesList()
      The maximum distance a coordinate can be moved to snap to the road network in meters. There must be as many radiuses as there are coordinates in the request. Values can be any number greater than 0, the string unlimited, or null.
      返回:
      a list of radiuses

    • bearings

      @Nullable public abstract String bearings()
      Influences the direction in which a route starts from a waypoint. Used to filter the road segment the waypoint will be placed on by direction. This is useful for making sure the new routes of rerouted vehicles continue traveling in their current direction. A request that does this would provide bearing and radius values for the first waypoint and leave the remaining values empty. Returns two comma-separated values per waypoint: an angle clockwise from true north between 0 and 360, and the range of degrees by which the angle can deviate (recommended value is 45° or 90°), formatted as {angle, degrees}. If provided, the list of bearings must be the same length as the list of coordinates.
      返回:
      a string representing the bearings with the ; separator. Angle and degrees for every bearing value are comma-separated.

    • bearingsList

      @Nullable public List<List<Double>> bearingsList()
      Influences the direction in which a route starts from a waypoint. Used to filter the road segment the waypoint will be placed on by direction. This is useful for making sure the new routes of rerouted vehicles continue traveling in their current direction. A request that does this would provide bearing and radius values for the first waypoint and leave the remaining values empty. Returns a list of values, each value is a list of an angle clockwise from true north between 0 and 360, and the range of degrees by which the angle can deviate (recommended value is 45° or 90°). If provided, the list of bearings must be the same length as the list of coordinates.
      返回:
      a List of list of doubles representing the bearings used in the original request. The first value in the list is the angle, the second one is the degrees.

    • continueStraight

      @SerializedName("continue_straight") @Nullable public abstract Boolean continueStraight()
      The allowed direction of travel when departing intermediate waypoints. If true, the route will continue in the same direction of travel. If false, the route may continue in the opposite direction of travel. Defaults to true for DirectionsCriteria.PROFILE_DRIVING and false for DirectionsCriteria.PROFILE_WALKING and DirectionsCriteria.PROFILE_CYCLING.
      返回:
      a boolean value representing whether or not continueStraight was enabled or not during the initial request

    • roundaboutExits

      @SerializedName("roundabout_exits") @Nullable public abstract Boolean roundaboutExits()
      Whether to emit instructions at roundabout exits (true) or not (false, default). Without this parameter, roundabout maneuvers are given as a single instruction that includes both entering and exiting the roundabout. With roundabout_exits=true, this maneuver becomes two instructions, one for entering the roundabout and one for exiting it. Must be used in conjunction with steps()=true.
      返回:
      a boolean value representing whether or not roundaboutExits was enabled or disabled during the initial route request

    • geometries

      @Nullable public abstract String geometries()
      The format of the returned geometry. Allowed values are: DirectionsCriteria.GEOMETRY_POLYLINE (default, a polyline with a precision of five decimal places), DirectionsCriteria.GEOMETRY_POLYLINE6 (a polyline with a precision of six decimal places).
      返回:
      String geometry type from DirectionsCriteria.GeometriesCriteria.

    • overview

      @Nullable public abstract String overview()
      Displays the requested type of overview geometry. Can be DirectionsCriteria.OVERVIEW_FULL (the most detailed geometry available), DirectionsCriteria.OVERVIEW_SIMPLIFIED (default, a simplified version of the full geometry), or DirectionsCriteria.OVERVIEW_FALSE (no overview geometry).
      返回:
      null or one of the options found in DirectionsCriteria.OverviewCriteria

    • steps

      @Nullable public abstract Boolean steps()
      Whether to return steps and turn-by-turn instructions (true) or not (false, default). If steps is set to true, the following guidance-related parameters will be available: bannerInstructions(), language(), roundaboutExits(), voiceInstructions(), voiceUnits(), waypointNamesList(), waypointTargetsList(), waypoints from coordinates()
      返回:
      true if you'd like step information, false otherwise

    • annotations

      @Nullable public abstract String annotations()
      A comma-separated list of annotations. Defines whether to return additional metadata along the route. Possible values are: DirectionsCriteria.ANNOTATION_DURATION DirectionsCriteria.ANNOTATION_DISTANCE DirectionsCriteria.ANNOTATION_SPEED DirectionsCriteria.ANNOTATION_CONGESTION DirectionsCriteria.ANNOTATION_MAXSPEED See the RouteLeg object for more details on what is included with annotations. Must be used in conjunction with overview=full.
      返回:
      a string containing any of the annotations that were used during the request

    • annotationsList

      @Nullable public List<String> annotationsList()
      A list of annotations. Defines whether to return additional metadata along the route. Possible values are: DirectionsCriteria.ANNOTATION_DURATION DirectionsCriteria.ANNOTATION_DISTANCE DirectionsCriteria.ANNOTATION_SPEED DirectionsCriteria.ANNOTATION_CONGESTION DirectionsCriteria.ANNOTATION_MAXSPEED See the RouteLeg object for more details on what is included with annotations. Must be used in conjunction with overview=full.
      返回:
      a list of annotations that were used during the request

    • exclude

      @Nullable public abstract String exclude()
      Exclude certain road types from routing. The default is to not exclude anything from the profile selected. The following exclude flags are available for each profile: DirectionsCriteria.PROFILE_DRIVING: One of DirectionsCriteria.EXCLUDE_TOLL, DirectionsCriteria.EXCLUDE_MOTORWAY, or DirectionsCriteria.EXCLUDE_FERRY. DirectionsCriteria.PROFILE_DRIVING_TRAFFIC: One of DirectionsCriteria.EXCLUDE_TOLL, DirectionsCriteria.EXCLUDE_MOTORWAY, or DirectionsCriteria.EXCLUDE_FERRY. DirectionsCriteria.PROFILE_WALKING: No excludes supported DirectionsCriteria.PROFILE_CYCLING: DirectionsCriteria.EXCLUDE_FERRY
      返回:
      a string matching one of the DirectionsCriteria.ExcludeCriteria exclusions

    • voiceInstructions

      @SerializedName("voice_instructions") @Nullable public abstract Boolean voiceInstructions()
      Whether to return SSML marked-up text for voice guidance along the route (true) or not (false, default). Must be used in conjunction with steps()=true.
      返回:
      true if the original request included voice instructions

    • bannerInstructions

      @SerializedName("banner_instructions") @Nullable public abstract Boolean bannerInstructions()
      Whether to return banner objects associated with the route steps (true) or not (false, default). Must be used in conjunction with steps()=true
      返回:
      true if the original request included banner instructions

    • voiceUnits

      @SerializedName("voice_units") @Nullable public abstract String voiceUnits()
      A type of units to return in the text for voice instructions. Can be DirectionsCriteria.IMPERIAL (default) or DirectionsCriteria.METRIC. Must be used in conjunction with steps()=true and voiceInstructions() ()}=true.
      返回:
      a string matching either imperial or metric

    • accessToken

      @SerializedName("access_token") @NonNull public abstract String accessToken()
      A valid Nbmap access token used to making the request.
      返回:
      a string representing the Nbmap access token

    • requestUuid

      @SerializedName("uuid") @NonNull public abstract String requestUuid()
      A universally unique identifier (UUID) for identifying and executing a similar specific route in the future. NbmapDirections always waits for the response object which ensures this value will never be null.
      返回:
      a string containing the request UUID

    • approaches

      @Nullable public abstract String approaches()
      Indicates from which side of the road to approach a waypoint. Accepts DirectionsCriteria.APPROACH_UNRESTRICTED (default) or DirectionsCriteria.APPROACH_CURB . If set to DirectionsCriteria.APPROACH_UNRESTRICTED, the route can approach waypoints from either side of the road. If set to DirectionsCriteria.APPROACH_CURB, the route will be returned so that on arrival, the waypoint will be found on the side that corresponds with the driving_side of the region in which the returned route is located. If provided, the list of approaches must be the same length as the list of waypoints.
      返回:
      a string representing approaches for each waypoint

    • approachesList

      @Nullable public List<String> approachesList()
      Indicates from which side of the road to approach a waypoint. Accepts DirectionsCriteria.APPROACH_UNRESTRICTED (default) or DirectionsCriteria.APPROACH_CURB . If set to DirectionsCriteria.APPROACH_UNRESTRICTED, the route can approach waypoints from either side of the road. If set to DirectionsCriteria.APPROACH_CURB, the route will be returned so that on arrival, the waypoint will be found on the side that corresponds with the driving_side of the region in which the returned route is located. If provided, the list of approaches must be the same length as the list of waypoints.
      返回:
      a list of strings representing approaches for each waypoint

    • waypointIndices

      @SerializedName("waypoints") @Nullable public abstract String waypointIndices()
      Indicates which input coordinates should be treated as waypoints.

      Most useful in combination with steps=true and requests based on traces with high sample rates. Can be an index corresponding to any of the input coordinates, but must contain the first ( 0 ) and last coordinates' index separated by ; . steps()

      返回:
      a string representing indices to be used as waypoints

    • waypointIndicesList

      @Nullable public List<Integer> waypointIndicesList()
      Indicates which input coordinates should be treated as waypoints.

      Most useful in combination with steps=true and requests based on traces with high sample rates. Can be an index corresponding to any of the input coordinates, but must contain the first ( 0 ) and last coordinates' index. steps()

      返回:
      a List of Integers representing indices to be used as waypoints

    • waypointNames

      @SerializedName("waypoint_names") @Nullable public abstract String waypointNames()
      A semicolon-separated list of custom names for entries in the list of coordinates(), used for the arrival instruction in banners and voice instructions. Values can be any string, and the total number of all characters cannot exceed 500. If provided, the list of waypoint_names must be the same length as the list of coordinates. The first value in the list corresponds to the route origin, not the first destination. Must be used in conjunction with steps() = true.
      返回:
      a string representing names for each waypoint

    • waypointNamesList

      @Nullable public List<String> waypointNamesList()
      A semicolon-separated list of custom names for entries in the list of coordinates(), used for the arrival instruction in banners and voice instructions. Values can be any string, and the total number of all characters cannot exceed 500. If provided, the list of waypoint_names must be the same length as the list of coordinates. The first value in the list corresponds to the route origin, not the first destination. Must be used in conjunction with steps() = true.
      返回:
      a list of strings representing names for each waypoint

    • waypointTargets

      @SerializedName("waypoint_targets") @Nullable public abstract String waypointTargets()
      A semicolon-separated list of coordinate pairs used to specify drop-off locations that are distinct from the locations specified in coordinates. If this parameter is provided, the Directions API will compute the side of the street, left or right, for each target based on the waypoint_targets and the driving direction. The maneuver.modifier, banner and voice instructions will be updated with the computed side of street. The number of waypoint targets must be the same as the number of coordinates. Must be used with steps() = true.
      返回:
      a list of Points representing coordinate pairs for drop-off locations

    • waypointTargetsList

      @Nullable public List<ai.nextbillion.kits.geojson.Point> waypointTargetsList()
      A list of points used to specify drop-off locations that are distinct from the locations specified in coordinates. If this parameter is provided, the Directions API will compute the side of the street, left or right, for each target based on the waypoint_targets and the driving direction. The maneuver.modifier, banner and voice instructions will be updated with the computed side of street. The number of waypoint targets must be the same as the number of coordinates. Must be used with steps() = true.
      返回:
      a list of Points representing coordinate pairs for drop-off locations

    • walkingOptions

      @Nullable public abstract WalkingOptions walkingOptions()
      To be used to specify settings for use with the walking profile.
      返回:
      options to use for walking profile

    • snappingClosures

      @SerializedName("snapping_closures") @Nullable public abstract String snappingClosures()
      A semicolon-separated list of booleans affecting snapping of waypoint locations to road segments. If true, road segments closed due to live-traffic closures will be considered for snapping. If false, they will not be considered for snapping. If provided, the number of snappingClosures must be the same as the number of coordinates. Must be used with DirectionsCriteria.PROFILE_DRIVING_TRAFFIC
      返回:
      a String representing a list of booleans

    • snappingClosuresList

      @Nullable public List<Boolean> snappingClosuresList()
      A list of booleans affecting snapping of waypoint locations to road segments. If true, road segments closed due to live-traffic closures will be considered for snapping. If false, they will not be considered for snapping. If provided, the number of snappingClosures must be the same as the number of coordinates. Must be used with DirectionsCriteria.PROFILE_DRIVING_TRAFFIC
      返回:
      a list of booleans

    • typeAdapter

      public static com.google.gson.TypeAdapter<RouteOptions> typeAdapter(com.google.gson.Gson gson)
      Gson type adapter for parsing Gson to this class.
      参数:
      gson - the built Gson object
      返回:
      the type adapter for this class

    • fromJson

      @NonNull public static RouteOptions fromJson(String json)
      Create a new instance of this class by passing in a formatted valid JSON String.
      参数:
      json - a formatted valid JSON string defining a RouteOptions
      返回:
      a new instance of this class defined by the values passed inside this static factory method

    • toBuilder

      @NonNull public abstract RouteOptions.Builder toBuilder()
      Convert the current RouteOptions to its builder holding the currently assigned values. This allows you to modify a single property and then rebuild the object resulting in an updated and modified RouteOptions.
      返回:
      a RouteOptions.Builder with the same values set to match the ones defined in this RouteOptions