Ao chamar o método ComputeRoutes(), especifique quais campos você quer retornar na resposta. Para isso, use uma máscara de campo de resposta, fornecida com 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.
Máscara de campo
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 campos que representam a hierarquia da mensagem. Um nome de campo é a chave de 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 pode ser 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.
Exemplos
O exemplo a seguir demonstra como definir máscaras de campo para o
método ComputeRoutes().
Exemplo 1
Máscara de campo de todos os campos disponíveis (para inspeção manual).
X-Goog-FieldMask: *
Exemplo 2
Máscara de campo da duração, distância e polilinha no nível do trajeto (um exemplo de configuração de produção).
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline
Não é recomendável usar a máscara de campo de resposta com caractere curinga (*) ou especificar a máscara de campo no nível superior (rotas) na produção. Selecione apenas os campos necessários:
Permite que nosso servidor economize ciclos de processamento, o que nos permite retornar seus resultados com uma latência menor.
Garante um desempenho de latência estável. Podemos adicionar mais campos de resposta no futuro, e esses novos campos podem exigir tempo de computação extra. Se você selecionar todos os campos ou todos os campos no nível superior, poderá notar uma degradação do desempenho, porque qualquer novo campo adicionado será incluído automaticamente na sua resposta.
Resulta em um tamanho de resposta menor, o que se traduz em maior capacidade de rede.
Para mais informações sobre como construir caminhos de campo, consulte o field_mask.proto.