Reference documentation and code samples for the Google Cloud Optimization V1 Client class VisitRequest.
Request for a visit which can be done by a vehicle: it has a geo-location (or two, see below), opening and closing times represented by time windows, and a service duration time (time spent by the vehicle once it has arrived to pickup or drop off goods).
Generated from protobuf message google.cloud.optimization.v1.Shipment.VisitRequest
Methods
__construct
Constructor.
data
array
Optional. Data for populating the Message object.
↳ arrival_location
Google\Type\LatLng
The geo-location where the vehicle arrives when performing this VisitRequest
. If the shipment model has duration distance matrices, arrival_location
must not be specified.
↳ arrival_waypoint
Google\Cloud\Optimization\V1\Waypoint
The waypoint where the vehicle arrives when performing this VisitRequest
. If the shipment model has duration distance matrices, arrival_waypoint
must not be specified.
↳ departure_location
Google\Type\LatLng
The geo-location where the vehicle departs after completing this VisitRequest
. Can be omitted if it is the same as arrival_location
. If the shipment model has duration distance matrices, departure_location
must not be specified.
↳ departure_waypoint
Google\Cloud\Optimization\V1\Waypoint
The waypoint where the vehicle departs after completing this VisitRequest
. Can be omitted if it is the same as arrival_waypoint
. If the shipment model has duration distance matrices, departure_waypoint
must not be specified.
↳ tags
array
Specifies tags attached to the visit request. Empty or duplicate strings are not allowed.
↳ time_windows
array< Google\Cloud\Optimization\V1\TimeWindow
>
Time windows which constrain the arrival time at a visit. Note that a vehicle may depart outside of the arrival time window, i.e. arrival time + duration do not need to be inside a time window. This can result in waiting time if the vehicle arrives before TimeWindow.start_time
. The absence of TimeWindow
means that the vehicle can perform this visit at any time. Time windows must be disjoint, i.e. no time window must overlap with or be adjacent to another, and they must be in increasing order. cost_per_hour_after_soft_end_time
and soft_end_time
can only be set if there is a single time window.
↳ duration
Google\Protobuf\Duration
Duration of the visit, i.e. time spent by the vehicle between arrival and departure (to be added to the possible waiting time; see time_windows
).
↳ cost
float
Cost to service this visit request on a vehicle route. This can be used to pay different costs for each alternative pickup or delivery of a shipment. This cost must be in the same unit as Shipment.penalty_cost
and must not be negative.
↳ load_demands
array| Google\Protobuf\Internal\MapField
Load demands of this visit request. This is just like Shipment.load_demands field, except that it only applies to this VisitRequest instead of the whole Shipment . The demands listed here are added to the demands listed in Shipment.load_demands .
↳ visit_types
array
Specifies the types of the visit. This may be used to allocate additional time required for a vehicle to complete this visit (see Vehicle.extra_visit_duration_for_visit_type ). A type can only appear once.
↳ label
string
Specifies a label for this VisitRequest
. This label is reported in the response as visit_label
in the corresponding ShipmentRoute.Visit
.
↳ demands
array< Google\Cloud\Optimization\V1\CapacityQuantity
>
Deprecated: Use VisitRequest.load_demands instead.
getArrivalLocation
The geo-location where the vehicle arrives when performing this VisitRequest
. If the shipment model has duration distance matrices, arrival_location
must not be specified.
hasArrivalLocation
clearArrivalLocation
setArrivalLocation
The geo-location where the vehicle arrives when performing this VisitRequest
. If the shipment model has duration distance matrices, arrival_location
must not be specified.
$this
getArrivalWaypoint
The waypoint where the vehicle arrives when performing this VisitRequest
. If the shipment model has duration distance matrices, arrival_waypoint
must not be specified.
hasArrivalWaypoint
clearArrivalWaypoint
setArrivalWaypoint
The waypoint where the vehicle arrives when performing this VisitRequest
. If the shipment model has duration distance matrices, arrival_waypoint
must not be specified.
$this
getDepartureLocation
The geo-location where the vehicle departs after completing this VisitRequest
. Can be omitted if it is the same as arrival_location
.
If the shipment model has duration distance matrices, departure_location
must not be specified.
hasDepartureLocation
clearDepartureLocation
setDepartureLocation
The geo-location where the vehicle departs after completing this VisitRequest
. Can be omitted if it is the same as arrival_location
.
If the shipment model has duration distance matrices, departure_location
must not be specified.
$this
getDepartureWaypoint
The waypoint where the vehicle departs after completing this VisitRequest
. Can be omitted if it is the same as arrival_waypoint
.
If the shipment model has duration distance matrices, departure_waypoint
must not be specified.
hasDepartureWaypoint
clearDepartureWaypoint
setDepartureWaypoint
The waypoint where the vehicle departs after completing this VisitRequest
. Can be omitted if it is the same as arrival_waypoint
.
If the shipment model has duration distance matrices, departure_waypoint
must not be specified.
$this
getTags
Specifies tags attached to the visit request.
Empty or duplicate strings are not allowed.
setTags
Specifies tags attached to the visit request.
Empty or duplicate strings are not allowed.
var
string[]
$this
getTimeWindows
Time windows which constrain the arrival time at a visit.
Note that a vehicle may depart outside of the arrival time window, i.e.
arrival time + duration do not need to be inside a time window. This can
result in waiting time if the vehicle arrives before TimeWindow.start_time
.
The absence of TimeWindow
means that the vehicle can perform this visit
at any time.
Time windows must be disjoint, i.e. no time window must overlap with or
be adjacent to another, and they must be in increasing order. cost_per_hour_after_soft_end_time
and soft_end_time
can only
be set if there is a single time window.
setTimeWindows
Time windows which constrain the arrival time at a visit.
Note that a vehicle may depart outside of the arrival time window, i.e.
arrival time + duration do not need to be inside a time window. This can
result in waiting time if the vehicle arrives before TimeWindow.start_time
.
The absence of TimeWindow
means that the vehicle can perform this visit
at any time.
Time windows must be disjoint, i.e. no time window must overlap with or
be adjacent to another, and they must be in increasing order. cost_per_hour_after_soft_end_time
and soft_end_time
can only
be set if there is a single time window.
$this
getDuration
Duration of the visit, i.e. time spent by the vehicle between arrival
and departure (to be added to the possible waiting time; see time_windows
).
hasDuration
clearDuration
setDuration
Duration of the visit, i.e. time spent by the vehicle between arrival
and departure (to be added to the possible waiting time; see time_windows
).
$this
getCost
Cost to service this visit request on a vehicle route. This can be used
to pay different costs for each alternative pickup or delivery of a
shipment. This cost must be in the same unit as Shipment.penalty_cost
and must not be negative.
float
setCost
Cost to service this visit request on a vehicle route. This can be used
to pay different costs for each alternative pickup or delivery of a
shipment. This cost must be in the same unit as Shipment.penalty_cost
and must not be negative.
var
float
$this
getLoadDemands
Load demands of this visit request. This is just like Shipment.load_demands field, except that it only applies to this VisitRequest instead of the whole Shipment .
The demands listed here are added to the demands listed in Shipment.load_demands .
setLoadDemands
Load demands of this visit request. This is just like Shipment.load_demands field, except that it only applies to this VisitRequest instead of the whole Shipment .
The demands listed here are added to the demands listed in Shipment.load_demands .
$this
getVisitTypes
Specifies the types of the visit. This may be used to allocate additional time required for a vehicle to complete this visit (see Vehicle.extra_visit_duration_for_visit_type ).
A type can only appear once.
setVisitTypes
Specifies the types of the visit. This may be used to allocate additional time required for a vehicle to complete this visit (see Vehicle.extra_visit_duration_for_visit_type ).
A type can only appear once.
var
string[]
$this
getLabel
Specifies a label for this VisitRequest
. This label is reported in the
response as visit_label
in the corresponding ShipmentRoute.Visit
.
string
setLabel
Specifies a label for this VisitRequest
. This label is reported in the
response as visit_label
in the corresponding ShipmentRoute.Visit
.
var
string
$this
getDemands
Deprecated: Use VisitRequest.load_demands instead.
setDemands
Deprecated: Use VisitRequest.load_demands instead.
$this