Especificar la orientación y el costado del camino del vehículo

Desarrolladores del Espacio Económico Europeo (EEE)

Los puntos de referencia pueden incluir modificadores de ubicación para cambiar la forma en que se calculan las rutas, incluidos los parámetros de configuración de heading y sideOfRoad.

Cómo especificar el rumbo del vehículo

Para definir un punto de referencia, debes especificar la ubicación geográfica (REST) o ubicación (gRPC) como un par de coordenadas de latitud y longitud.

La ubicación también te permite especificar la dirección en la que quieres que se dirija el vehículo cuando llegue a cada punto de referencia. Puedes usar esta función para garantizar que el vehículo llegue al mismo lado de la ruta que el consumidor que espera que lo recojan. Si no especificas una dirección, el vehículo puede llegar al lado equivocado de la ruta.

Los valores de dirección son números enteros que se alinean con las direcciones de la brújula y, por lo tanto, oscilan entre cero y 359. Por ejemplo, un valor de 0 indica una dirección de encabezado hacia el norte.

En el siguiente ejemplo, se muestra cómo establecer un heading para una parada.

{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      },
      "heading": 127
    }
  },
  ...

Cómo especificar una preferencia de lado de la ruta

Para representar una ubicación, crea un objeto Waypoint (REST) o Waypoint (gRPC). Una ubicación definida por un par de latitud y longitud puede corresponder a un lado específico de una ruta. Sin embargo, para admitir la optimización de rutas, una ruta puede establecer una parada en el lado opuesto de la ruta con respecto a la ubicación especificada.

Los puntos de referencia admiten la propiedad sideOfRoad, que indica que la ubicación del punto de referencia tiene una preferencia para que el vehículo se detenga en el mismo lado de la ruta que se especifica en la ubicación.

Especifica que la ruta usa el lado preferido de la ruta estableciendo la propiedad sideOfRoad de Waypoint en true. Luego, la ruta pasa por la ubicación para que el vehículo pueda detenerse al costado de la ruta hacia el que se inclina la ubicación.

En el siguiente ejemplo, se muestra cómo establecer sideOfRoad para un punto de referencia.

{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    },
    "sideOfRoad": true
  },
  ...