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 vão se aplicar 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âmetro retornados. O texto localizado é fornecido para duração da viagem, 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 de 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".

Confira um exemplo do que você vai encontrar para valores localizados:

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

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

Se você não especificar o idioma ou o sistema de unidades, a API vai inferir o idioma e as unidades da seguinte maneira:

• O método ComputeRoutes infere o local e as unidades de distância do ponto de passagem de origem. Assim, para uma solicitação de roteamento nos EUA, a API infere a linguagem en-US e as unidades IMPERIAL.
• O método ComputeRouteMatrix usa o idioma "en-US" e as unidades MÉTRICAS como padrão.

Para solicitar valores localizados

Para incluir valores localizados na resposta, faça o seguinte:

1. Solicite valores localizados na máscara de campo. Exemplo:

   REST

   -H X-Goog-FieldMask: localizedValues

   RPC

   const (fieldMask = "localizedValues")

2. Se você quiser os valores localizados em um idioma ou sistema de unidades específico, especifique o código do idioma e o sistema de unidades:

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

   Por exemplo, este snippet de código especifica o idioma como alemão (de) e unidades métricas:

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

   Para mais informações, consulte Suporte a idiomas.