Cuando determinas la mejor ruta para un viaje de uso compartido, la ruta más rápida no siempre es la mejor opción. Es posible que quieras planificar tu ruta.
La API de Routes Preferred te permite planificar una ruta especificando un objetivo de ruta con el método ComputeCustomRoutes.
El método ComputeCustomRoutes también puede ayudar con el cumplimiento de la ruta, ya que te permite minimizar la diferencia entre la ruta seleccionada por el operador y la ruta por la que se condujo.
Usa la API de Routes Preferred y el SDK de Navigation para aprovechar al máximo la planificación de rutas.
Habilita el método ComputeCustomRoutes
Antes de poder usar el método ComputeCustomRoutes en tu código, debes habilitarlo. Para obtener más información sobre cómo habilitar los métodos de la API de Routes Preferred, consulta Cómo comenzar.
Usa el método ComputeCustomRoutes
El método ComputeCustomRoutes requiere que especifiques una máscara de campo de respuesta en la entrada. Puedes proporcionar la máscara de campo de respuesta con el parámetro de URL $fields o fields, o bien con el encabezado HTTP/gRPC X-Goog-FieldMask. Para obtener más información, consulta Parámetros del sistema.
El valor de la máscara de campo es una lista de rutas de campos separadas por comas. Cada ruta de campo es una lista de nombres de campos separados por puntos que representan la jerarquía del mensaje. Un nombre de campo es la clave del objeto JSON o el nombre de la etiqueta del campo de protobuf. La ruta de acceso al campo comienza con el tipo de mensaje de respuesta de nivel superior y, de manera opcional, le siguen uno o más puntos y, luego, el siguiente nivel del nombre del campo. En general, las rutas de campos se construyen de la siguiente manera:
topLevelField[.secondLevelField][.thirdLevelField][...]
Una máscara de campo de caso especial es un comodín “*”, que selecciona todos los campos de nivel raíz.
Para obtener más información, consulte:
Para ver ejemplos del uso del método ComputeCustomRoutes, consulta Ejemplos de cómo calcular una ruta personalizada (beta).
Cómo calcular las tarifas de peaje
Para obtener información sobre cómo calcular las tarifas de peaje, consulta Cómo calcular las tarifas de peaje.
Para ver ejemplos de cómo calcular las tarifas de peaje, consulta Ejemplos de cálculo de rutas personalizadas.