Cuando estás determinando la mejor ruta para un viaje compartido, es posible que la ruta más rápida no siempre sea la mejor opción. Puede ser conveniente 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 ayudarte con el cumplimiento de la ruta, ya que te permite minimizar la diferencia entre la ruta seleccionada por el operador y la ruta conducida.
Usa la API de Routes Preferred y el SDK de Navigation para aprovechar al máximo los beneficios de 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 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 separada por comas de las rutas de campo. Cada ruta de campo es una lista separada por puntos de nombres de campo que representan la jerarquía de los mensajes. Un nombre de campo es la clave de objeto JSON o el nombre de la etiqueta de campo de protobuf. La ruta de acceso del campo comienza en el tipo de mensaje de respuesta de nivel superior y, opcionalmente, va seguida de uno o más puntos y, luego, el siguiente nivel de nombre del campo. En general, las rutas de campo 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, consulta:
Para ver ejemplos del uso del método ComputeCustomRoutes, consulta Calcula ejemplos de rutas personalizadas (Beta).
Cómo calcular las tarifas de peaje
Para obtener información sobre cómo calcular las tarifas de peaje, consulta Calcula las tarifas de peajes.
Para ver ejemplos de cómo calcular las tarifas de peaje, consulta Cómo calcular ejemplos de rutas personalizadas.