Google Cloud Optimization V1 Client - Class Transition (0.7.0)

Reference documentation and code samples for the Google Cloud Optimization V1 Client class Transition.

Transition between two events on the route. See the description of ShipmentRoute.

If the vehicle does not have a start_location and/or end_location, the corresponding travel metrics are 0.

Generated from protobuf message google.cloud.optimization.v1.ShipmentRoute.Transition

Namespace

Google \ Cloud \ Optimization \ V1 \ ShipmentRoute

Methods

__construct

Constructor.

Parameters
Name Description
data array

Optional. Data for populating the Message object.

↳ travel_duration Google\Protobuf\Duration

Travel duration during this transition.

↳ travel_distance_meters float

Distance traveled during the transition.

↳ traffic_info_unavailable bool

When traffic is requested via [OptimizeToursRequest.consider_road_traffic] [google.cloud.optimization.v1.OptimizeToursRequest.consider_road_traffic], and the traffic info couldn't be retrieved for a Transition, this boolean is set to true. This may be temporary (rare hiccup in the realtime traffic servers) or permanent (no data for this location).

↳ delay_duration Google\Protobuf\Duration

Sum of the delay durations applied to this transition. If any, the delay starts exactly delay_duration seconds before the next event (visit or vehicle end). See TransitionAttributes.delay.

↳ break_duration Google\Protobuf\Duration

Sum of the duration of the breaks occurring during this transition, if any. Details about each break's start time and duration are stored in ShipmentRoute.breaks.

↳ wait_duration Google\Protobuf\Duration

Time spent waiting during this transition. Wait duration corresponds to idle time and does not include break time. Also note that this wait time may be split into several non-contiguous intervals.

↳ total_duration Google\Protobuf\Duration

Total duration of the transition, provided for convenience. It is equal to: * next visit start_time (or vehicle_end_time if this is the last transition) - this transition's start_time; * if ShipmentRoute.has_traffic_infeasibilities is false, the following additionally holds: total_duration = travel_duration + delay_duration + break_duration + wait_duration.

↳ start_time Google\Protobuf\Timestamp

Start time of this transition.

↳ route_polyline Google\Cloud\Optimization\V1\ShipmentRoute\EncodedPolyline

The encoded polyline representation of the route followed during the transition. This field is only populated if [populate_transition_polylines] [google.cloud.optimization.v1.OptimizeToursRequest.populate_transition_polylines] is set to true.

↳ vehicle_loads array|Google\Protobuf\Internal\MapField

Vehicle loads during this transition, for each type that either appears in this vehicle's Vehicle.load_limits, or that have non-zero Shipment.load_demands on some shipment performed on this route. The loads during the first transition are the starting loads of the vehicle route. Then, after each visit, the visit's load_demands are either added or subtracted to get the next transition's loads, depending on whether the visit was a pickup or a delivery.

↳ loads array<Google\Cloud\Optimization\V1\CapacityQuantity>

Deprecated: Use Transition.vehicle_loads instead.

getTravelDuration

Travel duration during this transition.

Returns
Type Description
Google\Protobuf\Duration|null

hasTravelDuration

clearTravelDuration

setTravelDuration

Travel duration during this transition.

Parameter
Name Description
var Google\Protobuf\Duration
Returns
Type Description
$this

getTravelDistanceMeters

Distance traveled during the transition.

Returns
Type Description
float

setTravelDistanceMeters

Distance traveled during the transition.

Parameter
Name Description
var float
Returns
Type Description
$this

getTrafficInfoUnavailable

When traffic is requested via OptimizeToursRequest.consider_road_traffic, and the traffic info couldn't be retrieved for a Transition, this boolean is set to true. This may be temporary (rare hiccup in the realtime traffic servers) or permanent (no data for this location).

Returns
Type Description
bool

setTrafficInfoUnavailable

When traffic is requested via OptimizeToursRequest.consider_road_traffic, and the traffic info couldn't be retrieved for a Transition, this boolean is set to true. This may be temporary (rare hiccup in the realtime traffic servers) or permanent (no data for this location).

Parameter
Name Description
var bool
Returns
Type Description
$this

getDelayDuration

Sum of the delay durations applied to this transition. If any, the delay starts exactly delay_duration seconds before the next event (visit or vehicle end). See TransitionAttributes.delay.

Returns
Type Description
Google\Protobuf\Duration|null

hasDelayDuration

clearDelayDuration

setDelayDuration

Sum of the delay durations applied to this transition. If any, the delay starts exactly delay_duration seconds before the next event (visit or vehicle end). See TransitionAttributes.delay.

Parameter
Name Description
var Google\Protobuf\Duration
Returns
Type Description
$this

getBreakDuration

Sum of the duration of the breaks occurring during this transition, if any. Details about each break's start time and duration are stored in ShipmentRoute.breaks.

Returns
Type Description
Google\Protobuf\Duration|null

hasBreakDuration

clearBreakDuration

setBreakDuration

Sum of the duration of the breaks occurring during this transition, if any. Details about each break's start time and duration are stored in ShipmentRoute.breaks.

Parameter
Name Description
var Google\Protobuf\Duration
Returns
Type Description
$this

getWaitDuration

Time spent waiting during this transition. Wait duration corresponds to idle time and does not include break time. Also note that this wait time may be split into several non-contiguous intervals.

Returns
Type Description
Google\Protobuf\Duration|null

hasWaitDuration

clearWaitDuration

setWaitDuration

Time spent waiting during this transition. Wait duration corresponds to idle time and does not include break time. Also note that this wait time may be split into several non-contiguous intervals.

Parameter
Name Description
var Google\Protobuf\Duration
Returns
Type Description
$this

getTotalDuration

Total duration of the transition, provided for convenience. It is equal to:

  • next visit start_time (or vehicle_end_time if this is the last transition) - this transition's start_time;
  • if ShipmentRoute.has_traffic_infeasibilities is false, the following additionally holds: `total_duration = travel_duration + delay_duration
  • break_duration + wait_duration`.
Returns
Type Description
Google\Protobuf\Duration|null

hasTotalDuration

clearTotalDuration

setTotalDuration

Total duration of the transition, provided for convenience. It is equal to:

  • next visit start_time (or vehicle_end_time if this is the last transition) - this transition's start_time;
  • if ShipmentRoute.has_traffic_infeasibilities is false, the following additionally holds: `total_duration = travel_duration + delay_duration
  • break_duration + wait_duration`.
Parameter
Name Description
var Google\Protobuf\Duration
Returns
Type Description
$this

getStartTime

Start time of this transition.

Returns
Type Description
Google\Protobuf\Timestamp|null

hasStartTime

clearStartTime

setStartTime

Start time of this transition.

Parameter
Name Description
var Google\Protobuf\Timestamp
Returns
Type Description
$this

getRoutePolyline

The encoded polyline representation of the route followed during the transition.

This field is only populated if populate_transition_polylines is set to true.

Returns
Type Description
Google\Cloud\Optimization\V1\ShipmentRoute\EncodedPolyline|null

hasRoutePolyline

clearRoutePolyline

setRoutePolyline

The encoded polyline representation of the route followed during the transition.

This field is only populated if populate_transition_polylines is set to true.

Parameter
Name Description
var Google\Cloud\Optimization\V1\ShipmentRoute\EncodedPolyline
Returns
Type Description
$this

getVehicleLoads

Vehicle loads during this transition, for each type that either appears in this vehicle's Vehicle.load_limits, or that have non-zero Shipment.load_demands on some shipment performed on this route.

The loads during the first transition are the starting loads of the vehicle route. Then, after each visit, the visit's load_demands are either added or subtracted to get the next transition's loads, depending on whether the visit was a pickup or a delivery.

Returns
Type Description
Google\Protobuf\Internal\MapField

setVehicleLoads

Vehicle loads during this transition, for each type that either appears in this vehicle's Vehicle.load_limits, or that have non-zero Shipment.load_demands on some shipment performed on this route.

The loads during the first transition are the starting loads of the vehicle route. Then, after each visit, the visit's load_demands are either added or subtracted to get the next transition's loads, depending on whether the visit was a pickup or a delivery.

Parameter
Name Description
var array|Google\Protobuf\Internal\MapField
Returns
Type Description
$this

getLoads

Deprecated: Use Transition.vehicle_loads instead.

Returns
Type Description
Google\Protobuf\Internal\RepeatedField

setLoads

Deprecated: Use Transition.vehicle_loads instead.

Parameter
Name Description
var array<Google\Cloud\Optimization\V1\CapacityQuantity>
Returns
Type Description
$this