Google Maps Route Optimization V1 Client - Class TimeWindow (0.2.0)

Reference documentation and code samples for the Google Maps Route Optimization V1 Client class TimeWindow.

Time windows constrain the time of an event, such as the arrival time at a visit, or the start and end time of a vehicle.

Hard time window bounds, start_time and end_time, enforce the earliest and latest time of the event, such that start_time <= event_time <= end_time. The soft time window lower bound, soft_start_time, expresses a preference for the event to happen at or after soft_start_time by incurring a cost proportional to how long before soft_start_time the event occurs. The soft time window upper bound, soft_end_time, expresses a preference for the event to happen at or before soft_end_time by incurring a cost proportional to how long after soft_end_time the event occurs. start_time, end_time, soft_start_time and soft_end_time should be within the global time limits (see ShipmentModel.global_start_time and ShipmentModel.global_end_time) and should respect:

  0 <= `start_time` <= `end_time` and
  0 <= `start_time` <= `soft_start_time` and
  0 <= `soft_end_time` <= `end_time`.

Generated from protobuf message google.maps.routeoptimization.v1.TimeWindow

Namespace

Google \ Maps \ RouteOptimization \ V1

Methods

__construct

Constructor.

Parameters
Name Description
data array

Optional. Data for populating the Message object.

↳ start_time Google\Protobuf\Timestamp

The hard time window start time. If unspecified it will be set to ShipmentModel.global_start_time.

↳ end_time Google\Protobuf\Timestamp

The hard time window end time. If unspecified it will be set to ShipmentModel.global_end_time.

↳ soft_start_time Google\Protobuf\Timestamp

The soft start time of the time window.

↳ soft_end_time Google\Protobuf\Timestamp

The soft end time of the time window.

↳ cost_per_hour_before_soft_start_time float

A cost per hour added to other costs in the model if the event occurs before soft_start_time, computed as: max(0, soft_start_time - t.seconds) * cost_per_hour_before_soft_start_time / 3600, t being the time of the event. This cost must be positive, and the field can only be set if soft_start_time has been set.

↳ cost_per_hour_after_soft_end_time float

A cost per hour added to other costs in the model if the event occurs after soft_end_time, computed as: max(0, t.seconds - soft_end_time.seconds) * cost_per_hour_after_soft_end_time / 3600, t being the time of the event. This cost must be positive, and the field can only be set if soft_end_time has been set.

getStartTime

The hard time window start time. If unspecified it will be set to ShipmentModel.global_start_time.

Returns
Type Description
Google\Protobuf\Timestamp|null

hasStartTime

clearStartTime

setStartTime

The hard time window start time. If unspecified it will be set to ShipmentModel.global_start_time.

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

getEndTime

The hard time window end time. If unspecified it will be set to ShipmentModel.global_end_time.

Returns
Type Description
Google\Protobuf\Timestamp|null

hasEndTime

clearEndTime

setEndTime

The hard time window end time. If unspecified it will be set to ShipmentModel.global_end_time.

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

getSoftStartTime

The soft start time of the time window.

Returns
Type Description
Google\Protobuf\Timestamp|null

hasSoftStartTime

clearSoftStartTime

setSoftStartTime

The soft start time of the time window.

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

getSoftEndTime

The soft end time of the time window.

Returns
Type Description
Google\Protobuf\Timestamp|null

hasSoftEndTime

clearSoftEndTime

setSoftEndTime

The soft end time of the time window.

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

getCostPerHourBeforeSoftStartTime

A cost per hour added to other costs in the model if the event occurs before soft_start_time, computed as:

   max(0, soft_start_time - t.seconds)
                          * cost_per_hour_before_soft_start_time / 3600,
t being the time of the event.

This cost must be positive, and the field can only be set if soft_start_time has been set.

Returns
Type Description
float

hasCostPerHourBeforeSoftStartTime

clearCostPerHourBeforeSoftStartTime

setCostPerHourBeforeSoftStartTime

A cost per hour added to other costs in the model if the event occurs before soft_start_time, computed as:

   max(0, soft_start_time - t.seconds)
                          * cost_per_hour_before_soft_start_time / 3600,
t being the time of the event.

This cost must be positive, and the field can only be set if soft_start_time has been set.

Parameter
Name Description
var float
Returns
Type Description
$this

getCostPerHourAfterSoftEndTime

A cost per hour added to other costs in the model if the event occurs after soft_end_time, computed as:

   max(0, t.seconds - soft_end_time.seconds)
                    * cost_per_hour_after_soft_end_time / 3600,
t being the time of the event.

This cost must be positive, and the field can only be set if soft_end_time has been set.

Returns
Type Description
float

hasCostPerHourAfterSoftEndTime

clearCostPerHourAfterSoftEndTime

setCostPerHourAfterSoftEndTime

A cost per hour added to other costs in the model if the event occurs after soft_end_time, computed as:

   max(0, t.seconds - soft_end_time.seconds)
                    * cost_per_hour_after_soft_end_time / 3600,
t being the time of the event.

This cost must be positive, and the field can only be set if soft_end_time has been set.

Parameter
Name Description
var float
Returns
Type Description
$this