RouteParameters QML Type

  • Esri.ArcGISRuntime
  • RouteParameters
  • A route parameters object contains parameters for route calculation. More...

    Import Statement: import Esri.ArcGISRuntime
    Since: Esri.ArcGISRuntime 100.0
    Inherits:

    Object

    Properties

    Signals

    Methods

    Detailed Description

    A class that contains settings that are used when solving a Route_task. The Route_parameters class contains all inputs for the Route_task, as well as settings such as the impedance attribute, accumulate and restriction attributes, backtrack (u-turn) policy, etc.

    Note: You cannot declare or create a component of this type in QML code. RouteParameters must be retrieved from the RouteTask so it will be assigned necessary defaults required to solve routes.

    See also RouteTask::createDefaultParameters.

    Property Documentation

    accumulateAttributeNames : list<string>

    A list of network attribute names to be accumulated with the analysis.


    directionsDistanceUnits : Enums.UnitSystem

    Directions distance text units.

    A directions distance text units. Describes the unit of measurement for the length of directions.


    directionsLanguage : string

    The language of the resulting route directions.


    directionsStyle : Enums.DirectionsStyle

    Directions style.

    A directions style. The directions setting to generate directions designed for different kind of applications.


    findBestSequence : bool

    Whether the analysis should reorder stops to find the optimized route.

    If the parameter value is false, the analysis returns a route that visits stops in the order you define. The order you define is the order that the stops are encountered in the array of stops in the RouteParameters. For example, the Stop at index zero is first, index 1 is second, and so on. If the parameter value is true, the analysis disregards the order you defined, and finds the best order to visit the stops. You can elect to preserve the first and/or the last stops while allowing the service to reorder intermediary stops by setting preserveFirstStop and preserveLastStop.

    The default is false.

    Note: A value of true causes the analysis to switch from solving a shortest-path problem to a traveling salesperson problem (TSP). Solving a TSP is computer-intensive operation and if using an online subscription-based service (e.g. ArcGIS Online) may incur additional service credits per route.


    outputSpatialReference : SpatialReference

    The output spatial reference.


    preserveFirstStop : bool

    Whether the analysis should preserve the first stop order.

    This parameter is applicable only if findBestSequence is true.


    preserveLastStop : bool

    Whether the analysis should preserve the last stop order.

    This parameter is applicable only if findBestSequence is true.


    returnDirections : bool

    Whether directions are returned with the RouteResult.


    returnPointBarriers : bool

    Whether point barriers are returned with the RouteResult.

    Reusing the PointBarriers from the RouteResult (as opposed to using the original PointBarriers) can increase the speed of any following route calculations.


    returnPolygonBarriers : bool

    Whether polygon barriers are returned with the RouteResult.

    Reusing the PolygonBarriers from the RouteResult (as opposed to using the original PolygonBarriers) can increase the speed of any subsequent route calculations. This is particularly true for complex polygons.


    returnPolylineBarriers : bool

    Whether polyline barriers are returned with the RouteResult.

    Reusing the PolylineBarriers from the RouteResult (as opposed to using the original PolylineBarriers) can increase the speed of any subsequent route calculations. This is particularly true for complex polylines.


    returnRoutes : bool

    Whether routes are returned with the RouteResult.


    returnStops : bool

    Whether stops are returned with the RouteResult.


    routeShapeType : Enums.RouteShapeType

    The output shape type for a route.

    See also Enums.RouteShapeType.


    startTime : date

    The start time of the route in UTC time.


    travelMode : TravelMode

    The travel mode for a route.


    Signal Documentation

    accumulateAttributeNamesChanged()

    Emitted when the accumulateAttributeNames property of this RouteParameters changes.

    Note: The corresponding handler is onAccumulateAttributeNamesChanged.


    directionsDistanceUnitsChanged()

    Emitted when the directionsDistanceUnits property of this RouteParameters changes.

    Note: The corresponding handler is onDirectionsDistanceUnitsChanged.


    directionsLanguageChanged()

    Emitted when the directionsLanguage property of this RouteParameters changes.

    Note: The corresponding handler is onDirectionsLanguageChanged.


    directionsStyleChanged()

    Emitted when the directionsStyle property of this RouteParameters changes.

    Note: The corresponding handler is onDirectionsStyleChanged.


    findBestSequenceChanged()

    Emitted when the findBestSequence property of this RouteParameters changes.

    Note: The corresponding handler is onFindBestSequenceChanged.


    outputSpatialReferenceChanged()

    Emitted when the outputSpatialReference property of this RouteParameters changes.

    Note: The corresponding handler is onOutputSpatialReferenceChanged.


    preserveFirstStopChanged()

    Emitted when the preserveFirstStop property of this RouteParameters changes.

    Note: The corresponding handler is onPreserveFirstStopChanged.


    preserveLastStopChanged()

    Emitted when the preserveLastStop property of this RouteParameters changes.

    Note: The corresponding handler is onPreserveLastStopChanged.


    returnDirectionsChanged()

    Emitted when the returnDirections property of this RouteParameters changes.

    Note: The corresponding handler is onReturnDirectionsChanged.


    returnPointBarriersChanged()

    Emitted when the returnPointBarriers property of this RouteParameters changes.

    Note: The corresponding handler is onReturnPointBarriersChanged.


    returnPolygonBarriersChanged()

    Emitted when the returnPolygonBarriers property of this RouteParameters changes.

    Note: The corresponding handler is onReturnPolygonBarriersChanged.


    returnPolylineBarriersChanged()

    Emitted when the returnPolylineBarriers property of this RouteParameters changes.

    Note: The corresponding handler is onReturnPolylineBarriersChanged.


    returnRoutesChanged()

    Emitted when the returnRoutes property of this RouteParameters changes.

    Note: The corresponding handler is onReturnRoutesChanged.


    returnStopsChanged()

    Emitted when the returnStops property of this RouteParameters changes.

    Note: The corresponding handler is onReturnStopsChanged.


    routeShapeTypeChanged()

    Emitted when the routeShapeType property of this RouteParameters changes.

    Note: The corresponding handler is onRouteShapeTypeChanged.


    startTimeChanged()

    Emitted when the startTime property of this RouteParameters changes.

    Note: The corresponding handler is onStartTimeChanged.


    travelModeChanged()

    Emitted when the travelMode property of this RouteParameters changes.

    Note: The corresponding handler is onTravelModeChanged.


    Method Documentation

    void clearPointBarriers()

    Clears the point barriers that have been set on this RouteParameters.


    void clearPolygonBarriers()

    Clears the polygon barriers that have been set on this RouteParameters.


    void clearPolylineBarriers()

    Clears the polyline barriers that have been set on this RouteParameters.


    void clearStops()

    Clears the stops that have been set on this RouteParameters.


    [since Esri.ArcGISRuntime 200.1] RouteParameters clone()

    Creates a deep copy of this object.

    This method was introduced in Esri.ArcGISRuntime 200.1.


    string searchWhereClause(string sourceName)

    Gets the search where clause from the specified network dataset's source feature class.

    • sourceName - The name of the network dataset's source feature class to retrieve the where clause from.

    See also setSearchWhereClause().


    void setPointBarriers(list<PointBarriers> pointBarriers)

    Sets the pointBarriers for a RouteTask by providing a list of PointBarrier.


    void setPointBarriersWithFeatureTable(ArcGISFeatureTable featureTable, QueryParameters queryParameters)

    Sets the point barriers from the features in specified feature table.

    The feature table can be either local or online. The feature table must be of geometry type point. Attributes from the feature table are mapped to the properties on the barrier objects generated from the specified feature table. The where clause set in the query parameters will be applied to the feature table. If an online feature table is specified the table will not be queried for features until Solve is called.

    • featureTable - The feature table.
    • queryParameters - The query parameters.

    See also FeatureTable.


    void setPolygonBarriers(list<PolygonBarriers> polygonBarriers)

    Sets the polygonBarriers for a RouteTask by providing a list of PolygonBarrier.


    void setPolygonBarriersWithFeatureTable(ArcGISFeatureTable featureTable, QueryParameters queryParameters)

    Sets the polygon barriers from the features in specified feature table.

    The feature table can be either local or online. The feature table must be of geometry type polygon. Attributes from the feature table are mapped to the properties on the barrier objects generated from the specified feature table. The where clause set in the query parameters will be applied to the feature table. If an online feature table is specified the table will not be queried for features until Solve is called.

    • featureTable - The feature table.
    • queryParameters - The query parameters.

    See also FeatureTable.


    void setPolylineBarriers(list<PolylineBarriers> polylineBarriers)

    Sets the polylineBarriers for a RouteTask by providing a list of PolygonBarrier.


    void setPolylineBarriersWithFeatureTable(ArcGISFeatureTable featureTable, QueryParameters queryParameters)

    Sets the polyline barriers from the features in specified feature table.

    The feature table can be either local or online. The feature table must be of geometry type polyline. Attributes from the feature table are mapped to the properties on the barrier objects generated from the specified feature table. The where clause set in the query parameters will be applied to the feature table. If an online feature table is specified the table will not be queried for features until Solve is called.

    • featureTable - The feature table.
    • queryParameters - The query parameters.

    See also FeatureTable.


    void setSearchWhereClause(string sourceName, string searchWhereClause)

    Sets a search where clause on the specified network dataset's source feature class.

    Only features satisfying the where clause for the specified feature class will be used to locate stops on the network during the solve operation. If a where clause is not set all network features are used.

    • sourceName - The name of the network dataset's source feature class the where clause will be applied to.
    • searchWhereClause - The search where clause.

    Note: Search WHERE clauses are not supported for online route tasks. They are only supported when solving local route tasks.

    See also searchWhereClause().


    void setStops(list<Stop> stops)

    Sets the stops for a RouteTask by providing a list of Stop.

    A minimum of 2 stops are required to complete a RouteTask.


    void setStopsWithFeatureTable(ArcGISFeatureTable featureTable, QueryParameters queryParameters)

    Sets the stops from the features in specified feature table.

    The feature table can be either local or online. The feature table must be of geometry type point. Attributes from the feature table are mapped to the properties on the stops objects generated from the specified feature table. The where clause set in the query parameters will be applied to the feature table. If an online feature table is specified the features will not be queried until Solve is called.

    A minimum of 2 stops are required to complete a RouteTask.

    • featureTable - The feature table.
    • queryParameters - The query parameters.

    See also FeatureTable.


    Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.