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

   RPC

   const (fieldMask = "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.