Cuando llamas al método ComputeRoutes(), debes especificar qué campos quieres que se muestren en la respuesta. Para ello, usa una máscara de campo de respuesta, que proporcionas con el parámetro de URL $fields o fields, o usa el encabezado HTTP/gRPC X-Goog-FieldMask. Para obtener más información, consulta Parámetros del sistema.
Máscara de campo
El valor de la máscara de campo es una lista de rutas de campo separadas por comas. Cada ruta de campo es una lista separada por puntos de nombres de campos que representan la jerarquía del mensaje. El nombre de un campo puede ser la clave de objeto JSON o el nombre de la etiqueta del campo de protobuf. La ruta del campo comienza desde el tipo de mensaje de respuesta de nivel superior y, opcionalmente, está seguida de uno o más puntos y, luego, del siguiente nivel de nombre de 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 de raíz.
Ejemplos
En el siguiente ejemplo, se muestra cómo configurar máscaras de campo para el método ComputeRoutes().
Ejemplo 1
Es una máscara de campo de todos los campos disponibles (para inspección manual).
X-Goog-FieldMask: *
Ejemplo 2
Es la máscara de campo que muestra la duración, la distancia y la polilínea a nivel de la ruta (un ejemplo de configuración de producción).
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline
No recomendamos el uso de la máscara de campo de respuesta comodín (*) ni especificar la máscara de campo en el nivel superior (rutas) en la producción. Selecciona solo los campos que necesitas:
Permite que nuestro servidor guarde ciclos de procesamiento, lo que nos permite mostrar tus resultados con una latencia más baja.
Garantiza un rendimiento de latencia estable. Es posible que agreguemos más campos de respuesta en el futuro, y es posible que esos campos nuevos requieran tiempo de procesamiento adicional. Si seleccionas todos los campos, o si seleccionas todos los campos de nivel superior, es posible que experimentes una degradación del rendimiento porque cualquier campo nuevo que agreguemos se incluirá automáticamente en tu respuesta.
Da como resultado un tamaño de respuesta más pequeño, lo que se traduce en una mayor capacidad de procesamiento de la red.
Para obtener más información sobre cómo construir rutas de campo, consulta field_mask.proto.