Establece un punto para que pase una ruta

Desarrolladores del Espacio Económico Europeo (EEE)

Si tu dirección de facturación se encuentra en el Espacio Económico Europeo, a partir del 8 de julio de 2025, se aplicarán las Condiciones del Servicio de Google Maps Platform para el EEE al uso que hagas de los Servicios. La funcionalidad varía según la región. Obtén más información.

De forma predeterminada, los puntos de referencia intermedios se usan para detenerse a recoger y dejar pasajeros, pero también puedes especificar que un punto de referencia intermedio solo se use para pasar por él.

Una ruta que contiene un punto de referencia de origen, un punto de referencia intermedio de paso y un punto de referencia de destino contiene solo un tramo de ruta que conecta el origen y el destino, mientras pasa por el punto de referencia intermedio (llamado via).

Configura un punto de referencia intermedio para que sea un punto de referencia de paso. Para ello, establece la propiedad via del punto de referencia en true con la interfaz Waypoint.

La propiedad via es más eficaz cuando se crean rutas en respuesta a que el usuario arrastra los puntos de referencia en el mapa. Esto permite que el usuario vea cómo se verá la ruta final en tiempo real y ayuda a garantizar que los puntos de referencia se coloquen en ubicaciones accesibles para la biblioteca de Routes.

Advertencia: Si usas el campo via para evitar las paradas, las rutas serán estrictas en su interpretación del punto de referencia. Esta interpretación puede provocar desvíos significativos en la ruta o ZERO_RESULTS en el código de estado de la respuesta si la API de Maps JavaScript no puede crear una ruta que pase por ese punto.

Ejemplo de solicitud

En la siguiente solicitud de ejemplo, se muestra cómo marcar un punto de referencia intermedio como un punto de referencia de paso.

const routeRequestWithVia = {
  origin: '100 Moffett Blvd, Mountain View, CA 94043',
  destination: '1199 9th Ave, San Francisco, CA 94122',
  travelMode: 'DRIVING',
  intermediates: [
    {location: 'Half Moon Bay, CA', via: true} // Set the via property to true
  ],
  fields: ['path', 'legs'],
};

// Make the request.
const {routes, fallbackInfo, geocodingResults} = await Route.computeRoutes(routeRequestWithIntermediates);
  

Accede a los IDs de lugar de los puntos de referencia intermedios

Si especificas la ubicación de un origen, un destino o un punto de referencia intermedio como una cadena de dirección o como un Plus Code, la biblioteca de Routes intentará encontrar la ubicación más relevante que tenga un ID de lugar correspondiente. El array geocodingResults.intermediates de los resultados contiene el ID de lugar correspondiente a la ubicación de los puntos de referencia, junto con datos adicionales sobre la ubicación.

Nota: Si se especifica un punto de referencia como un ID de lugar o como coordenadas de latitud y longitud, se omite de los resultados de la búsqueda de ID de lugar.

Ejemplo de respuesta de resultados de geocodificación

{
  "origin": {
    "geocoderStatus": "OK",
    "types": [
      "premise",
      "street_address"
    ],
    "partialMatch": false,
    "placeId": "ChIJb5NgcTa3j4ARrfF4Oc_f6q8",
    "intermediateWaypointRequestIndex": null
  },
  "destination": {
    "geocoderStatus": "OK",
    "types": [
      "premise",
      "street_address"
    ],
    "partialMatch": false,
    "placeId": "ChIJAbIPLl2HhYARQ0SSdDFxU-s",
    "intermediateWaypointRequestIndex": null
  },
  "intermediates": [
    {
      "geocoderStatus": "OK",
      "types": [
        "locality",
        "political"
      ],
      "partialMatch": false,
      "placeId": "ChIJC8sZCqULj4ARVJvnNcic_V4",
      "intermediateWaypointRequestIndex": 0
    }
  ]
}