Routes Preferred APIis currently available only to select customers. Contact sales
to learn more.
Use the Vehicle Stop-over Qualifier
Stay organized with collections
Save and categorize content based on your preferences.
You can use the Vehicle Stop-over qualifier to specify that a waypoint is meant
to be used for stopping for picking-up or dropping-off. This ensures that the
calculated route won't begin or end on a road that is unsuitable for pickup and
drop-off (for example, a highway or tunnel).
Example use case
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 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, which ensures that the resulting route begins or ends
on a road that allows pickups and drop-offs (that is, on the surface road).
Example
The following example demonstrates how to set the vehicleStopover
qualifier.
{
"vehicleStopover"
:
true
,
"location"
:
{
"latLng"
:
{
"latitude"
:
37.419734
,
"longitude"
:-
122.0827784
}
}
}
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-09-04 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eThe Vehicle Stop-over qualifier ensures routes start and end at locations suitable for pickups and drop-offs, avoiding unsuitable roads like highways or tunnels.\u003c/p\u003e\n"],["\u003cp\u003eBy setting \u003ccode\u003evehicleStopover\u003c/code\u003e to true for a waypoint, the calculated route will prioritize accessible roads for pickup and drop-off points.\u003c/p\u003e\n"],["\u003cp\u003eThis feature is particularly useful when a waypoint is located near restricted areas like tunnels, ensuring the route directs to a safe and accessible nearby road.\u003c/p\u003e\n"]]],["The `vehicleStopover` qualifier designates a waypoint for pick-up or drop-off. Setting `vehicleStopover` to `true` ensures the route begins or ends on a suitable road, avoiding unsuitable locations like highways or tunnels. Without this, a waypoint at an intersection (e.g., surface road over a tunnel) could lead to a route beginning or ending in the tunnel. The example demonstrates setting `vehicleStopover` to `true` within a waypoint's definition.\n"],null,["# Use the Vehicle Stop-over Qualifier\n\nYou can use the Vehicle Stop-over qualifier to specify that a waypoint is meant\nto be used for stopping for picking-up or dropping-off. This ensures that the\ncalculated route won't begin or end on a road that is unsuitable for pickup and\ndrop-off (for example, a highway or tunnel).\n\nExample use case\n----------------\n\nConsider the situation where a surface road crosses over a road inside a tunnel.\nIf you were to specify a waypoint located where the two roads intersect (as seen\non a map), then the resulting route would begin or end on either the surface\nroad or the tunnel. This presents a problem because you can't stop in tunnels to\nmake pickups or drop-offs.\n\nIf you want to use the waypoint for a pickup or drop-off, then you could set the\n`vehicleStopover` field, which ensures that the resulting route begins or ends\non a road that allows pickups and drop-offs (that is, on the surface road).\n\nExample\n-------\n\nThe following example demonstrates how to set the\n[`vehicleStopover`](/maps/documentation/routes_preferred/reference/rest/v1alpha/TopLevel/computeRoutes#Waypoint.FIELDS.vehicle_stopover) qualifier. \n\n```cplint\n{\n \"vehicleStopover\": true,\n \"location\": {\n \"latLng\": {\n \"latitude\":37.419734,\n \"longitude\":-122.0827784\n }\n }\n}\n```"]]