Solicita valores localizados

Desarrolladores del Espacio Económico Europeo (EEE)

Si tu dirección de facturación se encuentra en el Espacio Económico Europeo, a partir del 8 de julio de 2025, se aplicarán las Condiciones del Servicio de Google Maps Platform para el EEE al uso que hagas de los Servicios. La funcionalidad varía según la región. Obtén más información.

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, la distancia y el sistema de unidades (métrico o imperial) del viaje. 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".

Nota: Obtienes dos valores para la duración esperada: duration usa el modelo de tráfico que especificas, y staticDuration 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.

Para solicitar valores localizados, sigue estos pasos:

1. Agrega el campo localizedValues a la propiedad fields de ComputeRoutesRequest.
2. De manera opcional, especifica el idioma y el sistema de unidades con las propiedades languageCode y units del objeto ComputeRoutesRequest.

Este es un ejemplo de solicitud de valores localizados:

const requestWithLocalizedValues = {
  origin: 'San Diego, CA',
  destination: 'Ensenada, MX',
  travelMode: 'DRIVING',
  language: 'es',
  units: google.maps.UnitSystem.METRIC,
  fields: ['path', 'localizedValues', 'distanceMeters', 'durationMillis'],
};
  

Si no especificas el idioma o el sistema de unidades, el método computeRoutes infiere las unidades de ubicación y distancia del 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.

Para leer valores localizados, usa route.localizedValues. Por ejemplo:

const localizedValues = route.localizedValues;
const distance = localizedValues.distanceMeters;
const duration = localizedValues.duration;
const durationStatic = localizedValues.staticDuration;