Set intermediate waypoints

European Economic Area (EEA) developers

If your billing address is in the European Economic Area, effective on 8 July 2025, the Google Maps Platform EEA Terms of Service will apply to your use of the Services. Functionality varies by region. Learn more.

Intermediate waypoints are locations in between the origin and destination that you want the route to go through. An intermediate waypoint can be a stop or you can specify it as a location to pass through. For an example of a waypoint for a stop, see Set a stop along a route. For an example of a waypoint to pass-through, see Set a point for a route to pass through.

Note: Intermediate waypoints are not supported in the RouteMatrix.computeRouteMatrix method.

Use the intermediates property of the computeRoutes method to define up to a maximum of 25 intermediate waypoints.

Note: If you make requests using 11 or more intermediate waypoints (between 11 and 25), your requests are billed at a higher rate. Learn more about billing for Routes API.

For each intermediate waypoint in the request, a new leg is added to the route.

Example request

The following example shows how to set an intermediate waypoint. The example uses the intermediates property of the computeRoutes request to define an intermediate waypoint.

const routeRequestWithIntermediates = {
  origin: 'Mountain View, CA',
  destination: 'San Francisco, CA',
  travelMode: 'DRIVING',
  intermediates: [{location: 'San Mateo, CA'}, {location: 'Half Moon Bay, CA'}],
  fields: ['path', 'legs'],
};