Quando você está determinando o melhor trajeto para uma viagem de transporte por aplicativo, o trajeto mais rápido nem sempre é a melhor opção. Convém planejar seu trajeto.
Com a API Routes Preferred, você pode planejar uma rota especificando um objetivo usando o método ComputeCustomRoutes.
O método ComputeCustomRoutes também pode ajudar na conformidade do trajeto, permitindo minimizar a diferença entre o trajeto selecionado pelo operador e o trajeto percorrido.
Use a API Routes Preferred e o SDK do Navigation para aproveitar ao máximo o planejamento de rotas.
Ativar o método ComputeCustomRoutes
Antes de usar o método ComputeCustomRoutes no seu código, você precisa
ativá-lo. Para mais informações sobre como ativar os métodos da API Routes Preferred, consulte Primeiros passos.
Usar o método ComputeCustomRoutes.
O método ComputeCustomRoutes exige que você especifique uma máscara de campo de
resposta na entrada. É possível fornecer a máscara de campo de resposta usando
o parâmetro de URL $fields ou fields ou o cabeçalho HTTP/gRPC
X-Goog-FieldMask. Para mais informações, consulte Parâmetros do sistema.
O valor da máscara de campo é uma lista separada por vírgulas de caminhos de campo. Cada caminho de campo é uma lista separada por pontos de nomes de campo que representam a hierarquia de mensagens. Um nome de campo é a chave do objeto JSON ou o nome da tag de campo protobuf. O caminho do campo começa no tipo de mensagem de resposta de nível superior e é opcionalmente seguido por um ou mais pontos e, em seguida, pelo próximo nível do nome do campo. Em geral, os caminhos de campo são construídos da seguinte maneira:
topLevelField[.secondLevelField][.thirdLevelField][...]
Uma máscara de campo de caso especial é um caractere curinga "*", que seleciona todos os campos no nível da raiz.
Confira mais informações:
Para ver exemplos de uso do método ComputeCustomRoutes, consulte Como calcular uma rota personalizada (Beta).
Calculando tarifas de pedágio
Para informações sobre como calcular taxas de pedágio, consulte Calcular tarifas de pedágio.
Para ver exemplos de cálculo de tarifas de pedágio, consulte Como calcular exemplos de rota personalizada.