Los waypoints pueden incluir modificadores de ubicación para cambiar la forma en que se calculan las rutas, incluida la configuración de heading
y sideOfRoad
.
Especifica el rumbo del vehículo
Para definir un punto de referencia, especificas la Location geográfica (REST) o la Location (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 garantizar que el vehículo llegue al mismo lado de la ruta que el consumidor que espera que lo recojan. Si no especificas un rumbo, el vehículo puede llegar al lado incorrecto de la ruta.
Los valores de rumbo son números enteros que se alinean con las direcciones de la brújula y, por lo tanto, varían de cero a 359. Por ejemplo, un valor de 0 indica una dirección de rumbo 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 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 aún puede establecer una parada en el lado opuesto de la ruta de 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 especifica la ubicación.
Para especificar que la ruta usa el lado preferido de la ruta, establece la propiedad sideOfRoad
del punto de referencia en 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 está sesgada 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 }, ...