Solicita valores localizados

Desarrolladores del Espacio Económico Europeo (EEE)

Los valores de respuesta localizados son un campo de respuesta adicional que proporciona texto localizado para los valores de parámetros devueltos. Se proporciona texto localizado para la duración del viaje, la distancia y el sistema de unidades (métrico o imperial). Puedes solicitar valores localizados con una máscara de campo y especificar el idioma y el sistema de unidades, o bien usar los valores que infiere la API. Para obtener más detalles, consulta LocalizedValues.

Por ejemplo, si especificas un código de idioma para alemán (de) y unidades imperiales, obtendrás un valor para distanceMeters de 49889.7, pero también texto localizado que proporciona esa medición de distancia en alemán y unidades imperiales, por lo que se mostrará "31 millas".

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}.
  }
}

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 las unidades de ubicación y distancia desde el punto de referencia de origen. Por lo tanto, para una solicitud de rutas 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.localizedValues

    RPC

    const (fieldMask = "routes.localizedValues")

  2. Si deseas los valores localizados 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",

    Por ejemplo, este fragmento de código especifica el idioma como alemán (de) y las unidades MÉTRICAS:

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

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

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.localizedValues' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Ejemplo de respuesta

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

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