To specify that a waypoint is a stop for a pickup or dropoff,
use the vehicleStopover
property of a waypoint,
Waypoint (REST) or
Waypoint (gRPC).
This setting ensures that the
calculated route won't begin or end on a road that is unsuitable for pickup and
drop-off such as a highway or tunnel.
Consider the situation where a surface road crosses over a road inside a tunnel. If you were to specify a waypoint located where the two roads intersect (as seen on a map), then the resulting route would begin or end on either the surface road or the tunnel. This result presents a problem because you can't stop in tunnels to make pickups or drop-offs.
If you want to use the waypoint for a pickup or drop-off, then you could set the
vehicleStopover
field to true
to ensure that the resulting route begins or
ends on a road that allows pickups and drop-offs.
The following example demonstrates how to set the
vehicleStopover
property:
{ "origin":{ "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0827784 } }, "vehicleStopover": true }, ... }