Class Shipment.Types.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).
Implements
Namespace: Google.Maps.RouteOptimization.V1
Assembly: Google.Maps.RouteOptimization.V1.dll
Syntax
public sealed class Shipment.Types.VisitRequest : IMessage<Shipment.Types.VisitRequest>, IEquatable<Shipment.Types.VisitRequest>, IDeepCloneable<Shipment.Types.VisitRequest>, IBufferMessage, IMessage
Constructors
VisitRequest()
Declaration
public VisitRequest()
VisitRequest(VisitRequest)
Declaration
public VisitRequest(Shipment.Types.VisitRequest other)
Parameters
Type | Name | Description |
---|---|---|
Shipment.Types.VisitRequest | other |
Properties
ArrivalLocation
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.
Declaration
public LatLng ArrivalLocation { get; set; }
Property Value
Type | Description |
---|---|
LatLng |
ArrivalWaypoint
The waypoint where the vehicle arrives when performing this
VisitRequest
. If the shipment model has duration distance matrices,
arrival_waypoint
must not be specified.
Declaration
public Waypoint ArrivalWaypoint { get; set; }
Property Value
Type | Description |
---|---|
Waypoint |
Cost
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.
Declaration
public double Cost { get; set; }
Property Value
Type | Description |
---|---|
double |
DepartureLocation
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.
Declaration
public LatLng DepartureLocation { get; set; }
Property Value
Type | Description |
---|---|
LatLng |
DepartureWaypoint
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.
Declaration
public Waypoint DepartureWaypoint { get; set; }
Property Value
Type | Description |
---|---|
Waypoint |
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
).
Declaration
public Duration Duration { get; set; }
Property Value
Type | Description |
---|---|
Duration |
Label
Specifies a label for this VisitRequest
. This label is reported in the
response as visit_label
in the corresponding
[ShipmentRoute.Visit][google.maps.routeoptimization.v1.ShipmentRoute.Visit].
Declaration
public string Label { get; set; }
Property Value
Type | Description |
---|---|
string |
LoadDemands
Load demands of this visit request. This is just like [Shipment.load_demands][google.maps.routeoptimization.v1.Shipment.load_demands] field, except that it only applies to this [VisitRequest][google.maps.routeoptimization.v1.Shipment.VisitRequest] instead of the whole [Shipment][google.maps.routeoptimization.v1.Shipment]. The demands listed here are added to the demands listed in [Shipment.load_demands][google.maps.routeoptimization.v1.Shipment.load_demands].
Declaration
public MapField<string, Shipment.Types.Load> LoadDemands { get; }
Property Value
Type | Description |
---|---|
MapField<string, Shipment.Types.Load> |
Tags
Specifies tags attached to the visit request. Empty or duplicate strings are not allowed.
Declaration
public RepeatedField<string> Tags { get; }
Property Value
Type | Description |
---|---|
RepeatedField<string> |
TimeWindows
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][google.maps.routeoptimization.v1.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.
Declaration
public RepeatedField<TimeWindow> TimeWindows { get; }
Property Value
Type | Description |
---|---|
RepeatedField<TimeWindow> |
VisitTypes
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][google.maps.routeoptimization.v1.Vehicle.extra_visit_duration_for_visit_type]).
A type can only appear once.
Declaration
public RepeatedField<string> VisitTypes { get; }
Property Value
Type | Description |
---|---|
RepeatedField<string> |