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 }, ...