Cuando llamas al método ComputeRoutes(), debes especificar qué campos deseas 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 bien 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 separada por comas de rutas de campos. Cada ruta de campo es una lista de nombres de campos separados por puntos que representan la jerarquía del mensaje. Un nombre de campo es la clave del objeto JSON o el nombre de la etiqueta del campo de protobuf. La ruta de campo comienza con el tipo de mensaje de respuesta de nivel superior y, de manera opcional, le siguen uno o más puntos y, luego, el siguiente nivel del nombre del campo. En general, las rutas de campos 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.
Ejemplos
En el siguiente ejemplo, se muestra cómo establecer máscaras de campo para el método ComputeRoutes().
Ejemplo 1
Es la máscara de campo de todos los campos disponibles (para la inspección manual).
X-Goog-FieldMask: *
Ejemplo 2
Máscara de campo de 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
Desaconsejamos el uso de la máscara de campo de respuesta con comodín (*) o la especificación de la máscara de campo en el nivel superior (rutas) en producción. Selecciona solo los campos que necesitas:
Permite que nuestro servidor ahorre ciclos de procesamiento, lo que nos permite devolver 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 esos campos nuevos podrían requerir tiempo de procesamiento adicional. Si seleccionas todos los campos o todos los campos en el nivel superior, es posible que experimentes una degradación del rendimiento, ya que cualquier campo nuevo que agreguemos se incluirá automáticamente en tu respuesta.
Genera un tamaño de respuesta más pequeño, lo que se traduce en un mayor rendimiento de la red.
Para obtener más información sobre cómo construir rutas de campos, consulta field_mask.proto.