Запрос локализованных значений

Разработчики Европейской экономической зоны (ЕЭЗ)

Локализованные значения ответа — это дополнительное поле ответа, которое предоставляет локализованный текст для возвращаемых значений параметров. Локализованный текст предоставляется для продолжительности поездки, расстояния и системы единиц измерения (метрической или имперской). Вы запрашиваете локализованные значения с помощью маски поля и можете либо указать язык и систему единиц измерения, либо использовать значения, выведенные API. Подробнее см. LocalizedValues .

Например, если указать код языка для немецкого языка (de) и имперских единиц, то для distanceMeters будет получено значение 49889,7, а также локализованный текст, предоставляющий измерение расстояния в немецких и имперских единицах, например «31 Meile».

Чтобы запросить локализованные значения, выполните следующие действия:

  1. Добавьте поле localizedValues ​​к свойству fields объекта ComputeRoutesRequest .
  2. При желании укажите язык и систему единиц измерения, используя свойства languageCode и units объекта ComputeRoutesRequest .

Вот пример запроса локализованных значений:

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

Если язык или система единиц измерения не указаны, метод computeRoutes вычисляет местоположение и единицы расстояния от исходной точки маршрута. Таким образом, для запроса маршрута в США API выводит язык en-US и единицы IMPERIAL .

Для чтения локализованных значений используйте route.localizedValues . Например:

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