Actualmente, la
API de Routes Preferred está disponible solo para clientes seleccionados.
Comunícate con Ventas para obtener más información.
Elige los campos que quieres mostrar
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Cuando llames 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 de nombres de campos separados por puntos que representan la jerarquía de mensajes. Un nombre de campo es la clave del objeto JSON o el nombre de la etiqueta del campo de protobuf. La ruta de acceso del campo comienza en el tipo de mensaje de respuesta de nivel superior y, de manera opcional, se le agregan uno o más puntos y, luego, el siguiente nivel del nombre del 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 a 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 el polilinea 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 de comodín (*) ni especificar 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 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 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 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.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2024-11-23 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2024-11-23 (UTC)"],[[["\u003cp\u003eWhen calling the \u003ccode\u003eComputeRoutes()\u003c/code\u003e method, specify desired response fields using a field mask with the \u003ccode\u003e$fields\u003c/code\u003e URL parameter, \u003ccode\u003efields\u003c/code\u003e URL parameter, or \u003ccode\u003eX-Goog-FieldMask\u003c/code\u003e HTTP/gRPC header.\u003c/p\u003e\n"],["\u003cp\u003eConstruct field masks as comma-separated lists of dot-separated field paths representing the message hierarchy starting from the top-level response.\u003c/p\u003e\n"],["\u003cp\u003eFor production, avoid using wildcard field masks or selecting all top-level fields to improve performance, ensure stable latency, and reduce response size.\u003c/p\u003e\n"],["\u003cp\u003eSelecting specific fields instead of all fields minimizes server processing, safeguards against potential performance degradation from future response field additions, and enhances network throughput.\u003c/p\u003e\n"]]],["To specify which fields to return from the `ComputeRoutes()` method, use a response field mask via the `$fields`, `fields` URL parameter, or the `X-Goog-FieldMask` header. Field masks use comma-separated field paths, formatted as `topLevelField[.secondLevelField]`. Avoid the wildcard `*` or top-level `routes` in production. Instead, specify needed fields, like `routes.duration,routes.distanceMeters,routes.polyline`, to reduce latency, ensure stable performance, and decrease response size.\n"],null,["# Choose Fields to Return\n\nWhen you call the `ComputeRoutes()` method, you must specify which fields you\nwant returned in the response. You do it by using a response field mask, which\nyou provide with the URL parameter `$fields` or `fields`, or by using the\nHTTP/gRPC header `X-Goog-FieldMask`. For more information, see\n[System Parameters](https://cloud.google.com/apis/docs/system-parameters).\n\nField mask\n----------\n\nThe field mask value is a comma-separated list of field paths. Each field path\nis a dot-separated list of field names that represent the message hierarchy. A\nfield name is either the JSON object key, or the protobuf field tag name. The\nfield path starts from the top level response message type, and is optionally\nfollowed by one or more dots, and then the next level of field name. In general,\nfield paths are constructed in the following way: \n\n```\ntopLevelField[.secondLevelField][.thirdLevelField][...]\n```\n\nA special case field mask is a wildcard \"\\*\", which selects all root-level\nfields.\n\nExamples\n--------\n\nThe following example demonstrates how to set field masks for the\n`ComputeRoutes()` method.\n\n### Example 1\n\nField mask of all available fields (for manual inspection). \n\n```\nX-Goog-FieldMask: *\n```\n\n### Example 2\n\nField mask of Route-level duration, distance, and polyline (an example production setup). \n\n```\nX-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline\n```\n\nWe discourage the use of the wildcard (\\*) response field mask, or specifying\nthe field mask at the top level (routes) in production. Selecting just the\nfields that you need:\n\n- Allows our server to save processing cycles, which allows us to return your\n results with a lower latency.\n\n- Ensures stable latency performance. We might add more response fields in the\n future, and those new fields might require extra computation time. If you select\n all fields, or if you select all fields at top level, you might experience\n performance degradation because any new field that we add will be automatically\n included in your response.\n\n- Results in a smaller response size, which translates into higher network\n throughput.\n\nFor more information about how to construct field paths, see the\n[field_mask.proto](https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto)."]]
