Cuando llamas al método ComputeRoutes()
, debes especificar qué campos
que quieres que se muestre en la respuesta. Lo haces usando una máscara de campo de respuesta, que
proporciones con el parámetro de URL $fields
o fields
, o bien
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 las rutas de campo. La ruta de cada campo es una lista separada por puntos de nombres de campos que representan la jerarquía de los mensajes. R el nombre de campo es la clave del objeto JSON o el nombre de la etiqueta del campo protobuf. El la ruta de acceso del campo comienza en el tipo de mensaje de respuesta de nivel superior y, de forma opcional, seguido de uno o más puntos, y luego el 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 niveles .
Ejemplos
En el siguiente ejemplo, se muestra cómo configurar máscaras de campo para la
ComputeRoutes()
.
Ejemplo 1
Es la máscara de campo de todos los campos disponibles (para la inspección manual).
X-Goog-FieldMask: *
Ejemplo 2
Es la 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
No se recomienda el uso de la máscara de campo de respuesta comodín (*) ni si se especifica la máscara de campo en el nivel superior (rutas) en producción. Seleccionar solo campos que necesitas:
Permite que nuestro servidor guarde ciclos de procesamiento, lo que nos permite devolverte tu con menor latencia.
Garantiza un rendimiento de latencia estable. Podríamos agregar más campos de respuesta en la en el futuro, y esos campos nuevos podrían requerir tiempo de procesamiento adicional. Si seleccionas todos los campos o, si seleccionas todos los campos en el nivel superior, es posible que degradación del rendimiento, ya que cualquier campo nuevo que agreguemos incluido en tu respuesta.
Da como resultado un tamaño de respuesta más pequeño, lo que se traduce en una mayor de procesamiento.
Para obtener más información sobre cómo construir rutas de campo, consulta la field_mask.proto.