Solicita valores localizados

Los valores de respuesta localizados son un campo de respuesta adicional que proporciona texto localizado para los valores de parámetros que se muestran. Se proporciona texto localizado para la duración del viaje, la distancia y el sistema de unidades (métrico o anglosajón). Solicitas valores localizados con una máscara de campo y puedes especificar el idioma y el sistema de unidades, o bien usar los valores inferidos por la API. Para obtener más información, consulta LocalizedValues.

Por ejemplo, si especificas un código de idioma para alemán (de) y unidades imperiales, obtienes un valor de distanceMeters de 49889.7, pero también un texto localizado que proporciona esa medición de distancia en alemán y unidades imperiales, es decir, "31 Meile".

Este es un ejemplo de lo que verías para los valores localizados:

{ "localized_values":
  {
    "distance": { "text": "31,0 Meile/n" },
    "duration": { "text": 38 Minuten}.
    "static_duration": { "text": 36 Minuten}.
  }
}

Nota: Obtienes dos valores para la duración esperada: duration usa el modelo de tráfico que especificas y static_duration no tiene en cuenta el tráfico. Por lo tanto, si el modelo de tráfico solicitado es TRAFFIC_UNAWARE, estos tiempos son idénticos.

Si no especificas el idioma o el sistema de unidades, la API infiere el idioma y las unidades de la siguiente manera:

• El método ComputeRoutes infiere la ubicación y las unidades de distancia del punto de referencia de origen. Por lo tanto, para una solicitud de enrutamiento en EE.UU., la API infiere el idioma en-US y las unidades IMPERIAL.
• El método ComputeRouteMatrix usa de forma predeterminada el idioma "en-US" y las unidades métricas.

Cómo solicitar valores localizados

Para incluir valores localizados en la respuesta, debes hacer lo siguiente:

1. Solicita valores localizados en tu máscara de campo. Por ejemplo:

   REST

   -H X-Goog-FieldMask: routes.localized_values

   RPC

   const (fieldMask = "routes.localized_values")

2. Si deseas que los valores localizados se muestren en un idioma o sistema de unidades específico, especifica el código de idioma y el sistema de unidades:

   "languageCode": "language_code",
   "units": "METRIC | IMPERIAL",

   Para obtener más información, consulta Compatibilidad de idiomas.

   Por ejemplo, este fragmento de código especifica el idioma como alemán (de) y las unidades métricas:

   "languageCode": "de",
   "units": "METRIC",

Ejemplo de solicitud

curl -X POST -d '{
  "origin": { "location": {
    "latLng": { "latitude": 37.7873146, "longitude": -122.4159327 } }
  },
  "destination": { "location": {
    "latLng": { "latitude": 37.7621008, "longitude": -122.4382503 } }
  },
  "travelMode": "DRIVE",
  "computeAlternativeRoutes": true,
  "languageCode": "de",
  "units": "METRIC"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.localized_values' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Ejemplo de respuesta

La respuesta muestra valores localizados para los campos distance, duration y staticDuration:

{
    "localizedValues": {
        "distance": {
            "text": "15,5 km"
         },
        "duration": {
            "text": "16 Minuten"
        },
        "staticDuration": {
            "text": "16 Minuten"
        }
    }
}