Solicitar valores localizados

Desenvolvedores do Espaço Econômico Europeu (EEE)

Se o endereço de faturamento estiver no Espaço Econômico Europeu, a partir de 8 de julho de 2025, os Termos de Serviço da Plataforma Google Maps para o EEE serão aplicáveis ao uso dos Serviços. A funcionalidade varia de acordo com a região. Saiba mais.

Os valores de resposta localizados são um campo de resposta adicional que fornece texto localizado para valores de parâmetros retornados. O texto localizado é fornecido para duração, distância e sistema de unidades (métrico ou imperial). Você solicita valores localizados usando uma máscara de campo e pode especificar o idioma e o sistema de unidades ou usar os valores inferidos pela API. Para mais detalhes, consulte LocalizedValues.

Por exemplo, se você especificar um código de idioma para alemão (de) e unidades imperiais, vai receber um valor para distanceMeters de 49889,7, mas também um texto localizado que fornece essa medição de distância em alemão e unidades imperiais, ou seja, "31 Meile".

Observação: você recebe dois valores para a duração esperada: duration usa o modelo de tráfego especificado, e staticDuration não considera o tráfego. Portanto, se o modelo de tráfego solicitado for TRAFFIC_UNAWARE, esses tempos serão idênticos.

Para solicitar valores localizados, siga os seguintes passos:

1. Adicione olocalizedValues campo para ofields propriedade doComputeRoutesRequest.
2. Opcionalmente, especifique o idioma e o sistema de unidades usando as propriedades languageCode e units do ComputeRoutesRequest.

Confira um exemplo de solicitação 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'],
};
  

Se você não especificar o idioma ou o sistema de unidades, o método computeRoutes vai inferir o local e as unidades de distância do ponto de referência de origem. Assim, para uma solicitação de rota nos EUA, a API infere o idioma en-US e as unidades IMPERIAL.

Para ler valores localizados, use route.localizedValues. Exemplo:

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