Ao determinar o melhor trajeto para uma viagem compartilhada, o trajeto mais rápido nem sempre é a melhor opção. Talvez você queira planejar seu trajeto.
A API Routes Preferred permite planejar um trajeto especificando um objetivo de trajeto usando o método ComputeCustomRoutes.
O método ComputeCustomRoutes também pode ajudar com a conformidade da rota, permitindo
minimizar a diferença entre a rota selecionada pelo operador e a
rota percorrida.
Use a API Routes Preferred e o SDK de navegação para aproveitar todos os benefícios do planejamento de rotas.
Ativar o método ComputeCustomRoutes
Antes de usar o método ComputeCustomRoutes no código, é necessário
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 de nomes de campos separados por ponto que representam a hierarquia da mensagem. Um nome de campo é a chave do objeto JSON ou o nome da tag de campo do protobuf. O caminho do campo começa no tipo de mensagem de resposta de nível superior e é seguido opcionalmente 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 curinga “*”, que seleciona todos os campos de nível raiz.
Confira mais informações em:
Para conferir exemplos de uso do método ComputeCustomRoutes, consulte
Exemplos de como calcular uma rota personalizada (Beta).
Como calcular as tarifas de pedágio
Para informações sobre como calcular as taxas de pedágio, consulte Calcular taxas de pedágio.
Para conferir exemplos de cálculo de tarifas de pedágio, consulte Exemplos de cálculo de uma rota personalizada.