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

Los puntos de referencia pueden incluir modificadores de ubicación para cambiar cómo se calculan las rutas, incluida la configuración de heading y sideOfRoad.

Especifica la orientación del vehículo

Para definir un punto de referencia, especifica la ubicación geográfica (REST) o la 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 deseas que el vehículo se dirija cuando llegue a cada punto de referencia. Puedes usar esta función para asegurarte de que el vehículo llegue al mismo lado de la ruta que el consumidor que espera a que lo recojan. Si no especificas una orientación, el vehículo puede llegar por el lado equivocado de la ruta.

Los valores de orientación son números enteros que se alinean con la dirección de la brújula y, por lo tanto, varían de cero a 359. Por ejemplo, el valor 0 indica una orientación hacia el norte.

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

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

Especifica un lado de la preferencia de ruta

Para representar una ubicación, debes crear un objeto de punto de referencia (REST) o punto de referencia (gRPC). Una ubicación definida por un par de latitud y longitud puede corresponder a un lado específico de una ruta. Sin embargo, a fin de admitir la optimización de rutas, una ruta aún puede establecer una parada para que se encuentre en el lado opuesto de la ruta respecto de la ubicación especificada.

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

Para especificar que la ruta utiliza el lado preferido de la ruta, configura la propiedad sideOfRoad del punto de referencia como true. Luego, la ruta pasa por la ubicación para que el vehículo pueda detenerse en el lado de la ruta hacia el que se orienta la ubicación.

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

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