Display Name: EditVehicleRoutingProblem
Description: This ArcGIS Online service solves a vehicle routing problem (VRP) to find the best routes for a fleet of vehicles. It is similar to Solve Vehicle Routing Problem, but Edit Vehicle Routing Problem is designed to make a few, small edits to the results of a VRP and re-solve or solve a small VRP analysis of only two routes., A dispatcher managing a fleet of vehicles is often
required to make decisions about vehicle routing. One such decision
involves how to best assign a group of customers to a fleet of
vehicles and to sequence and schedule their visits. The objectives
in solving such VRPs are to provide a
high level of customer service by honoring any time windows while
keeping the overall operating and investment costs for each route
as low as possible. The constraints are to complete the routes with
available resources and within the time limits imposed by driver
work shifts, driving speeds, and customer commitments., This service can be used to determine solutions for such
complex fleet management tasks., Consider an example of delivering goods to grocery stores
from a central warehouse location. A fleet of three trucks is
available at the warehouse. The warehouse operates only within a
certain time window—from 8:00 a.m. to 5:00 p.m.—during which all
trucks must return to the warehouse. Each truck has a capacity
of 15,000 pounds, which limits the amount of goods it can carry.
Each store has a demand for a specific amount of goods (in pounds)
that needs to be delivered, and each store has time windows that
confine when deliveries should be made. Furthermore, the driver can
work only eight hours per day, requires a break for lunch, and is
paid for the time spent driving and servicing the stores. The
goal is to create an itinerary for each driver (or route),
such that the deliveries can be made while honoring all the service
requirements and minimizing the total time spent on a particular
route by the driver. The image below shows three routes obtained
by solving the above vehicle routing problem.
Category:
Help URL: https://gis.ccc.govt.nz/arcgis/rest/directories/arcgisoutput/Routing/NetworkAnalysisSync_GPServer/Routing_NetworkAnalysisSync/EditVehicleRoutingProblem.htm
Execution Type: esriExecutionTypeSynchronous
Parameters:
Parameter: orders
Data Type: GPFeatureRecordSetLayer
Display Name Orders
Description: Specify one or more locations that the routes of the VRP analysis should visit. An order can represent a delivery (for example, furniture delivery), a pickup (such as an airport shuttle bus picking up a passenger), or some type of service or inspection (a tree trimming job or building inspection, for instance).
When specifying the orders, you can set properties for each one, such as its name or service time, using attributes. The orders can be specified with the following attributes:
ObjectIDThe system-managed ID field.
NameThe name of the order. The name must be unique. If the
name is left null, a name is automatically generated at solve
time.DescriptionThe descriptive information about the order. This can contain any textual information for the order and has no restrictions for uniqueness. You may want to store a client's ID number in the Name field and the client's actual name or address in the Description field.
ServiceTimeThis property specifies the amount of time that will be spent at the
network location when the route visits it; that is, it stores the
impedance value for the network location. A zero or null value
indicates that the network location requires no service time. The unit for this field value is specified by the time_units parameter.
TimeWindowStart1The beginning time of the first time window for the
network location. This field can contain a null value; a null value
indicates no beginning time. A time window only states when a vehicle can arrive
at an order; it doesn't state when the service time must be
completed. To account for service time and departure before the time
window ends, subtract ServiceTime from the TimeWindowEnd1
field. The time window fields (TimeWindowStart1, TimeWindowEnd1, TimeWindowStart2, and TimeWindowEnd2) can contain a time-only value or a
date and time value. If a time field such as TimeWindowStart1 has a
time-only value (for example, 8:00 AM), the date is assumed to be
the default date set for the analysis. Using date and
time values (for example, 7/11/2010 8:00 AM) allows you to set time
windows that span multiple days. The time window fields can contain a time-only value or a
date and time value. If a time field such as TimeWindowStart1 has a
time-only value (for example, 8:00 AM), the date is assumed to be
the date specified by the Default Date parameter. Using date and
time values (for example, 7/11/2010 8:00 AM) allows you to set time
windows that span multiple days. When solving a problem that spans multiple time zones, each order's time-window values refer to the time zone in which the order is located.
TimeWindowEnd1 The ending time of the first window for the network
location. This field can contain a null value; a null value
indicates no ending time.
TimeWindowStart2 The beginning time of the second time window for the
network location. This field can contain a null value; a null value
indicates that there is no second time window. If the first time window is null as specified by
the TimeWindowStart1 and TimeWindowEnd1 fields, the second time
window must also be null. If both time windows are nonnull, they can't
overlap. Also, the second time window must occur after the
first.
TimeWindowEnd2 The ending time of the second time window for the
network location. This field can contain a null
value. When TimeWindowStart2 and TimeWindowEnd2 are both
null, there is no second time window. When TimeWindowStart2 is not null but TimeWindowEnd2
is null, there is a second time window that has a starting time but
no ending time. This is valid.
MaxViolationTime1 A time window is considered violated if the arrival
time occurs after the time window has ended. This field specifies
the maximum allowable violation time for the first time window of
the order. It can contain a zero value but can't contain negative
values. A zero value indicates that a time window violation at the
first time window of the order is unacceptable; that is, the first
time window is hard. Conversely, a null value indicates that
there is no limit on the allowable violation time. A nonzero value
specifies the maximum amount of lateness; for example, a route can
arrive at an order up to 30 minutes beyond the end of its first
time window. The unit for this field value is specified by the Time
Field Units parameter Time window violations can be tracked and weighted by the
solver. Because of this, you can direct the VRP solver to do one of the following: Minimize the overall violation time, regardless of the
increase in travel cost for the fleet. Find a solution that balances overall violation time and
travel cost. Ignore the overall violation time, and minimize
the travel cost for the fleet. By assigning an importance level for the Time Window
Violation Importance parameter, you are essentially choosing one of
these options. In any case, however, the solver will
return an error if the value set for MaxViolationTime1 is
surpassed.
MaxViolationTime2 The maximum allowable violation time for the second
time window of the order. This field is analogous to the
MaxViolationTime1 field.
InboundArriveTimeDefines when the item to be delivered to the order will be ready at the starting depot.The order can be assigned to a route only if the inbound arrive time precedes the route's latest start time value; this way, the route cannot leave the depot before the item is ready to be loaded onto it.This field can help model scenarios involving inbound-wave transshipments. For example, a job at an order requires special materials that are not currently available at the depot. The materials are being shipped from another location and will arrive at the depot at 11:00 a.m. To ensure a route that leaves before the shipment arrives isn't assigned to the order, the order's inbound arrive time is set to 11:00 a.m. The special materials arrive at 11:00 a.m., they are loaded onto the vehicle, and the vehicle departs from the depot to visit its assigned orders.Notes:The route's start time, which includes service times, must occur after the inbound arrive time. If a route begins before an order's inbound arrive time, the order cannot be assigned to the route. The assignment is invalid even if the route has a start-depot service time that lasts until after the inbound arrive time.This time field can contain a time-only value or a date and
time value. If a
time-only value is set (for example, 11:00 AM), the date is assumed to be
the default date set for the analysis. The default date is ignored, however, when any time field in the Depots, Routes, Orders, or Breaks includes a date with the time. In that case, specify all such fields with a date and time (for example, 7/11/2015 11:00 AM).The VRP solver honors InboundArriveTime regardless of the DeliveryQuantities value.If an outbound depart time is also specified, its time value must occur after the inbound arrive time.
OutboundDepartTimeDefines when the item to be picked up at the order must arrive at the ending depot.The order can be assigned to a route only if the route can visit the order and reach its end depot before the specified outbound depart time.This field can help model scenarios involving outbound-wave transshipments. For instance, a shipping company sends out delivery trucks to pick up packages from orders and bring them into a depot where they are forwarded on to other facilities, en route to their final destination. At 3:00 p.m. every day, a semitrailer stops at the depot to pick up the high-priority packages and take them directly to a central processing station. To avoid delaying the high-priority packages until the next day's 3:00 p.m. trip, the shipping company tries to have delivery trucks pick up the high-priority packages from orders and bring them to the depot before the 3:00 p.m. deadline. This is done by setting the outbound depart time to 3:00 p.m. Notes:The route's end time, including service times, must occur before the outbound depart time. If a route reaches a depot but doesn't complete its end-depot service time prior to the order's outbound depart time, the order cannot be assigned to the route. This time field can contain a time-only value or a date and
time value. If a
time-only value is set (for example, 11:00 AM), the date is assumed to be
the default date set for the analysis. . The default date is ignored, however, when any time field in Depots, Routes, Orders, or Breaks includes a date with the time. In that case, specify all such fields with a date and time (for example, 7/11/2015 11:00 AM).The VRP solver honors OutboundDepartTime regardless of the PickupQuantities value.If an inbound arrive time is also specified, its time value must occur before the outbound depart time.
DeliveryQuantities The size of the delivery. You can specify size in
any dimension, such as weight, volume, or quantity. You
can even specify multiple dimensions, for example, weight and
volume. Enter delivery quantities without indicating units.
For example, if a 300-pound object needs to be delivered to an
order, enter 300. You will need to remember that the value is in
pounds. If you are tracking multiple dimensions, separate
the numeric values with a space. For example, if you are recording
the weight and volume of a delivery that weighs 2,000 pounds and
has a volume of 100 cubic feet, enter 2000 100. Again, you need to
remember the units—in this case, pounds and cubic feet. You also
need to remember the sequence in which the values and their corresponding
units are entered. Make sure that Capacities for Routes and
DeliveryQuantities and PickupQuantities for Orders are specified in
the same manner; that is, the values must be in the same units.
If you are using multiple dimensions, the dimensions must be
listed in the same sequence for all parameters. For example, if you specify
weight in pounds, followed by volume in cubic feet for
DeliveryQuantities, the capacity of your routes and the pickup
quantities of your orders must be specified the same way: weight in
pounds, then volume in cubic feet. If you combine units or change the
sequence, you will get unwanted results with no
warning messages. An empty string or null value is equivalent to all
dimensions being zero. If the string has an insufficient number of
values in relation to the capacity count or dimensions being
tracked, the remaining values are treated as zeros. Delivery
quantities can't be negative.
PickupQuantities The size of the pickup. You can specify size in any
dimension, such as weight, volume, or quantity. You can
even specify multiple dimensions, for example, weight and volume.
You cannot, however, use negative values. This field is analogous
to the DeliveryQuantities field of Orders. In the case of an exchange visit, an order can have
both delivery and pickup quantities.
RevenueThe income generated if the order is included in a
solution. This field can contain a null value—a null value
indicates zero revenue—but it can't have a negative
value. Revenue is included in optimizing the objective
function value but is not part of the solution's operating cost;
that is, the TotalCost field in the routes never includes
revenue in its output. However, revenue weights the relative
importance of servicing orders. Revenue is included in optimizing the objective
function value but is not part of the solution's operating cost;
that is, the TotalCost field in the route class never includes
revenue in its output. However, revenue weights the relative
importance of servicing orders.
SpecialtyNames A space-separated string containing the names of the
specialties required by the order. A null value indicates that the
order doesn't require specialties. The spelling of any specialties listed in the Orders
and Routes classes must match exactly so that the VRP solver can
link them together. To illustrate what specialties are and how they
work, assume a lawn care and tree trimming company has a portion of
its orders that requires a bucket truck to trim tall trees. The
company would enter BucketTruck in the SpecialtyNames field for
these orders to indicate their special need. SpecialtyNames would
be left as null for the other orders. Similarly, the company would
also enter BucketTruck in the SpecialtyNames field of routes that
are driven by trucks with hydraulic booms. It would leave the field
null for the other routes. At solve time, the VRP solver assigns
orders without special needs to any route, but it only assigns
orders that need bucket trucks to routes that have
them.
AssignmentRule Specifies the rule for assigning the order to a route. The field value is specified as one of the following integers (use the numeric code, not the name in parentheses): 0 (Exclude)—The order will be excluded from the
subsequent solve operation.1 (Preserve route and relative sequence)—The solver must
always assign the order to the preassigned route at the
preassigned relative sequence during the solve operation. If this
assignment rule can't be followed, it results in an order
violation. With this setting, only the relative sequence is
maintained, not the absolute sequence. To illustrate what this
means, imagine there are two orders: A and B. They have sequence
values of 2 and 3, respectively. If you set their AssignmentRule
field values to Preserve route and relative sequence, the sequence values for A and B may change after solving because other
orders, breaks, and depot visits could be sequenced before,
between, or after A and B. However, B cannot be sequenced before
A. 2 (Preserve route)—The solver must always assign the
order to the preassigned route during the solve operation. A valid
sequence must also be set even though the sequence may or may not
be preserved. If the order can't be assigned to the specified
route, it results in an order violation. 3 (Override)—The solver tries to preserve the route
and sequence preassignment for the order during the solve
operation. However, a new route or sequence for the order may
be assigned if it helps minimize the overall value of the objective
function. This is the default value.4 (Anchor first)—The solver ignores the route and sequence preassignment (if any) for the order during the solve operation. It assigns a route to the order and makes it the first order on that route to minimize the overall value of the objective function.5 (Anchor last)—The solver ignores the route and sequence preassignment (if any) for the order during the solve operation. It assigns a route to the order and makes it the last order on that route to minimize the overall value of the objective function. This field can't contain a null
value.
CurbApproach Specifies the direction a vehicle may arrive at and depart
from the order. The field value is specified as one of the
following integers shown in the parentheses (use the numeric code, not the name in parentheses): 0 (Either side of vehicle)—The vehicle can approach and depart the order in either direction, so a U-turn is allowed at the incident. This setting can be chosen if it is possible and desirable for a vehicle to turn around at the order. This decision may depend on the width of the road and the amount of traffic or whether the order has a parking lot where vehicles can pull in and turn around. 1 (Right side of vehicle)—When the vehicle approaches and departs the order, the order must be on the right side of the vehicle. A U-turn is prohibited. This is typically used for vehicles such as buses that must arrive with the bus stop on the right-hand side. 2 (Left side of vehicle)—When the vehicle approaches and departs
the order, the curb must be on the left side of the vehicle. A
U-turn is prohibited. This is typically used for vehicles such as buses that must arrive with the bus stop on the left-hand side. 3 (No U-Turn)—When
the vehicle approaches the order, the curb can be on either side
of the vehicle; however, the vehicle must depart without turning
around. The CurbApproach property is designed to work with both kinds of national driving standards: right-hand traffic (United States) and left-hand traffic (United Kingdom). First, consider an order on the left side of a vehicle. It is always on the left side regardless of whether the vehicle travels on the left or right half of the road. What may change with national driving standards is your decision to approach an order from one of two directions, that is, so it ends up on the right or left side of the vehicle. For example, if you want to arrive at an order and not have a lane of traffic between the vehicle and the order, you would choose 1 (Right side of vehicle) in the United States but 2 (Left side of vehicle) in the United Kingdom.
RouteName The name of the route to which the order is
assigned. This field is used to preassign
an order to a specific route. It can contain a null value,
indicating that the order is not preassigned to any route, and the
solver identifies the best possible route assignment for the order.
If this is set to null, the Sequence field must also be set to
null. After a solve operation, if the order is routed, the
RouteName field contains the name of the route to which the order is
assigned.
SequenceThis indicates the sequence of the order on its
assigned route. This field is used to specify the
relative sequence for an order on the route. This field can contain
a null value specifying that the order can be placed anywhere along
the route. A null value can only occur together with a null
RouteName value. The input sequence values are positive and unique
for each route (shared across renewal depot visits, orders, and
breaks) but do not need to start from 1 or be
contiguous. After a solve operation, the Sequence field contains
the sequence value of the order on its assigned route. Output
sequence values for a route are shared across depot visits, orders,
and breaks; start from 1 (at the starting depot); and are
consecutive. So the smallest possible output sequence value for a
routed order is 2, since a route always begins at a
depotBearingThe direction in which a point is moving. The units are degrees and are measured clockwise from true north. This field is used in conjunction with the BearingTol field. Bearing data is usually sent automatically from a mobile device equipped with a GPS receiver. Try to include bearing data if you are loading an input location that is moving, such as a pedestrian or a vehicle. Using this field tends to prevent adding locations to the wrong edges, which can occur when a vehicle is near an intersection or an overpass for example. Bearing also helps the tool determine on which side of the street the point is. For more information, see Bearing and BearingTol in the ArcGIS help system. BearingTolThe bearing tolerance value creates a range of acceptable bearing values when locating moving points on an edge using the Bearing field. If the value from the Bearing field is within the range of acceptable values that are generated from the bearing tolerance on an edge, the point can be added as a network location there; otherwise, the closest point on the next-nearest edge is evaluated. The units are in degrees, and the default value is 30. Values must be greater than 0 and less than 180. A value of 30 means that when ArcGIS Network Analyst extension attempts to add a network location on an edge, a range of acceptable bearing values is generated 15 degrees to either side of the edge (left and right) and in both digitized directions of the edge. For more information, see Bearing and BearingTol in the ArcGIS help system. NavLatencyThis field is only used in the solve process if Bearing and BearingTol also have values; however, entering a NavLatency value is optional, even when values are present in Bearing and BearingTol. NavLatency indicates how much time is expected to elapse from the moment GPS information is sent from a moving vehicle to a server and the moment the processed route is received by the vehicle's navigation device. The time units of NavLatency are the same as the units specified by the timeUnits property of the analysis object.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Geometry Type: esriGeometryPoint
HasZ: false
HasM: false
Spatial Reference: 4326
(4326)
Fields:
-
OBJECTID
(
type: esriFieldTypeOID, alias: OBJECTID
)
-
Name
(
type: esriFieldTypeString, alias: Name, length: 500
)
-
ServiceTime
(
type: esriFieldTypeDouble, alias: ServiceTime
)
-
TimeWindowStart1
(
type: esriFieldTypeDate, alias: TimeWindowStart1, length: 8
)
-
TimeWindowEnd1
(
type: esriFieldTypeDate, alias: TimeWindowEnd1, length: 8
)
-
TimeWindowStart2
(
type: esriFieldTypeDate, alias: TimeWindowStart2, length: 8
)
-
TimeWindowEnd2
(
type: esriFieldTypeDate, alias: TimeWindowEnd2, length: 8
)
-
MaxViolationTime1
(
type: esriFieldTypeDouble, alias: MaxViolationTime1
)
-
MaxViolationTime2
(
type: esriFieldTypeDouble, alias: MaxViolationTime2
)
-
InboundArriveTime
(
type: esriFieldTypeDate, alias: InboundArriveTime, length: 8
)
-
OutboundDepartTime
(
type: esriFieldTypeDate, alias: OutboundDepartTime, length: 8
)
-
DeliveryQuantities
(
type: esriFieldTypeString, alias: DeliveryQuantities, length: 128
)
-
PickupQuantities
(
type: esriFieldTypeString, alias: PickupQuantities, length: 128
)
-
Revenue
(
type: esriFieldTypeDouble, alias: Revenue
)
-
SpecialtyNames
(
type: esriFieldTypeString, alias: SpecialtyNames, length: 500
)
-
AssignmentRule
(
type: esriFieldTypeInteger, alias: AssignmentRule
)
-
RouteName
(
type: esriFieldTypeString, alias: RouteName, length: 1024
)
-
Sequence
(
type: esriFieldTypeInteger, alias: Sequence
)
-
CurbApproach
(
type: esriFieldTypeInteger, alias: CurbApproach
)
Features: None.
Parameter Type: esriGPParameterTypeRequired
Category:
Parameter: depots
Data Type: GPFeatureRecordSetLayer
Display Name Depots
Description: Specify one or more depots for the given vehicle routing problem. A depot
is a location that a vehicle departs from at the beginning of its
workday and returns to at the end of the workday. Vehicles are
loaded (for deliveries) or unloaded (for pickups) at depots at the
start of the route. In some cases, a depot can also act as a
renewal location whereby the vehicle can unload or reload and
continue performing deliveries and pickups. A depot has open and
close times, as specified by a hard time window. Vehicles can't
arrive at a depot outside of this time window.When specifying the depots, you can set properties for each one, such as its name or service time, by using attributes. The depots can be specified with the following attributes:
ObjectID The system-managed ID field.
Name The name of the depot. The StartDepotName and EndDepotName
fields on routes reference the names you specify
here. It is also referenced by the route renewals, when
used. Depot names are not case sensitive but must be nonempty
and unique.DescriptionThe descriptive information about the depot location. This can contain any textual information and has no restrictions for uniqueness. For example, if you want to note which region a depot is in or the depot's address and telephone number, you can enter the information here rather than in the Name field. TimeWindowStart1 The beginning time of the first time window for the
network location. This field can contain a null value; a null value
indicates no beginning time. The time window fields (TimeWindowStart1, TimeWindowEnd1, TimeWindowStart2, and TimeWindowEnd2) can contain a time-only value or a
date and time value. If a time field such as TimeWindowStart1 has a
time-only value (for example, 8:00 AM), the date is assumed to be
the default date set for the analysis. Using date and
time values (for example, 7/11/2010 8:00 AM) allows you to set time
windows that span multiple days. When solving a problem that spans multiple time zones, each depot's time-window values refer to the time zone in which the depot is located.
TimeWindowEnd1 The ending time of the first window for the network
location. This field can contain a null value; a null value
indicates no ending time.
TimeWindowStart2 The beginning time of the second time window for the
network location. This field can contain a null value; a null value
indicates that there is no second time window. If the first time window is null, as specified by the
TimeWindowStart1 and TimeWindowEnd1 fields, the second time window
must also be null. If both time windows are not null, they can't overlap.
Also, the second time window must occur after the first.
TimeWindowEnd2 The ending time of the second time window for the network
location. This field can contain a null value. When TimeWindowStart2 and TimeWindowEnd2 are both null,
there is no second time window. When TimeWindowStart2 is not null but TimeWindowEnd2 is
null, there is a second time window that has a starting time but no
ending time. This is valid.
CurbApproach 0 (Either side of vehicle)—The vehicle can approach and depart the depot in either direction, so a U-turn is allowed at the incident. This setting can be chosen if it is possible and desirable for a vehicle to turn around at the depot. This decision may depend on the width of the road and the amount of traffic or whether the depot has a parking lot where vehicles can pull in and turn around. 1 (Right side of vehicle)—When the vehicle approaches and departs the depot, the depot must be on the right side of the vehicle. A U-turn is prohibited. This is typically used for vehicles such as buses that must arrive with the bus stop on the right-hand side. 2 (Left side of vehicle)—When the vehicle approaches and departs
the depot, the curb must be on the left side of the vehicle. A
U-turn is prohibited. This is typically used for vehicles such as buses that must arrive with the bus stop on the left-hand side. 3 (No U-Turn)—When
the vehicle approaches the depot, the curb can be on either side
of the vehicle; however, the vehicle must depart without turning
around. The CurbApproach property is designed to work with both kinds of national driving standards: right-hand traffic (United States) and left-hand traffic (United Kingdom). First, consider a depot on the left side of a vehicle. It is always on the left side regardless of whether the vehicle travels on the left or right half of the road. What may change with national driving standards is your decision to approach a depot from one of two directions, that is, so it ends up on the right or left side of the vehicle. For example, if you want to arrive at a depot and not have a lane of traffic between the vehicle and the depot, you would choose 1 (Right side of vehicle) in the United States but 2 (Left side of vehicle) in the United Kingdom.BearingThe direction in which a point is moving. The units are degrees and are measured clockwise from true north. This field is used in conjunction with the BearingTol field. Bearing data is usually sent automatically from a mobile device equipped with a GPS receiver. Try to include bearing data if you are loading an input location that is moving, such as a pedestrian or a vehicle. Using this field tends to prevent adding locations to the wrong edges, which can occur when a vehicle is near an intersection or an overpass for example. Bearing also helps the tool determine on which side of the street the point is. For more information, see Bearing and BearingTol in the ArcGIS help system. BearingTolThe bearing tolerance value creates a range of acceptable bearing values when locating moving points on an edge using the Bearing field. If the value from the Bearing field is within the range of acceptable values that are generated from the bearing tolerance on an edge, the point can be added as a network location there; otherwise, the closest point on the next-nearest edge is evaluated. The units are in degrees, and the default value is 30. Values must be greater than 0 and less than 180. A value of 30 means that when ArcGIS Network Analyst extension attempts to add a network location on an edge, a range of acceptable bearing values is generated 15 degrees to either side of the edge (left and right) and in both digitized directions of the edge. For more information, see Bearing and BearingTol in the ArcGIS help system. NavLatencyThis field is only used in the solve process if Bearing and BearingTol also have values; however, entering a NavLatency value is optional, even when values are present in Bearing and BearingTol. NavLatency indicates how much time is expected to elapse from the moment GPS information is sent from a moving vehicle to a server and the moment the processed route is received by the vehicle's navigation device. The time units of NavLatency are the same as the units specified by the timeUnits property of the analysis object.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Geometry Type: esriGeometryPoint
HasZ: false
HasM: false
Spatial Reference: 4326
(4326)
Fields:
-
OBJECTID
(
type: esriFieldTypeOID, alias: ObjectID
)
-
Name
(
type: esriFieldTypeString, alias: Name, length: 500
)
-
TimeWindowStart1
(
type: esriFieldTypeDate, alias: TimeWindowStart1, length: 8
)
-
TimeWindowEnd1
(
type: esriFieldTypeDate, alias: TimeWindowEnd1, length: 8
)
-
TimeWindowStart2
(
type: esriFieldTypeDate, alias: TimeWindowStart2, length: 8
)
-
TimeWindowEnd2
(
type: esriFieldTypeDate, alias: TimeWindowEnd2, length: 8
)
-
CurbApproach
(
type: esriFieldTypeInteger, alias: CurbApproach
)
-
Bearing
(
type: esriFieldTypeDouble, alias: Bearing
)
-
BearingTol
(
type: esriFieldTypeDouble, alias: BearingTol
)
-
NavLatency
(
type: esriFieldTypeDouble, alias: NavLatency
)
Features: None.
Parameter Type: esriGPParameterTypeRequired
Category:
Parameter: routes
Data Type: GPRecordSet
Display Name Routes
Description: Specify one or more routes that specify vehicle and driver characteristics. A route can have start and end depot service times, a fixed or flexible starting time, time-based operating costs, distance-based operating costs, multiple capacities, various constraints on a driver's workday, and so on. The routes can be specified with the following attributes:
Name The name of the route. The name must be
unique. The tool generates a unique name at solve time if
the field value is null; therefore, entering a value is optional in
most cases. However, you must enter a name if your analysis
includes breaks, route renewals, route zones, or orders that are
preassigned to a route because the route name is used as a foreign
key in these cases. Note that route names are case
insensitive.
StartDepotName The name of the starting depot for the route. This field
is a foreign key to the Name field in Depots. If the StartDepotName value is null, the route will begin
from the first order assigned. Omitting the start depot is useful
when the vehicle's starting location is unknown or irrelevant to
your problem. However, when StartDepotName is null, EndDepotName
cannot also be null.Virtual start depots are not allowed if orders or depots are in
multiple time zones. If the route is making deliveries and StartDepotName is
null, it is assumed the cargo is loaded on the vehicle at a virtual
depot before the route begins. For a route that has no renewal
visits, its delivery orders (those with nonzero DeliveryQuantities
values in Orders) are loaded at the start depot or
virtual depot. For a route that has renewal visits, only the
delivery orders before the first renewal visit are loaded at the
start depot or virtual depot. EndDepotName The name of the ending depot for the route. This field is
a foreign key to the Name field in Depots. StartDepotServiceTime The service time at the starting depot. This can be used
to model the time spent loading the vehicle. This field can
contain a null value; a null value indicates zero service
time. The unit for this field value is specified by the Time
Field Units parameter. The service times at the start and end depots are fixed
values (given by the StartDepotServiceTime and EndDepotServiceTime
field values) and do not take into account the actual load for a
route. For example, the time taken to load a vehicle at the
starting depot may depend on the size of the orders. As such, the
depot service times could be given values corresponding to a full
truckload or an average truckload, or you could make your own time
estimate.
EndDepotServiceTime The service time at the ending depot. This can be used to
model the time spent unloading the vehicle. This field can
contain a null value; a null value indicates zero service
time. The unit for this field value is specified by the Time
Field Units parameter. The service times at the start and end depots are fixed
values (given by the StartDepotServiceTime and EndDepotServiceTime
field values) and do not take into account the actual load for a
route. For example, the time taken to load a vehicle at the
starting depot may depend on the size of the orders. As such, the
depot service times could be given values corresponding to a full
truckload or an average truckload, or you could make your own time
estimate.
EarliestStartTime The earliest allowable starting time for the route. This
is used by the solver in conjunction with the time window of the
starting depot for determining feasible route start
times. This field can't contain null values and has a default
time-only value of 8:00 AM.; the default value is interpreted as
8:00 a.m. on the default date set for the analysis. When solving a problem that spans multiple time zones, the
time zone for EarliestStartTime is the same as the time zone in which the starting depot is located.
LatestStartTime The latest allowable starting time for the route. This field can't contain null values and has a default
time-only value of 10:00 AM. The default value is interpreted as
10:00 a.m. on the default date set for the analysis. When solving a problem that spans multiple time zones, the
time zone for LatestStartTime is the same as the time zone in which the starting depot is located.
ArriveDepartDelay This field stores the amount of travel time needed to
accelerate the vehicle to normal travel speeds, decelerate it to a
stop, and move it off and on the network (for example, in and out
of parking). By including an ArriveDepartDelay value, the VRP
solver is deterred from sending many routes to service physically
coincident orders. The cost for this property is incurred between visits to
noncoincident orders, depots, and route renewals. For example, when
a route starts from a depot and visits the first order, the total
arrive/depart delay is added to the travel time. The same is true
when traveling from the first order to the second order. If the
second and third orders are coincident, the ArriveDepartDelay value
is not added between them since the vehicle doesn't need to move.
If the route travels to a route renewal, the value is added to the
travel time again. Although a vehicle needs to slow down and stop for a break
and accelerate afterward, the VRP solver cannot add the
ArriveDepartDelay value for breaks. This means that if a route
leaves an order, stops for a break, and continues to the next
order, the arrive/depart delay is added only once, not
twice. For example, assume there are five coincident orders in
a high-rise building, and they are serviced by three different
routes. This means three arrive/depart delays would be incurred;
that is, three drivers would need to separately find parking places
and enter the same building. However, if the orders could be
serviced by one route instead, only one driver would need to
park and enter the building, and only one arrive/depart delay would be
incurred. Since the VRP solver tries to minimize cost, it will try
to limit the arrive/depart delays and thus identify the single-route
option. (Note that multiple routes may need to be sent when other
constraints—such as specialties, time windows, or
capacities—require it.) The unit for this field value is specified by the time_units parameter.
CapacitiesThe maximum capacity of the vehicle. You can specify
capacity in any dimension, such as weight, volume, or
quantity. You can even specify multiple dimensions, for example,
weight and volume. Enter capacities without indicating units. For example,
if your vehicle can carry a maximum of 40,000 pounds; you would
enter 40000. You need to remember that the
value is in pounds. If you are tracking multiple dimensions, separate
the numeric values with a space. For example, if you are recording
the weight and volume of a delivery that weighs 2,000 pounds and
has a volume of 100 cubic feet, enter 2000 100. Again, you need to
remember the units—in this case, pounds and cubic feet. You also
need to remember the sequence in which the values and their corresponding
units are entered. Remembering the units and the unit sequence is important
for a couple of reasons: first, so you can reinterpret the
information later; second, so you can properly enter values for the
DeliveryQuantities and PickupQuantities fields for the orders. Note that the VRP solver
simultaneously refers to Capacities, DeliveryQuantities, and
PickupQuantities to verify that a route doesn't become
overloaded. Since units can't be entered in the field, the VRP tool can't make unit conversions, so you need to enter the
values for the three fields using the same units and the same unit
sequence to ensure that the values are correctly interpreted. If you combine
units or change the sequence in any of the three fields, you will
get unwanted results with no warning messages. It is recommended that you set up a unit and unit-sequence standard
beforehand and continually refer to it when you enter values for
these three fields. An empty string or null value is equivalent to all values
being zero. Capacity values can't be negative. If the Capacities string has an insufficient number of
values in relation to the DeliveryQuantities or PickupQuantities
fields for orders, the remaining values are treated as
zero. The VRP solver only performs a simple Boolean test to
determine whether capacities are exceeded. If a route's capacity
value is greater than or equal to the total quantity being carried,
the VRP solver will assume the cargo fits in the vehicle. This
could be incorrect, depending on the actual shape of the cargo and
the vehicle. For example, the VRP solver allows you to fit a
1,000-cubic-foot sphere into a 1,000-cubic-foot truck that is 8
feet wide. In reality, however, since the sphere is 12.6 feet in
diameter, it won't fit in the 8-foot wide truck.
FixedCost A fixed monetary cost that is incurred only if the route
is used in a solution (that is, it has orders assigned to it). This
field can contain null values; a null value indicates zero fixed
cost. This cost is part of the total route operating
cost.
CostPerUnitTime The monetary cost incurred—per unit of work time—for the
total route duration, including travel times as well as service
times and wait times at orders, depots, and breaks. This field
can't contain a null value and has a default value of
1.0. The unit for this field value is specified by the time_units parameter.
CostPerUnitDistance The monetary cost incurred—per unit of distance
traveled—for the route length (total travel distance). This field
can contain null values; a null value indicates zero
cost. The unit for this field value is specified by the distance_units parameter.
OvertimeStartTime The duration of regular work time before overtime
computation begins. This field can contain null values; a null
value indicates that overtime does not apply. The unit for this field value is specified by the time_units parameter. For example, if the driver is to be paid overtime pay when
the total route duration extends beyond eight hours,
OvertimeStartTime is specified as 480 (8 hours * 60 minutes/hour),
given the time units are Minutes. CostPerUnitOvertime The monetary cost incurred per time unit of overtime work.
This field can contain null values; a null value indicates that the
CostPerUnitOvertime value is the same as the CostPerUnitTime
value.
MaxOrderCountThe maximum allowable number of orders on the route. This
field can't contain null values and has a default value of
30. MaxTotalTimeThe maximum allowable route duration. The route duration
includes travel times as well as service and wait times at orders,
depots, and breaks. This field can contain null values; a null
value indicates that there is no constraint on the route
duration. The unit for this field value is specified by the time_units parameter.
MaxTotalTravelTime The maximum allowable travel time for the route. The
travel time includes only the time spent driving on the network and
does not include service or wait times. This field can contain null values; a null value indicates
there is no constraint on the maximum allowable travel time. This
field value can't be larger than the MaxTotalTime field
value. The unit for this field value is specified by the time_units parameter.
MaxTotalDistance The maximum allowable travel distance for the
route. The unit for this field value is specified by the distance_units parameter. This field can contain null values; a null value indicates
that there is no constraint on the maximum allowable travel
distance.
SpecialtyNames A space-separated string containing the names of the
specialties required by the order. A null value indicates that the
order doesn't require specialties. The spelling of any specialties listed in the Orders
and Routes classes must match exactly so that the VRP solver can
link them together. To illustrate what specialties are and how they
work, assume a lawn care and tree trimming company has a portion of
its orders that requires a bucket truck to trim tall trees. The
company would enter BucketTruck in the SpecialtyNames field for
these orders to indicate their special need. SpecialtyNames would
be left as null for the other orders. Similarly, the company would
also enter BucketTruck in the SpecialtyNames field of routes that
are driven by trucks with hydraulic booms. It would leave the field
null for the other routes. At solve time, the VRP solver assigns
orders without special needs to any route, but it only assigns
orders that need bucket trucks to routes that have
them.
AssignmentRule This specifies whether the route can be used when
solving the problem. This field is constrained by a domain of
values that are listed below (use the numeric code, not the name in parentheses). 1 (Include)—The route is included in the solve operation.
This is the default value. 2 (Exclude)—The route is excluded from the solve
operation. This field can't contain a null
value.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Fields:
-
OBJECTID
(
type: esriFieldTypeOID, alias: ObjectID
)
-
Name
(
type: esriFieldTypeString, alias: Name, length: 1024
)
-
StartDepotName
(
type: esriFieldTypeString, alias: StartDepotName, length: 500
)
-
EndDepotName
(
type: esriFieldTypeString, alias: EndDepotName, length: 500
)
-
StartDepotServiceTime
(
type: esriFieldTypeDouble, alias: StartDepotServiceTime
)
-
EndDepotServiceTime
(
type: esriFieldTypeDouble, alias: EndDepotServiceTime
)
-
EarliestStartTime
(
type: esriFieldTypeDate, alias: EarliestStartTime, length: 8
)
-
LatestStartTime
(
type: esriFieldTypeDate, alias: LatestStartTime, length: 8
)
-
ArriveDepartDelay
(
type: esriFieldTypeDouble, alias: ArriveDepartDelay
)
-
Capacities
(
type: esriFieldTypeString, alias: Capacities, length: 128
)
-
FixedCost
(
type: esriFieldTypeDouble, alias: FixedCost
)
-
CostPerUnitTime
(
type: esriFieldTypeDouble, alias: CostPerUnitTime
)
-
CostPerUnitDistance
(
type: esriFieldTypeDouble, alias: CostPerUnitDistance
)
-
OvertimeStartTime
(
type: esriFieldTypeDouble, alias: OvertimeStartTime
)
-
CostPerUnitOvertime
(
type: esriFieldTypeDouble, alias: CostPerUnitOvertime
)
-
MaxOrderCount
(
type: esriFieldTypeInteger, alias: MaxOrderCount
)
-
MaxTotalTime
(
type: esriFieldTypeDouble, alias: MaxTotalTime
)
-
MaxTotalTravelTime
(
type: esriFieldTypeDouble, alias: MaxTotalTravelTime
)
-
MaxTotalDistance
(
type: esriFieldTypeDouble, alias: MaxTotalDistance
)
-
SpecialtyNames
(
type: esriFieldTypeString, alias: SpecialtyNames, length: 1024
)
-
AssignmentRule
(
type: esriFieldTypeInteger, alias: AssignmentRule
)
Features: None.
Parameter Type: esriGPParameterTypeRequired
Category:
Parameter: breaks
Data Type: GPRecordSet
Display Name Breaks
Description: These are the rest periods, or breaks, for the routes in a given vehicle routing problem. A break is associated with exactly one route, and can be taken after completing an order, while en route to an order, or prior to servicing an order. It has a start time and a duration for which the driver may or may not be paid. There are three options for establishing when a break begins: using a time window, a maximum travel time, or a maximum work time. When specifying the breaks, you can set properties for each one, such as its name or service time, by using attributes. The orders can be specified with the following attributes:
ObjectID The system-managed ID field.
RouteName The name of the route to which the break applies. Although
a break is assigned to exactly one route, many breaks can be
assigned to the same route. This field is a foreign key to the Name field in the
Routes, so it can't have a null value. Precedence Precedence values sequence the breaks of a given route.
Breaks with a precedence value of 1 occur before those with a value
of 2, and so on. All breaks must have a precedence value, regardless of
whether they are time-window, maximum-travel-time, or
maximum-work-time breaks.
ServiceTime The duration of the break. This field can't contain null
values. The default value is 60. The unit for this field value is specified by the time_units parameter.
TimeWindowStart If this field is null and TimeWindowEnd has a valid
time-of-day value, the break is allowed to start any time before the
TimeWindowEnd value. If this field has a value, the MaxTravelTimeBetweenBreaks and
MaxCumulWorkTime field values must be null; moreover, all other breaks in the
analysis must have null values for MaxTravelTimeBetweenBreaks
and MaxCumulWorkTime. An error will occur at solve time if a route has multiple
breaks with overlapping time windows. The time window fields in breaks can contain a time-only
value or a date and time value. If a time field, such as
TimeWindowStart, has a time-only value (for example, 12:00 PM), the
date is assumed to be the date specified by the default_date
parameter. Using date and time values (for example, 7/11/2012 12:00
PM) allows you to specify time windows that span two or more days.
This is beneficial when a break should be taken sometime
before and after midnight. When solving a problem that spans multiple time zones, each break's time-window values refer to the time zone in which the associated route, specified by the RouteName field, is located.
TimeWindowEnd The ending time of the break's time window. If this field is null and TimeWindowStart has a valid
time-of-day value, the break is allowed to start any time after the
TimeWindowStart value. If this field has a value, MaxTravelTimeBetweenBreaks and
MaxCumulWorkTime must be null, and all other breaks in the
analysis must have null values for MaxTravelTimeBetweenBreaks
and MaxCumulWorkTime. MaxViolationTime This field specifies the maximum allowable violation time
for a time-window break. A time window is considered violated if
the arrival time falls outside the time range. A zero value indicates that the time window cannot be violated;
that is, the time window is hard. A nonzero value specifies the
maximum amount of lateness. For example, the break can begin up to
30 minutes beyond the end of its time window, but the lateness is
penalized pursuant to the Time Window Violation Importance
parameter. This property can be null. A null value with
TimeWindowStart and TimeWindowEnd values indicates that there is no
limit on the allowable violation time. If
MaxTravelTimeBetweenBreaks or MaxCumulWorkTime has a value,
MaxViolationTime must be null. The unit for this field value is specified by the time_units parameter.
MaxTravelTimeBetweenBreaks The maximum amount of travel time that can be accumulated
before the break is taken. The travel time is accumulated either
from the end of the previous break or, if a break has not yet been
taken, from the start of the route. If this is the route's final break,
MaxTravelTimeBetweenBreaks also indicates the maximum travel time
that can be accumulated from the final break to the end
depot. This field is designed to limit how long a person can
drive until a break is required. For instance, if the time unit for the analysis is set to
Minutes, and MaxTravelTimeBetweenBreaks has a value of 120, the
driver will get a break after two hours of driving. To assign a
second break after two more hours of driving, the second break's
MaxTravelTimeBetweenBreaks property must be 120. If this field has a value, TimeWindowStart, TimeWindowEnd,
MaxViolationTime, and MaxCumulWorkTime must be null for an analysis
to solve successfully. The unit for this field value is specified by the time_units parameter.
MaxCumulWorkTime The maximum amount of work time that can be accumulated
before the break is taken. Work time is always accumulated from the
beginning of the route. Work time is the sum of travel time and service times at
orders, depots, and breaks. Note, however, that this excludes wait
time, which is the time a route (or driver) spends waiting at an
order or depot for a time window to begin. This field is designed to limit how long a person can work
until a break is required. For example, if the time unit for the analysis is set to
Minutes,
MaxCumulWorkTime has a value of 120, and ServiceTime has a value of
15, the driver will get a 15-minute break after two hours of
work. Continuing with the last example, assume a second break is
needed after three more hours of work. To specify this break, you
would enter 315 (five hours and 15 minutes) as the second break's
MaxCumulWorkTime value. This number includes the MaxCumulWorkTime
and ServiceTime values of the preceding break, along with the three
additional hours of work time before granting the second break. To
avoid taking maximum-work-time breaks prematurely, remember that
they accumulate work time from the beginning of the route and that
work time includes the service time at previously visited depots,
orders, and breaks. If this field has a value, TimeWindowStart, TimeWindowEnd,
MaxViolationTime, and MaxTravelTimeBetweenBreaks must be null for
an analysis to solve successfully. The unit for this field value is specified by the time_units parameter.
IsPaidA Boolean value indicating whether the break is paid or
unpaid. Setting this field value to 1 indicates that the time spent at the break is
included in the route cost computation and overtime determination.
A value of 0 indicates otherwise. The default value is
1. Sequence Indicates the sequence of the
break on its route. This field can contain null values which causes the solver to pick the break sequence. If sequence values are specified, they should be positive and unique for each route (shared
across renewal depot visits, orders, and breaks) but need not start
from 1 or be contiguous.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Fields:
-
OBJECTID
(
type: esriFieldTypeOID, alias: ObjectID
)
-
RouteName
(
type: esriFieldTypeString, alias: RouteName, length: 1024
)
-
Precedence
(
type: esriFieldTypeInteger, alias: Precedence
)
-
ServiceTime
(
type: esriFieldTypeDouble, alias: ServiceTime
)
-
TimeWindowStart
(
type: esriFieldTypeDate, alias: TimeWindowStart, length: 8
)
-
TimeWindowEnd
(
type: esriFieldTypeDate, alias: TimeWindowEnd, length: 8
)
-
MaxViolationTime
(
type: esriFieldTypeDouble, alias: MaxViolationTime
)
-
MaxTravelTimeBetweenBreaks
(
type: esriFieldTypeDouble, alias: MaxTravelTimeBetweenBreaks
)
-
MaxCumulWorkTime
(
type: esriFieldTypeDouble, alias: MaxCumulWorkTime
)
-
IsPaid
(
type: esriFieldTypeInteger, alias: IsPaid
)
-
Sequence
(
type: esriFieldTypeInteger, alias: Sequence
)
Features: None.
Parameter Type: esriGPParameterTypeOptional
Category:
Parameter: time_units
Data Type: GPString
Display Name Time Units
Description: The time units for all time-based field values in the
analysis. Many features and records in a VRP analysis have fields
for storing time values, such as ServiceTime for orders and
CostPerUnitTime for routes. To minimize data entry requirements,
these field values don't include units. Instead, all distance-based
field values must be entered in the same units, and this parameter
is used to specify the units of those values. Note that output time-based fields use the same units
specified by this parameter.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: Minutes
Parameter Type: esriGPParameterTypeOptional
Category:
Choice List: [ Seconds, Minutes, Hours, Days ]
Parameter: distance_units
Data Type: GPString
Display Name Distance Units
Description: The distance units for all distance-based field values in
the analysis. Many features and records in a VRP analysis have
fields for storing distance values, such as MaxTotalDistance and
CostPerUnitDistance for Routes. To minimize data entry
requirements, these field values don't include units. Instead, all
distance-based field values must be entered in the same units, and
this parameter is used to specify the units of those
values. Note that output distance-based fields use the same units
specified by this parameter.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: Miles
Parameter Type: esriGPParameterTypeOptional
Category:
Choice List: [ Meters, Kilometers, Feet, Yards, Miles, NauticalMiles ]
Parameter: analysis_region
Data Type: GPString
Display Name Analysis Region
Description: The region in which to perform the analysis. If a value is not specified for this parameter, the tool
will automatically calculate the region name based on the location
of the input points. Setting the name of the region is required only if the automatic detection of the region name is not accurate for your inputs.To specify a region, use one of
the following values: Europe JapanKorea MiddleEastAndAfrica NorthAmerica SouthAmerica SouthAsiaThailand The following region names are no longer supported and will be removed in future releases. If you specify one of the deprecated region names, the tool automatically assigns a supported region name for your region.Greece redirects to EuropeIndia redirects to SouthAsiaOceania redirects to SouthAsiaSouthEastAsia redirects to SouthAsiaTaiwan redirects to SouthAsia
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeOptional
Category: Advanced Analysis
Choice List: [ ESRIPortalEnterprise.DBO.GreaterChristchurchTransitNetwork_ND ]
Parameter: default_date
Data Type: GPDate
Display Name Default Date
Description: The default date for time field values that specify a time
of day without including a date. You can find these time fields in various input parameters, such as the ServiceTime attributes in the orders and breaks parameters.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeOptional
Category: Advanced Analysis
Parameter: uturn_policy
Data Type: GPString
Display Name UTurn at Junctions
Description: Use this parameter to restrict or permit the service area to make U-turns at junctions. To understand the parameter values, consider for a moment the following terminology: a junction is a point where a street segment ends and potentially connects to one or more other segments; a pseudo-junction is a point where exactly two streets connect to one another; an intersection is a point where three or more streets connect; and a dead-end is where one street segment ends without connecting to another. Given this information, the parameter can have the following values: ALLOW_UTURNS—U-turns are permitted everywhere. Allowing
U-turns implies that the vehicle can turn around at any junction and
double back on the same street. This is the default value.NO_UTURNS—U-turns are prohibited at all junctions: pseudo-junctions, intersections, and dead-ends.
Note, however, that U-turns may be permitted even when this option is chosen. To prevent U-turns at incidents and facilities, set
the CurbApproach field value to
prohibit U-turns.ALLOW_DEAD_ENDS_ONLY—U-turns are prohibited at all
junctions, except those that have only one connected street feature (a dead
end).ALLOW_DEAD_ENDS_AND_INTERSECTIONS_ONLY—U-turns are prohibited at
pseudo-junctions where exactly two adjacent streets meet, but U-turns are permitted
at intersections and dead ends. This prevents turning around in the middle of the road where one length of road happened to be digitized as two street features.The value you provide for this parameter is ignored unless Travel Mode is set to Custom, which is the default value.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: ALLOW_DEAD_ENDS_ONLY
Parameter Type: esriGPParameterTypeOptional
Category: Custom Travel Mode
Choice List: [ ALLOW_UTURNS, NO_UTURNS, ALLOW_DEAD_ENDS_ONLY, ALLOW_DEAD_ENDS_AND_INTERSECTIONS_ONLY ]
Parameter: time_window_factor
Data Type: GPString
Display Name Time Window Factor
Description: Rates the importance of honoring time windows. There are
three options described below. High—Places more importance on arriving at stops on time
than on minimizing drive times. Organizations that make
time-critical deliveries or that are very concerned with customer
service would choose High. Medium—This is the default value. Balances the importance
of minimizing drive times and arriving within time
windows. Low—Places more importance on minimizing drive times and
less on arriving at stops on time. You may want to use this setting
if you have a growing backlog of service requests. For the purpose
of servicing more orders in a day and reducing the backlog, you can
choose Low even though customers might be inconvenienced with your
late arrivals.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: Medium
Parameter Type: esriGPParameterTypeOptional
Category: Advanced Analysis
Choice List: [ High, Medium, Low ]
Parameter: spatially_cluster_routes
Data Type: GPBoolean
Display Name Spatially Cluster Routes
Description: CLUSTER (True)—Dynamic seed points are automatically created for
all routes, and the orders assigned to an individual
route are spatially clustered. Clustering orders tends to keep
routes in smaller areas and reduce how often different route lines
intersect one another; yet, clustering also tends to increase
overall travel times. NO_CLUSTER (False)—Dynamic seed points aren't
created. Choose this option if route zones are
specified.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: true
Parameter Type: esriGPParameterTypeOptional
Category: Advanced Analysis
Parameter: route_zones
Data Type: GPFeatureRecordSetLayer
Display Name Route Zones
Description: Delineates work territories for given routes. A route zone is a polygon feature and is used to constrain routes to servicing only those orders that fall within or near the specified area. Here are some examples of when route zones may be useful:Some of your employees don't have the required permits to perform work in certain states or communities. You can create a hard route zone so they only visit orders in areas where they meet the requirements.One of your vehicles breaks down frequently so you want to minimize response time by having it only visit orders that are close to your maintenance garage. You can create a soft or hard route zone to keep the vehicle nearby.When specifying the route zones, you need to set properties for each one, such as its associated route, by using attributes. The route zones can be specified with the following attributes:
ObjectID The system-managed ID field.
RouteName The name of the route to which this zone applies. A route zone can have a maximum of one associated route. This field can't contain null values, and it is a foreign key to the Name field in the Routes.
IsHardZone A Boolean value indicating a hard or soft route zone. A
True value indicates that the route zone is hard; that is, an order
that falls outside the route zone polygon can't be assigned to the
route. The default value is 1 (True). A False value (0) indicates
that such orders can still be assigned, but the cost of servicing
the order is weighted by a function that is based on the Euclidean
distance from the route zone. Basically, this means that as the
straight-line distance from the soft zone to the order increases,
the likelihood of the order being assigned to the route
decreases.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Geometry Type: esriGeometryPolygon
HasZ: false
HasM: false
Spatial Reference: 4326
(4326)
Fields:
-
OBJECTID
(
type: esriFieldTypeOID, alias: ObjectID
)
-
RouteName
(
type: esriFieldTypeString, alias: RouteName, length: 1024
)
-
IsHardZone
(
type: esriFieldTypeInteger, alias: IsHardZone
)
-
Shape_Length
(
type: esriFieldTypeDouble, alias: Shape_Length
)
-
Shape_Area
(
type: esriFieldTypeDouble, alias: Shape_Area
)
Features: None.
Parameter Type: esriGPParameterTypeOptional
Category: Advanced Analysis
Parameter: route_renewals
Data Type: GPRecordSet
Display Name Route Renewals
Description: Specifies the intermediate depots that routes can visit to reload or unload the cargo they are delivering or picking up. Specifically, a route renewal links a route to a depot. The relationship indicates the route can renew (reload or unload while en route) at the associated depot. Route renewals can be used to model scenarios in which a vehicle picks up a full load of deliveries at the starting depot, services the orders, returns to the depot to renew its load of deliveries, and continues servicing more orders. For example, in propane gas delivery, the vehicle may make several deliveries until its tank is nearly or completely depleted, visit a refueling point, and make more deliveries. Here are a few rules and options to consider:The reload/unload point, or renewal location, can be different from the start or end depot.Each route can have one or many predetermined renewal locations.A renewal location may be used more than once by a single route.In some cases where there may be several potential renewal locations for a route, the closest available renewal location is chosen by the solver.When specifying the route renewals, you need to set properties for each one, such as the name of the depot where the route renewal can occur, by using attributes. The route renewals can be specified with the following attributes:
ObjectIDThe system-managed ID field.
DepotName The name of the depot where this renewal takes place. This field can't contain a null value and is a foreign key to the Name field in the Depots. RouteName The name of the route to which this renewal applies. This field can't contain a null value and is a foreign key to the Name field in the Routes.
ServiceTime The service time for the renewal. This field can contain a null value; a null value indicates zero service time. The unit for this field value is specified by the time_units parameter. The time taken to load a vehicle at a renewal depot may depend on the size of the vehicle and how full or empty the vehicle is. However, the service time for a route renewal is a fixed value and does not take into account the actual load. As such, the renewal service time should be given a value corresponding to a full truckload, an average truckload, or another time estimate of your choice.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Fields:
-
OBJECTID
(
type: esriFieldTypeOID, alias: ObjectID
)
-
RouteName
(
type: esriFieldTypeString, alias: RouteName, length: 1024
)
-
DepotName
(
type: esriFieldTypeString, alias: DepotName, length: 500
)
-
ServiceTime
(
type: esriFieldTypeDouble, alias: ServiceTime
)
-
Sequences
(
type: esriFieldTypeString, alias: Sequences, length: 128
)
Features: None.
Parameter Type: esriGPParameterTypeOptional
Category: Advanced Analysis
Parameter: order_pairs
Data Type: GPRecordSet
Display Name Order Pairs
Description: Pairs pickup and delivery orders so they are serviced by the same route. Specifying order pairs prevents the analysis to assign only one of the orders to a route: either both orders are assigned to the same route, or neither order is assigned. Sometimes it is necessary for the pickup and delivery of orders to be paired. For example, a courier company might need to have a route pick up a high-priority package from one order and deliver it to another without returning to a depot, or sorting station, to minimize delivery time. These related orders can be assigned to the same route with the appropriate sequence by using order pairs. Moreover, restrictions on how long the package can stay in the vehicle can also be assigned; for example, the package might be a blood sample that has to be transported from the doctor's office to the lab within two hours. Some situations may require two pairs of orders. For example, suppose you want to transport a senior citizen from her home to the doctor and then back home. The ride from her home to the doctor is one pair of orders with a desired arrival time at the doctor, while the ride from the doctor to her home is another pair with a desired pickup time. When specifying the order pairs, you need to set properties for each one, such as the names of the two orders, by using attributes. The order pairs can be specified with the following attributes:
ObjectID The system-managed ID field.
FirstOrderName The name of the first order of the pair. This field is a foreign key to the Name field in the Orders. SecondOrderNameThe name of the second order of the pair. This field is a foreign key to the Name field in the Orders. The first order in the pair must be a pickup order; that is, the value for its DeliveryQuantities field is null. The second order in the pair must be a delivery order; that is, the value for its PickupQuantities field is null. The quantity picked up at the first order must agree with the quantity delivered at the second order. As a special case, both orders may have zero quantities for scenarios where capacities are not used. The order quantities are not loaded or unloaded at depots. MaxTransitTimeThe maximum transit time for the pair. The transit time is the duration from the departure time of the first order to the arrival time at the second order. This constraint limits the time-on-vehicle, or ride time, between the two orders. When a vehicle is carrying people or perishable goods, the ride time is typically shorter than that of a vehicle carrying packages or nonperishable goods. This field can contain null values; a null value indicates that there is no constraint on the ride time. The unit for this field value is specified by the timeUnits property of the analysis object. Excess transit time (measured with respect to the direct travel time between order pairs) can be tracked and weighted by the solver. Because of this, you can direct the VRP solver to take one of three approaches:Minimize the overall excess transit time, regardless of the increase in travel cost for the fleet.Find a solution that balances overall violation time and travel cost.Ignore the overall excess transit time and, instead, minimize the travel cost for the fleet. By assigning an importance level for the excess_transit_factor parameter, you are, in effect, choosing one of these
three approaches. Regardless of the importance level, the solver
will always return an error if the MaxTransitTime value is
surpassed.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Fields:
-
OBJECTID
(
type: esriFieldTypeOID, alias: ObjectID
)
-
FirstOrderName
(
type: esriFieldTypeString, alias: FirstOrderName, length: 500
)
-
SecondOrderName
(
type: esriFieldTypeString, alias: SecondOrderName, length: 500
)
-
MaxTransitTime
(
type: esriFieldTypeDouble, alias: MaxTransitTime
)
Features: None.
Parameter Type: esriGPParameterTypeOptional
Category: Advanced Analysis
Parameter: excess_transit_factor
Data Type: GPString
Display Name Excess Transit Factor
Description: Rates the importance of reducing excess transit time of
order pairs. Excess transit time is the amount of time exceeding
the time required to travel directly between the paired orders.
Excess time can be caused by driver breaks or travel to
intermediate orders and depots. Listed below are the three values
you can choose from. High—The solver tries to find a solution with the least
excess transit time between paired orders at the expense of
increasing the overall travel costs. It makes sense to use this
setting if you are transporting people between paired orders and
you want to shorten their ride time. This is characteristic of taxi
services. Medium—This is the default setting. The solver looks for
a balance between reducing excess transit time and reducing the
overall solution cost. Low—The solver tries to find a solution that minimizes
overall solution cost, regardless of excess transit time. This
setting is commonly used with courier services. Since couriers
transport packages as opposed to people, they don't need to worry
about ride time. Using Low allows the couriers to service paired
orders in the proper sequence and minimize the overall solution
cost.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: Medium
Parameter Type: esriGPParameterTypeOptional
Category: Advanced Analysis
Choice List: [ High, Medium, Low ]
Parameter: point_barriers
Data Type: GPFeatureRecordSetLayer
Display Name Point Barriers
Description: One or more points that will act as temporary
restrictions or represent additional time or distance that may be
required to travel on the underlying streets. For example, a point
barrier can be used to represent a fallen tree along a street or
time delay spent at a railroad crossing. The tool imposes a limit of 250 points that can be added
as barriers.When specifying point barriers, you can set properties for each, such as its name or barrier type, using the following attributes:
Name The name of the barrier. BarrierType Specifies whether the point barrier restricts travel
completely or adds time or distance when it is crossed. The value
for this attribute is specified as one of the following
integers (use the numeric code, not the name in parentheses): 0 (Restriction)—Prohibits travel through the barrier. The barrier
is referred to as a restriction point barrier since it acts as a
restriction. 2 (Added Cost)—Traveling through the barrier increases the travel
time or distance by the amount specified in the
Additional_Time, Additional_Distance, or Additional_Cost field. This barrier type is
referred to as an added-cost point barrier. Additional_Time The added travel time when the
barrier is traversed. This field is applicable only for added-cost
barriers and only if the travel mode used for the analysis uses an impedance attribute that is time based. This field
value must be greater than or equal to zero, and its units are the same as those specified in the
Measurement Units parameter. Additional_DistanceThe added distance when the
barrier is traversed. This field is applicable only for added-cost
barriers and only if the travel mode used for the analysis uses an impedance attribute that is distance based. The field value
must be greater than or equal to zero, and its units are the same as those specified in the
Measurement Units parameter.Additional_CostThe added cost when the
barrier is traversed. This field is applicable only for added-cost
barriers and only if the travel mode used for the analysis uses an impedance attribute that is neither time based nor distance based. FullEdgeSpecifies how the restriction point barriers are applied to the edge elements during the analysis. The field value is specified as one of the following integers (use the numeric code, not the name in parentheses): 0 (False)—Permits travel on the edge up to the barrier but not through it. This is the default value.1 (True)—Restricts travel anywhere on the associated edge. CurbApproachSpecifies the direction of traffic that is affected by the barrier. The field value is specified as one of the following integers (use the numeric code, not the name in parentheses): 0 (Either side of vehicle)—The barrier affects travel over the edge in both directions.1 (Right side of vehicle)—Vehicles are only affected if the barrier is on their right side during the approach. Vehicles that traverse the same edge but approach the barrier on their left side are not affected by the barrier. 2 (Left side of vehicle)—Vehicles are only affected if the barrier is on their left side during the approach. Vehicles that traverse the same edge but approach the barrier on their right side are not affected by the barrier. Because junctions are points and don't have a side, barriers on junctions affect all vehicles regardless of the curb approach. The CurbApproach attribute is designed to work with both types of national driving standards: right-hand traffic (United States) and left-hand traffic (United Kingdom). First, consider a facility on the left side of a vehicle. It is always on the left side regardless of whether the vehicle travels on the left or right half of the road. What may change with national driving standards is your decision to approach a facility from one of two directions, that is, so it ends up on the right or left side of the vehicle. For example, if you want to arrive at a facility and not have a lane of traffic between the vehicle and the facility, you would choose 1 (Right side of vehicle) in the United States and 2 (Left side of vehicle) in the United Kingdom.BearingThe direction in which a point is moving. The units are degrees and are measured clockwise from true north. This field is used in conjunction with the BearingTol field. Bearing data is usually sent automatically from a mobile device equipped with a GPS receiver. Try to include bearing data if you are loading an input location that is moving, such as a pedestrian or a vehicle. Using this field tends to prevent adding locations to the wrong edges, which can occur when a vehicle is near an intersection or an overpass for example. Bearing also helps the tool determine on which side of the street the point is. For more information, see Bearing and BearingTol in the ArcGIS help system. BearingTolThe bearing tolerance value creates a range of acceptable bearing values when locating moving points on an edge using the Bearing field. If the value from the Bearing field is within the range of acceptable values that are generated from the bearing tolerance on an edge, the point can be added as a network location there; otherwise, the closest point on the next-nearest edge is evaluated. The units are in degrees, and the default value is 30. Values must be greater than 0 and less than 180. A value of 30 means that when ArcGIS Network Analyst extension attempts to add a network location on an edge, a range of acceptable bearing values is generated 15 degrees to either side of the edge (left and right) and in both digitized directions of the edge. For more information, see Bearing and BearingTol in the ArcGIS help system. NavLatencyThis field is only used in the solve process if Bearing and BearingTol also have values; however, entering a NavLatency value is optional, even when values are present in Bearing and BearingTol. NavLatency indicates how much time is expected to elapse from the moment GPS information is sent from a moving vehicle to a server and the moment the processed route is received by the vehicle's navigation device. The time units of NavLatency are the same as the units specified by the timeUnits property of the analysis object.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Geometry Type: esriGeometryPoint
HasZ: false
HasM: false
Spatial Reference: 4326
(4326)
Fields:
-
OBJECTID
(
type: esriFieldTypeOID, alias: OBJECTID
)
-
Name
(
type: esriFieldTypeString, alias: Name, length: 500
)
-
BarrierType
(
type: esriFieldTypeInteger, alias: Barrier Type
)
-
Additional_Time
(
type: esriFieldTypeDouble, alias: Additional Time
)
-
Additional_Distance
(
type: esriFieldTypeDouble, alias: Additional Distance
)
-
AdditionalCost
(
type: esriFieldTypeDouble, alias: Additional Cost
)
-
CurbApproach
(
type: esriFieldTypeSmallInteger, alias: Curb Approach
)
-
FullEdge
(
type: esriFieldTypeInteger, alias: Full Edge
)
Features: None.
Parameter Type: esriGPParameterTypeOptional
Category: Barriers
Parameter: line_barriers
Data Type: GPFeatureRecordSetLayer
Display Name Line Barriers
Description: One or more lines that prohibit travel anywhere
the lines intersect the streets. For example, a parade or protest
that blocks traffic across several street segments can be modeled
with a line barrier. A line barrier can also quickly fence off
several roads from being traversed, thereby channeling possible
routes away from undesirable parts of the street
network. The tool imposes a limit on the number of streets you can
restrict using the Line Barriers parameter. While there is no limit to
the number of lines you can specify as line barriers, the combined
number of streets intersected by all the lines cannot exceed
500.When specifying the line barriers, you can set name and barrier type properties for each using the following attributes:
Name The name of the barrier.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Geometry Type: esriGeometryPolyline
HasZ: false
HasM: false
Spatial Reference: 4326
(4326)
Fields:
-
OBJECTID
(
type: esriFieldTypeOID, alias: OBJECTID
)
-
Name
(
type: esriFieldTypeString, alias: Name, length: 500
)
-
SHAPE_Length
(
type: esriFieldTypeDouble, alias: SHAPE_Length
)
Features: None.
Parameter Type: esriGPParameterTypeOptional
Category: Barriers
Parameter: polygon_barriers
Data Type: GPFeatureRecordSetLayer
Display Name Polygon Barriers
Description: The polygons that either completely restrict travel or
proportionately scale the time or distance required to travel on
the streets intersected by the polygons. The service imposes a limit on the number of streets you
can restrict using the Polygon Barriers parameter. While there is
no limit to the number of polygons you can specify as polygon
barriers, the combined number of streets intersected by all the
polygons cannot exceed 2,000.When specifying the polygon barriers, you can set properties for each, such as its name or barrier type, using the following attributes:
Name The name of the barrier. BarrierType Specifies whether the barrier restricts travel completely
or scales the cost (such as time or distance) for traveling through it. The field
value is specified as one of the following integers (use the numeric code, not the name in parentheses): 0 (Restriction)—Prohibits traveling through any part of the barrier.
The barrier is referred to as a restriction polygon barrier since it
prohibits traveling on streets intersected by the barrier. One use
of this type of barrier is to model floods covering areas of the
street that make traveling on those streets impossible. 1 (Scaled Cost)—Scales the cost (such as travel time or distance) required to travel the
underlying streets by a factor specified using the ScaledTimeFactor
or ScaledDistanceFactor field. If the streets are partially
covered by the barrier, the travel time or distance is apportioned
and then scaled. For example, a factor of 0.25 means that travel
on underlying streets is expected to be four times faster than
normal. A factor of 3.0 means it is expected to take three
times longer than normal to travel on underlying streets. This
barrier type is referred to as a scaled-cost polygon barrier. It
can be used to model storms that reduce travel speeds in specific
regions. ScaledTimeFactor This is the factor by which the travel time of the streets
intersected by the barrier is multiplied. The field value must be greater than zero. This field is applicable only for scaled-cost
barriers and only if the travel mode used for the analysis uses an impedance attribute that is time based. ScaledDistanceFactor This is the factor by which the distance of the streets
intersected by the barrier is multiplied. The field value must be greater than zero.This field is applicable only for scaled-cost
barriers and only if the travel mode used for the analysis uses an impedance attribute that is distance based. ScaledCostFactor This is the factor by which the cost of the streets
intersected by the barrier is multiplied. The field value must be greater than zero. This field is applicable only for scaled-cost
barriers and only if the travel mode used for the analysis uses an impedance attribute that is neither time based nor distance based.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Geometry Type: esriGeometryPolygon
HasZ: false
HasM: false
Spatial Reference: 4326
(4326)
Fields:
-
OBJECTID
(
type: esriFieldTypeOID, alias: OBJECTID
)
-
Name
(
type: esriFieldTypeString, alias: Name, length: 500
)
-
BarrierType
(
type: esriFieldTypeInteger, alias: Barrier Type
)
-
ScaledTimeFactor
(
type: esriFieldTypeDouble, alias: Scaled Time Factor
)
-
ScaledDistanceFactor
(
type: esriFieldTypeDouble, alias: Scaled Distance Factor
)
-
ScaledCostFactor
(
type: esriFieldTypeDouble, alias: Scaled Cost Factor
)
-
SHAPE_Length
(
type: esriFieldTypeDouble, alias: SHAPE_Length
)
-
SHAPE_Area
(
type: esriFieldTypeDouble, alias: SHAPE_Area
)
Features: None.
Parameter Type: esriGPParameterTypeOptional
Category: Barriers
Parameter: use_hierarchy_in_analysis
Data Type: GPBoolean
Display Name Use Hierarchy
Description: Specify whether hierarchy should be used when finding the best
routes. Checked (True)—Use hierarchy when finding routes. When
hierarchy is used, the tool prefers higher-order streets, such as
freeways, to lower-order streets, such as local roads, and can be used
to simulate the driver preference of traveling on freeways instead
of local roads even if that means a longer trip. This is especially
true when finding routes to faraway locations, because drivers on long-distance trips tend to prefer traveling on freeways where stops, intersections, and turns can be avoided. Using hierarchy is computationally faster,
especially for long-distance routes, as the tool has to select the
best route from a relatively smaller subset of streets. Unchecked (False)—Do not use hierarchy when finding routes. If
hierarchy is not used, the tool considers all the streets and doesn't
prefer higher-order streets when finding the route. This is often
used when finding short-distance routes within a city. The tool automatically reverts to using hierarchy if the
straight-line distance between orders, depots, or orders and depots is
greater than 50 miles, even if you have set this parameter to not use hierarchy.The value you provide for this parameter is ignored unless Travel Mode is set to Custom, which is the default value.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: true
Parameter Type: esriGPParameterTypeOptional
Category: Custom Travel Mode
Parameter: restrictions
Data Type: GPMultiValue:GPString
Display Name Restrictions
Description: The restrictions that will be honored by the tool when finding the best routes.A restriction represents a driving
preference or requirement. In most cases, restrictions cause roads
to be prohibited. For instance, using the Avoid Toll Roads restriction will result in a route that will include toll roads only when it is required to travel on toll roads to visit an incident or a facility. Height Restriction makes it possible to route around any clearances that are lower than the height of your vehicle. If you are carrying corrosive materials on your vehicle, using the Any Hazmat Prohibited restriction prevents hauling the materials along roads where it is marked illegal to do so. The values you provide for this parameter are ignored unless Travel Mode is set to Custom.Some restrictions require an additional value to be
specified for their use. This value must be associated
with the restriction name and a specific parameter intended to work
with the restriction. You can identify such restrictions if their
names appear in the AttributeName column in the Attribute
Parameter Values parameter. The ParameterValue field should be
specified in the Attribute Parameter Values parameter for the
restriction to be correctly used when finding traversable roads.Some restrictions are supported only in certain countries; their availability is stated by region in the list below. Of the restrictions that have limited availability within a region, you can determine whether the restriction is available in a particular country by reviewing the table in the Country List section of Data coverage for network analysis services web page. If a country has a value of Yes in the Logistics Attribute column, the restriction with select availability in the region is supported in that country. If you specify restriction names that are not available in the country where your incidents are located, the service ignores the invalid restrictions. The service also ignores restrictions when the Restriction Usage attribute parameter value is between 0 and 1 (see the Attribute Parameter Value parameter). It prohibits all restrictions when the Restriction Usage parameter value is greater than 0.The tool supports the following restrictions: Any Hazmat Prohibited—The results will not include roads
where transporting any kind of hazardous material is
prohibited. Availability: Select countries in North America and Europe Avoid Carpool Roads—The results will avoid roads that are
designated exclusively for car pool (high-occupancy)
vehicles. Availability: All countries Avoid Express Lanes—The results will avoid roads designated
as express lanes. Availability: All countries Avoid Ferries—The results will avoid ferries. Availability: All countries Avoid Gates—The results will avoid roads where there are
gates, such as keyed access or guard-controlled
entryways.Availability: All countries Avoid Limited Access Roads—The results will avoid roads
that are limited-access highways. Availability: All countries Avoid Private Roads—The results will avoid roads that are
not publicly owned and maintained. Availability: All countries Avoid Roads Unsuitable for Pedestrians—The results will avoid roads that are
unsuitable for pedestrians. Availability: All countries Avoid Stairways—The results will avoid all stairways on a pedestrian-suitable route. Availability: All countries Avoid Toll Roads—The results will avoid all toll
roads for automobiles.Availability: All countries Avoid Toll Roads for Trucks—The results will avoid all toll
roads for trucks.Availability: All countries Avoid Truck Restricted Roads—The results will avoid roads where trucks are not allowed, except when making deliveries.Availability: All countries Avoid Unpaved Roads—The results will avoid roads that are
not paved (for example, dirt, gravel, and so on). Availability: All countries Axle Count Restriction—The results will not include roads
where trucks with the specified number of axles are prohibited. The
number of axles can be specified using the Number of Axles
restriction parameter.Availability: Select countries in North America and Europe Driving a Bus—The results will not include roads where
buses are prohibited. Using this restriction will also ensure that
the results will honor one-way streets. Availability: All countries Driving a Delivery Vehicle—The results will not include
roads where delivery vehicles are prohibited. Using this restriction
will also ensure that the results will honor one-way
streets. Availability: All countries Driving a Taxi—The results will not include roads where
taxis are prohibited. Using this restriction will also ensure that
the results will honor one-way streets. Availability: All countries Driving a Truck—The results will not include roads where
trucks are prohibited. Using this restriction will also ensure that
the results will honor one-way streets. Availability: All countries Driving an Automobile—The results will not include roads
where automobiles are prohibited. Using this restriction will also
ensure that the results will honor one-way streets. Availability: All countries Driving an Emergency Vehicle—The results will not include
roads where emergency vehicles are prohibited. Using this
restriction will also ensure that the results will honor one-way
streets. Availability: All countries Height Restriction—The results will not include roads
where the vehicle height exceeds the maximum allowed height for the
road. The vehicle height can be specified using the Vehicle Height
(meters) restriction parameter. Availability: Select countries in North America and Europe Kingpin to Rear Axle Length Restriction—The results will
not include roads where the vehicle length exceeds the maximum
allowed kingpin to rear axle for all trucks on the road. The length
between the vehicle kingpin and the rear axle can be specified
using the Vehicle Kingpin to Rear Axle Length (meters) restriction
parameter. Availability: Select countries in North America and Europe Length Restriction—The results will not include roads
where the vehicle length exceeds the maximum allowed length for the
road. The vehicle length can be specified using the Vehicle Length
(meters) restriction parameter. Availability: Select countries in North America and Europe Preferred for Pedestrians—The results will use preferred routes suitable for pedestrian navigation. Availability: Select countries in North America and Europe Riding a Motorcycle—The results will not include roads
where motorcycles are prohibited. Using this restriction will also
ensure that the results will honor one-way streets. Availability: All countries Roads Under Construction Prohibited—The results will not
include roads that are under construction.Availability: All countries Semi or Tractor with One or More Trailers Prohibited—The
results will not include roads where semis or tractors with one or
more trailers are prohibited. Availability: Select countries in North America and Europe Single Axle Vehicles Prohibited—The results will not
include roads where vehicles with single axles are
prohibited.Availability: Select countries in North America and Europe Tandem Axle Vehicles Prohibited—The results will not
include roads where vehicles with tandem axles are
prohibited.Availability: Select countries in North America and Europe Through Traffic Prohibited—The results will not include
roads where through traffic (non local) is prohibited.Availability: All countries Truck with Trailers Restriction—The results will not
include roads where trucks with the specified number of trailers on
the truck are prohibited. The number of trailers on the truck can
be specified using the Number of Trailers on Truck restriction
parameter.Availability: Select countries in North America and Europe Use Preferred Hazmat Routes—The results will prefer roads
that are designated for transporting any kind of hazardous
materials. Availability: Select countries in North America and Europe Use Preferred Truck Routes—The results will prefer roads
that are designated as truck routes, such as the roads that are
part of the national network as specified by the National Surface
Transportation Assistance Act in the United States, or roads that
are designated as truck routes by the state or province, or roads
that are preferred by the truckers when driving in an
area.Availability: Select countries in North America and Europe Walking—The results will not include roads where
pedestrians are prohibited.Availability: All countries Weight Restriction—The results will not include roads
where the vehicle weight exceeds the maximum allowed weight for the
road. The vehicle weight can be specified using the Vehicle Weight
(kilograms) restriction parameter.Availability: Select countries in North America and Europe Weight per Axle Restriction—The results will not include
roads where the vehicle weight per axle exceeds the maximum allowed
weight per axle for the road. The vehicle weight per axle can be
specified using the Vehicle Weight per Axle (kilograms) restriction
parameter.Availability: Select countries in North America and Europe Width Restriction—The results will not include roads where
the vehicle width exceeds the maximum allowed width for the road.
The vehicle width can be specified using the Vehicle Width (meters)
restriction parameter.Availability: Select countries in North America and Europe The Driving a Delivery Vehicle restriction attribute is no longer available. The service will ignore this restriction since it is invalid. To achieve similar results, use the Driving a Truck restriction attribute along with the Avoid Truck Restricted Roads restriction attribute.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: [
Bus Lanes, Fords, Gated Communities, Non Legal Roads, One Way, Private Roads, Restricted Roads, Restricted Turns, Rough Surface Roads, State Highway, Vehicles on Cycleways, Vehicles on Walkways
]
Parameter Type: esriGPParameterTypeOptional
Category: Custom Travel Mode
Choice List: [ Bus Lanes, Cycles on Motorways, Cycles on Roads, Fords, Gated Communities, Non Legal Roads, One Way, Private Roads, Restricted Height, Restricted Roads, Restricted Turns, Restricted Weight, Rough Surface Roads, State Highway, Trucks Allowed, Trucks Allowed with Permit, Vehicles on Cycleways, Vehicles on Walkways, Walking on Roads ]
Parameter: attribute_parameter_values
Data Type: GPRecordSet
Display Name Attribute Parameter Values
Description: Specifies additional values required by some restrictions, such as the weight of a vehicle for Weight Restriction. You can also use the attribute parameter to specify whether any restriction prohibits, avoids, or prefers
travel on roads that use the restriction. If the restriction is
meant to avoid or prefer roads, you can further specify the degree
to which they are avoided or preferred using this
parameter. For example, you can choose to never use toll roads, avoid them as much as possible, or even highly prefer them.The values you provide for this parameter are ignored unless Travel Mode is set to Custom. If you specify the Attribute Parameter Values parameter from a
feature class, the field names on the feature class must match the fields as follows:AttributeName—Lists the name of the restriction.ParameterName—Lists the name of the parameter associated with the
restriction. A restriction can have one or more ParameterName field
values based on its intended use.ParameterValue—The value for ParameterName used by the tool
when evaluating the restriction. The Attribute Parameter Values parameter is dependent on the
Restrictions parameter. The ParameterValue field is applicable only
if the restriction name is specified as the value for the
Restrictions parameter. In Attribute Parameter Values, each
restriction (listed as AttributeName) has a ParameterName field
value, Restriction Usage, that specifies whether the restriction
prohibits, avoids, or prefers travel on the roads associated with
the restriction as well as the degree to which the roads are avoided or
preferred. The Restriction Usage ParameterName can be assigned any of
the following string values or their equivalent numeric values
listed in the parentheses: PROHIBITED (-1)—Travel on the roads using the restriction is completely
prohibited. AVOID_HIGH (5)—It
is highly unlikely the tool will include in the route the roads
that are associated with the restriction. AVOID_MEDIUM (2)—It
is unlikely the tool will include in the route the roads that are
associated with the restriction. AVOID_LOW (1.3)—It
is somewhat unlikely the tool will include in the route the roads
that are associated with the restriction. PREFER_LOW (0.8)—It
is somewhat likely the tool will include in the route the roads
that are associated with the restriction. PREFER_MEDIUM (0.5)—It is likely the tool will include in the route the roads that
are associated with the restriction. PREFER_HIGH (0.2)—It is highly likely the tool will include in the route the roads
that are associated with the restriction. In most cases, you can use the default value, PROHIBITED,
for the Restriction Usage if the restriction is dependent on a
vehicle characteristic such as vehicle height. However, in some
cases, the Restriction Usage value depends on your routing
preferences. For example, the Avoid Toll Roads restriction has the
default value of AVOID_MEDIUM for the Restriction Usage attribute.
This means that when the restriction is used, the tool will try to
route around toll roads when it can. AVOID_MEDIUM also indicates
how important it is to avoid toll roads when finding the best
route; it has a medium priority. Choosing AVOID_LOW puts lower
importance on avoiding tolls; choosing AVOID_HIGH instead gives it a higher importance and thus makes it more acceptable for
the service to generate longer routes to avoid tolls. Choosing
PROHIBITED entirely disallows travel on toll roads, making it
impossible for a route to travel on any portion of a toll road.
Keep in mind that avoiding or prohibiting toll roads, and thus
avoiding toll payments, is the objective for some. In contrast,
others prefer to drive on toll roads, because avoiding traffic is
more valuable to them than the money spent on tolls. In the latter
case, choose PREFER_LOW, PREFER_MEDIUM, or PREFER_HIGH as
the value for Restriction Usage. The higher the preference, the
farther the tool will go out of its way to travel on the roads
associated with the restriction.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Fields:
-
OBJECTID
(
type: esriFieldTypeOID, alias: ObjectID
)
-
AttributeName
(
type: esriFieldTypeString, alias: AttributeName, length: 255
)
-
ParameterName
(
type: esriFieldTypeString, alias: ParameterName, length: 255
)
-
ParameterValue
(
type: esriFieldTypeString, alias: ParameterValue, length: 25
)
Features: # records: 19
OBJECTID: 1
AttributeName: Bus Lanes
ParameterName: Restriction Usage
ParameterValue: PROHIBITED
OBJECTID: 2
AttributeName: Cycles on Motorways
ParameterName: Restriction Usage
ParameterValue: PROHIBITED
OBJECTID: 3
AttributeName: Cycles on Roads
ParameterName: Restriction Usage
ParameterValue: PREFER_HIGH
more...
Parameter Type: esriGPParameterTypeOptional
Category: Custom Travel Mode
Parameter: populate_route_lines
Data Type: GPBoolean
Display Name Populate Route Lines
Description: Specify if the output route line should be generated. Checked (True)—The output routes will have the
exact shape of the underlying streets. Unchecked (False)—No shape is generated for the
output routes, yet the routes will still contain tabular information about the solution. You won't be able to generate driving directions if
route lines aren't created. When the Route Shape parameter is set to True Shape, the
generalization of the route shape can be further controlled using
the appropriate values for the Route Line Simplification Tolerance
parameters. No matter which value you choose for the Route Shape
parameter, the best routes are always determined by minimizing the
travel along the streets, never using the straight-line
distance. This means that only the route shapes are different,
not the underlying streets that are searched when finding the
route.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: true
Parameter Type: esriGPParameterTypeOptional
Category: Output
Parameter: route_line_simplification_tolerance
Data Type: GPLinearUnit
Display Name Route Line Simplification Tolerance
Description: Specify by how much you want to simplify the geometry of the output lines for routes and directions.The value you provide for this parameter is ignored unless Travel Mode is set to Custom, which is the default value.The tool also ignores this parameter if the populate_route_lines parameter is unchecked (False). Simplification maintains critical
points on a route, such as turns at intersections, to define the
essential shape of the route and removes other points. The
simplification distance you specify is the maximum allowable offset
that the simplified line can deviate from the original line.
Simplifying a line reduces the number of vertices that are part of
the route geometry. This improves the tool execution
time.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: 5.0 (esriMeters)
Parameter Type: esriGPParameterTypeOptional
Category: Custom Travel Mode
Parameter: populate_directions
Data Type: GPBoolean
Display Name Populate Directions
Description: Specifies whether the tool will generate driving directions for
each route. Checked (True in Python)—Directions will be generated
and configured based on the values of the Directions Language,
Directions Style Name, and Directions Distance Units
parameters. Unchecked (False)—Directions will not be generated, and the tool
will return an empty Directions layer.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: false
Parameter Type: esriGPParameterTypeOptional
Category: Output
Parameter: directions_language
Data Type: GPString
Display Name Directions Language
Description: The language that will be used when generating
travel directions. This parameter is used only when the Populate
Directions parameter is checked (or set to True in Python). The parameter value can be
specified using one of the following two- or five-character language codes: ar—Arabic bs—Bosnian ca—Catalancs—Czech da—Danish de—German el—Greek en—English es—Spanish et—Estonian fi—Finnish fr—French he—Hebrew hi—Hindi hr—Croatian hu—Hungarian id—Indonesian it—Italian ja—Japanese ko—Korean lt—Lithuanian lv—Latvian nb—Norwegian nl—Dutch pl—Polish pt-BR—Brazilian
Portuguese pt-PT—European
Portuguese ro—Romanian ru—Russian sl—Slovenian sr—Serbian sv—Swedish th—Thaitr—Turkishuk—Ukrainian vi—Vietnamese zh-CN—Simplified
Chinese zh-HK—Traditional Chinese (Hong Kong)
zh-TW—Traditional Chinese (Taiwan)
The tool first tries to find an exact match for the specified language including any language localization. If an exact match is not found, it tries to match the language family. If a match is still not found, the tool returns the directions using the default language, English. For example, if the directions language is specified as es-MX (Mexican Spanish), the tool will return the directions in Spanish, as it supports the es language code but not es-MX.If a language supports localization, such as Brazilian Portuguese (pt-BR) and European Portuguese (pt-PT), you should specify the language family and the localization. If you only specify the language family, the tool will not match the language family and instead return directions in the default language, English. For example, if the directions language is specified as pt, the tool will return the directions in English since it cannot determine whether the directions should be returned in pt-BR or pt-PT.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: en
Parameter Type: esriGPParameterTypeOptional
Category: Output
Parameter: directions_style_name
Data Type: GPString
Display Name Directions Style Name
Description: Specifies the name of the formatting style for the
directions. This parameter is used only when the Populate Directions parameter is checked (or set to True in Python). NA Desktop—Turn-by-turn directions suitable
for printing will be generated. NA Navigation—Turn-by-turn directions designed
for an in-vehicle navigation device will be generated.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: NA Desktop
Parameter Type: esriGPParameterTypeOptional
Category: Output
Choice List: [ NA Desktop, NA Navigation, NA Campus ]
Parameter: travel_mode
Data Type: GPString
Display Name Travel Mode
Description: The mode of transportation to model in the analysis. Travel modes are managed in ArcGIS Online and can be configured by the administrator of your organization to reflect your organization's workflows. You need to specify the name of a travel mode that is supported by your organization. To get a list of supported travel mode names, run the GetTravelModes tool from the Utilities toolbox available under the same GIS Server connection you used to access the tool. The GetTravelModes tool adds a table, Supported Travel Modes, to the application. Any value in the Travel Mode Name field from the Supported Travel Modes table can be specified as input. You can also specify the value from Travel Mode Settings field as input. This speeds up the tool execution as the tool does not have to lookup the settings based on the travel mode name. The default value, Custom, allows you to configure your own travel mode using the custom travel mode parameters (UTurn at Junctions, Use Hierarchy, Restrictions, Attribute Parameter Values, and Impedance). The default values of the custom travel mode parameters model traveling by car. You may want to choose Custom and set the custom travel mode parameters listed above to model a pedestrian with a fast walking speed or a truck with a given height, weight, and cargo of certain hazardous materials. You can try different settings to get the analysis results you want. Once you have identified the analysis settings, work with your organization's administrator and save these settings as part of a new or existing travel mode so that everyone in your organization can run the analysis with the same settings. When you choose Custom, the values you set for the custom travel mode parameters are included in the analysis. Specifying another travel mode, as defined by your organization, causes any values you set for the custom travel mode parameters to be ignored; the tool overrides them with values from your specified travel mode.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: Custom
Parameter Type: esriGPParameterTypeOptional
Category:
Parameter: impedance
Data Type: GPString
Display Name Impedance
Description: Specifies the impedance, which is a value that represents the effort or cost of traveling along road segments or on other parts of the transportation network. Travel time is an impedance; a car may take 1 minute to travel a mile along an empty road. Travel times can vary by travel mode—a pedestrian may take more than 20 minutes to walk the same mile, so it is important to choose the right impedance for the travel mode you are modeling. The value you provide for this parameter is ignored unless Travel Mode is set to Custom, which is the default value.Choose from the following impedance values:TravelTime—Historical and live traffic data are used. This option is good for modeling the time it takes automobiles to travel along roads at a specific time of the day using live traffic speed data where available. When using TravelTime, you can optionally set the TravelTime::Vehicle Maximum Speed (km/h) attribute parameter to specify the physical limitation of the speed the vehicle is capable of traveling.Minutes—Live traffic data is not used, but historical average speeds for automobiles data is used.TruckTravelTime—Historical and live traffic data are used, but the speed is capped at the posted truck speed limit. This is good for modeling the time it takes for the trucks to travel along roads at a specific time. When using TruckTravelTime, you can optionally set the TruckTravelTime::Vehicle Maximum Speed (km/h) attribute parameter to specify the physical limitation of the speed the truck is capable of traveling.TruckMinutes—Live traffic data is not used, but the smaller of the historical average speeds for automobiles and the posted speed limits for trucks are used.WalkTime—The default is a speed of 5 km/hr on all roads and paths, but this can be configured through the WalkTime::Walking Speed (km/h) attribute parameter.TimeAt1KPH—The default is a speed of 1 km/hr on all roads and paths. The speed cannot be changed using any attribute parameter.Drive Time, Truck Time, and Walk Time impedance values are no longer supported and will be removed in a future release. If you use one of these values, the tool uses the value of the Time Impedance parameter.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: Drive Time
Parameter Type: esriGPParameterTypeOptional
Category: Custom Travel Mode
Choice List: [ Drive Time, Truck Time, Walk Time, TravelTimeByFoot, TravelTimeByCycle, TravelTimeByVehicle ]
Parameter: time_zone_usage_for_time_fields
Data Type: GPString
Display Name Time Zone Usage for Time Fields
Description: Specifies the time zone for the input date-time fields supported by the tool. This parameter specifies the time zone for the following fields: TimeWindowStart1, TimeWindowEnd1, TimeWindowStart2, TimeWindowEnd2, InboundArriveTime, and OutboundDepartTime on orders. TimeWindowStart1, TimeWindowEnd1, TimeWindowStart2, and TimeWindowEnd2 on depots. EarliestStartTime and LatestStartTime on routes. TimeWindowStart and TimeWindowEnd on breaks.
GEO_LOCAL—The date-time values associated with the orders or depots are in the time zone in which the orders and depots are located. For routes, the date-time values are based on the time zone in which the starting depot for the route is located. If a route does not have a starting depot, all orders and depots across all the routes must be in a single time zone. For breaks, the date-time values are based on the time zone of the routes. For example, if your depot is located in an area that follows eastern standard time and has the first time window values (specified as TimeWindowStart1 and TimeWindowEnd1) of 8 AM and 5 PM, the time window values will be treated as 8:00 a.m. and 5:00 p.m. eastern standard time.UTC—The date-time values associated with the orders or depots are in the in coordinated universal time (UTC) and are not based on the time zone in which the orders or depots are located. For example, if your depot is located in an area that follows eastern standard time and has the first time window values (specified as TimeWindowStart1 and TimeWindowEnd1) of 8 AM and 5 PM, the time window values will be treated as 12:00 p.m. and 9:00 p.m. eastern standard time assuming the eastern standard time is obeying the daylight saving time. Specifying the date-time values in UTC is useful if you do not know the time zone in which the orders or depots are located or when you have orders and depots in multiple time zones, and you want all the date-time values to start simultaneously. The UTC option is applicable only when your network dataset defines a time zone attribute. Otherwise, all the date-time values are always treated as GEO_LOCAL.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: GEO_LOCAL
Parameter Type: esriGPParameterTypeOptional
Category: Advanced Analysis
Choice List: [ GEO_LOCAL, UTC ]
Parameter: save_output_layer
Data Type: GPBoolean
Display Name Save Output Network Analysis Layer
Description: Specify if the tool should save the analysis settings as a network analysis layer file. You cannot directly work with this file even when you open the file in an ArcGIS Desktop application like ArcMap. It is meant to be sent to Esri Technical Support to diagnose the quality of results returned from the tool.
Checked (True)—Save the network analysis layer file. The file is downloaded in a temporary directory on your machine. In ArcGIS Pro, the location of the downloaded file can be determined by viewing the value for the Output Network Analysis Layer parameter in the entry corresponding to the tool execution in the Geoprocessing history of your Project. In ArcMap, the location of the file can be determined by accessing the Copy Location option in the shortcut menu on the Output Network Analysis Layer parameter in the entry corresponding to the tool execution in the Geoprocessing Results window. Unchecked (False)—Do not save the network analysis layer file. This is the default.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: false
Parameter Type: esriGPParameterTypeOptional
Category: Output
Parameter: overrides
Data Type: GPString
Display Name Overrides
Description: Additional settings that can influence the behavior of the solver when finding solutions for the network analysis problems.
The value for this parameter must be specified in JavaScript Object Notation (JSON). For example, a valid value is of the following form: {"overrideSetting1" : "value1", "overrideSetting2" : "value2"}. The override setting name is always enclosed in double quotation marks. The values can be a number, Boolean, or a string. The default value for this parameter is no
value, which indicates not to override any solver
settings. Overrides are advanced settings that should be
used only after careful analysis of the results obtained before and
after applying the settings. A list of supported override settings
for each solver and their acceptable values can be obtained by
contacting Esri Technical Support.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeOptional
Category: Advanced Analysis
Parameter: save_route_data
Data Type: GPBoolean
Display Name Save Route Data
Description: Choose whether the output includes a zip file
that contains a file geodatabase holding the inputs and outputs of
the analysis in a format that can be used to share route layers
with ArcGIS Online or Portal for ArcGIS.Checked (True)—Save the route data as a zip file. The file is downloaded in a temporary directory on your machine. In ArcGIS Pro, the location of the downloaded file can be determined by viewing the value for the Output Route Data parameter in the entry corresponding to the tool execution in the Geoprocessing history of your Project. In ArcMap, the location of the file can be determined by accessing the Copy Location option in the shortcut menu on the Output Route Data parameter in the entry corresponding to the tool execution in the Geoprocessing Results window. Unchecked (False)—Do not save the route data. This is the default.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: false
Parameter Type: esriGPParameterTypeOptional
Category: Output
Parameter: time_impedance
Data Type: GPString
Display Name Time Impedance
Description: The time-based impedance, which is a value that represents the travel time along road segments or on other parts of the transportation network.If the impedance for the travel mode, as specified using the Impedance parameter, is time based, the value for Time Impedance and Impedance parameters must be identical. Otherwise, the service will return an error.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: TravelTimeByVehicle
Parameter Type: esriGPParameterTypeOptional
Category: Custom Travel Mode
Choice List: [ TravelTimeByFoot, TravelTimeByCycle, TravelTimeByVehicle ]
Parameter: distance_impedance
Data Type: GPString
Display Name Distance Impedance
Description: If the impedance for the travel mode, as specified using the Impedance parameter, is distance based, the value for Distance Impedance and Impedance parameters must be identical. Otherwise, the service will return an error.The distance-based impedance, which is a value that represents the travel distance along road segments or on other parts of the transportation network.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: Length
Parameter Type: esriGPParameterTypeOptional
Category: Custom Travel Mode
Choice List: [ Length ]
Parameter: populate_stop_shapes
Data Type: GPBoolean
Display Name Populate Stop Shapes
Description: Specify if the tool should create the shapes for the output assigned and unassigned stops.
Checked (True)—The output assigned and unassigned stops are created as point features. This can be useful to visualize which stops are assigned to routes and which stops could not be assigned to any routes.Unchecked (False)—The output assigned and unassigned stops are created as tables and will not have shapes. This is the default. Use this option only of your application does not have a need to visualize the output stops and can work with just the attributes of the stops.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: false
Parameter Type: esriGPParameterTypeOptional
Category: Output
Parameter: output_format
Data Type: GPString
Display Name Output Format
Description: Specifies the format in which the output features will be created. Choose from the following options:Feature Set—The output features will be returned as feature classes and tables. This is the default. JSON File—The output features will be returned as a compressed file containing the JSON representation of the outputs. When this option is specified, the output is a single file (with a .zip extension) that contains one or more JSON files (with a .json extension) for each of the outputs created by the service. GeoJSON File—The output features will be returned as a compressed file containing the GeoJSON representation of the outputs. When this option is specified, the output is a single file (with a .zip extension) that contains one or more GeoJSON files (with a .geojson extension) for each of the outputs created by the service.When a file based output format, such as JSON File or GeoJSON File, is specified, no outputs will be added to the display because the application, such as ArcMap or ArcGIS Pro, cannot draw the contents of the result file. Instead, the result file is downloaded to a temporary directory on your machine. In ArcGIS Pro, the location of the downloaded file can be determined by viewing the value for the Output Result File parameter in the entry corresponding to the tool execution in the geoprocessing history of your project. In ArcMap, the location of the file can be determined by accessing the Copy Location option in the shortcut menu on the Output Result File parameter in the entry corresponding to the tool execution in the Geoprocessing Results window.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: Feature Set
Parameter Type: esriGPParameterTypeOptional
Category: Output
Choice List: [ Feature Set, JSON File, GeoJSON File ]
Parameter: ignore_invalid_order_locations
Data Type: GPBoolean
Display Name Ignore Invalid Order Locations
Description: Specifies whether invalid orders will be ignored when solving the vehicle routing problem.
Checked (True)—The solve operation will ignore any invalid orders and return a solution, given it didn't encounter any other errors. If you need to generate routes and deliver them to drivers immediately, you may be able to ignore invalid orders, solve, and distribute the routes to your drivers. Next, resolve any invalid orders from the last solve and include them in the VRP analysis for the next workday or work shift.Unchecked (False)—The solve operation will fail when any invalid orders are encountered. An invalid order is an order that the VRP solver can't reach. An order may be unreachable for a variety of reasons, including the following: the order is located on a prohibited network element, isn't on the network at all, or is on a disconnected part of the network.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: false
Parameter Type: esriGPParameterTypeOptional
Category: Network Locations
Parameter: ignore_network_location_fields
Data Type: GPBoolean
Display Name Ignore Network Location Fields
Description: Specifies whether the network location fields will be considered when locating inputs such as stops or facilities on the network.
Checked (True in Python)—Network location fields will not be considered when locating the inputs on the network. Instead, the inputs will always be located by performing a spatial search. This is the default value.Unchecked (False in Python)—Network location fields will be considered when locating the inputs on the network.
Direction: esriGPParameterDirectionInput
Filter:
Dependency:
Default Value: false
Parameter Type: esriGPParameterTypeOptional
Category: Network Locations
Parameter: out_unassigned_stops
Data Type: GPRecordSet
Display Name Output Unassigned Stops
Description:
Direction: esriGPParameterDirectionOutput
Filter:
Dependency:
Default Value:
Fields:
-
ObjectID
(
type: esriFieldTypeOID, alias: ObjectID
)
-
StopType
(
type: esriFieldTypeSmallInteger, alias: StopType
)
-
Name
(
type: esriFieldTypeString, alias: Name, length: 500
)
-
ViolatedConstraints
(
type: esriFieldTypeInteger, alias: ViolatedConstraints
)
-
Status
(
type: esriFieldTypeInteger, alias: Status
)
-
ORIG_FID
(
type: esriFieldTypeInteger, alias: ORIG_FID
)
Features: None.
Parameter Type: esriGPParameterTypeDerived
Category:
Parameter: out_stops
Data Type: GPRecordSet
Display Name Output Stops
Description:
Direction: esriGPParameterDirectionOutput
Filter:
Dependency:
Default Value:
Fields:
-
ObjectID
(
type: esriFieldTypeOID, alias: ObjectID
)
-
Name
(
type: esriFieldTypeString, alias: Name, length: 500
)
-
PickupQuantities
(
type: esriFieldTypeString, alias: PickupQuantities, length: 128
)
-
DeliveryQuantities
(
type: esriFieldTypeString, alias: DeliveryQuantities, length: 128
)
-
StopType
(
type: esriFieldTypeSmallInteger, alias: StopType
)
-
RouteName
(
type: esriFieldTypeString, alias: RouteName, length: 1024
)
-
Sequence
(
type: esriFieldTypeInteger, alias: Sequence
)
-
FromPrevTravelTime
(
type: esriFieldTypeDouble, alias: FromPrevTravelTime
)
-
FromPrevDistance
(
type: esriFieldTypeDouble, alias: FromPrevDistance
)
-
ArriveCurbApproach
(
type: esriFieldTypeInteger, alias: ArriveCurbApproach
)
-
DepartCurbApproach
(
type: esriFieldTypeInteger, alias: DepartCurbApproach
)
-
ArriveTime
(
type: esriFieldTypeDate, alias: ArriveTime, length: 16
)
-
DepartTime
(
type: esriFieldTypeDate, alias: DepartTime, length: 16
)
-
ArriveTimeUTC
(
type: esriFieldTypeDate, alias: ArriveTimeUTC, length: 16
)
-
DepartTimeUTC
(
type: esriFieldTypeDate, alias: DepartTimeUTC, length: 16
)
-
WaitTime
(
type: esriFieldTypeDouble, alias: WaitTime
)
-
ViolationTime
(
type: esriFieldTypeDouble, alias: ViolationTime
)
-
SnapX
(
type: esriFieldTypeDouble, alias: SnapX
)
-
SnapY
(
type: esriFieldTypeDouble, alias: SnapY
)
-
SnapZ
(
type: esriFieldTypeDouble, alias: SnapZ
)
-
DistanceToNetworkInMeters
(
type: esriFieldTypeDouble, alias: DistanceToNetworkInMeters
)
-
ORIG_FID
(
type: esriFieldTypeInteger, alias: ORIG_FID
)
Features: None.
Parameter Type: esriGPParameterTypeDerived
Category:
Parameter: out_routes
Data Type: GPFeatureRecordSetLayer
Display Name Output Routes
Description:
Direction: esriGPParameterDirectionOutput
Filter:
Dependency:
Default Value:
Geometry Type: esriGeometryPolyline
HasZ: false
HasM: true
Spatial Reference: 2193
(2193)
Fields:
-
ObjectID
(
type: esriFieldTypeOID, alias: ObjectID
)
-
Name
(
type: esriFieldTypeString, alias: Name, length: 1024
)
-
ViolatedConstraints
(
type: esriFieldTypeInteger, alias: ViolatedConstraints
)
-
OrderCount
(
type: esriFieldTypeInteger, alias: OrderCount
)
-
TotalCost
(
type: esriFieldTypeDouble, alias: TotalCost
)
-
RegularTimeCost
(
type: esriFieldTypeDouble, alias: RegularTimeCost
)
-
OvertimeCost
(
type: esriFieldTypeDouble, alias: OvertimeCost
)
-
DistanceCost
(
type: esriFieldTypeDouble, alias: DistanceCost
)
-
TotalTime
(
type: esriFieldTypeDouble, alias: TotalTime
)
-
TotalOrderServiceTime
(
type: esriFieldTypeDouble, alias: TotalOrderServiceTime
)
-
TotalBreakServiceTime
(
type: esriFieldTypeDouble, alias: TotalBreakServiceTime
)
-
TotalTravelTime
(
type: esriFieldTypeDouble, alias: TotalTravelTime
)
-
TotalDistance
(
type: esriFieldTypeDouble, alias: TotalDistance
)
-
StartTime
(
type: esriFieldTypeDate, alias: StartTime, length: 16
)
-
EndTime
(
type: esriFieldTypeDate, alias: EndTime, length: 16
)
-
StartTimeUTC
(
type: esriFieldTypeDate, alias: StartTimeUTC, length: 16
)
-
EndTimeUTC
(
type: esriFieldTypeDate, alias: EndTimeUTC, length: 16
)
-
TotalWaitTime
(
type: esriFieldTypeDouble, alias: TotalWaitTime
)
-
TotalViolationTime
(
type: esriFieldTypeDouble, alias: TotalViolationTime
)
-
RenewalCount
(
type: esriFieldTypeInteger, alias: RenewalCount
)
-
TotalRenewalServiceTime
(
type: esriFieldTypeDouble, alias: TotalRenewalServiceTime
)
-
Shape_Length
(
type: esriFieldTypeDouble, alias: Shape_Length
)
Features: None.
Parameter Type: esriGPParameterTypeDerived
Category:
Parameter: out_directions
Data Type: GPFeatureRecordSetLayer
Display Name Output Directions
Description:
Direction: esriGPParameterDirectionOutput
Filter:
Dependency:
Default Value:
Geometry Type: esriGeometryPolyline
HasZ: false
HasM: true
Spatial Reference: 2193
(2193)
Fields:
-
ObjectID
(
type: esriFieldTypeOID, alias: ObjectID
)
-
RouteName
(
type: esriFieldTypeString, alias: RouteName, length: 1024
)
-
ArriveTime
(
type: esriFieldTypeDate, alias: ArriveTime, length: 16
)
-
Type
(
type: esriFieldTypeSmallInteger, alias: Type
)
-
SubItemType
(
type: esriFieldTypeSmallInteger, alias: SubItemType
)
-
Text
(
type: esriFieldTypeString, alias: Text, length: 1024
)
-
ElapsedTime
(
type: esriFieldTypeSingle, alias: ElapsedTime
)
-
DriveDistance
(
type: esriFieldTypeSingle, alias: DriveDistance
)
-
Shape_Length
(
type: esriFieldTypeDouble, alias: Shape_Length
)
Features: None.
Parameter Type: esriGPParameterTypeDerived
Category:
Parameter: solve_succeeded
Data Type: GPBoolean
Display Name Solve Succeeded
Description:
Direction: esriGPParameterDirectionOutput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeDerived
Category:
Parameter: out_network_analysis_layer
Data Type: GPDataFile
Display Name Output Network Analysis Layer
Description:
Direction: esriGPParameterDirectionOutput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeDerived
Category:
Parameter: out_route_data
Data Type: GPDataFile
Display Name Output Route Data
Description:
Direction: esriGPParameterDirectionOutput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeDerived
Category:
Parameter: out_result_file
Data Type: GPDataFile
Display Name Output Result File
Description:
Direction: esriGPParameterDirectionOutput
Filter:
Dependency:
Default Value:
Parameter Type: esriGPParameterTypeDerived
Category:
Supported Operations:
Execute Task
Child Resources:
Metadata