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

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

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

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

Вот пример того, что вы увидите для локализованных значений:

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

Если язык или система единиц не указаны, API определяет язык и единицы измерения следующим образом:

  • Метод ComputeRoutes определяет местоположение и единицы измерения расстояния на основе начальной точки маршрута. Таким образом, для запроса маршрутизации в США API определяет язык en-US и единицы IMPERIAL .
  • Метод ComputeRouteMatrix по умолчанию использует язык 'en-US' и метрические единицы измерения.

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

Для включения локализованных значений в ответ необходимо выполнить следующие действия:

  1. Укажите локализованные значения в маске поля. Например:

    ОТДЫХ

    -H X-Goog-FieldMask: routes.localizedValues

    РПК

    const (fieldMask = "routes.localizedValues")

  2. Если вам нужны локализованные значения на определенном языке или в определенной системе единиц, укажите код языка и систему единиц:

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

    Например, в этом фрагменте кода указан немецкий язык (de) и метрические единицы измерения:

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

    Для получения более подробной информации см. раздел «Языковая поддержка» .

Пример запроса 

curl -X POST -d '{
  "origin": { "location": {
    "latLng": { "latitude": 37.7873146, "longitude": -122.4159327 } }
  },
  "destination": { "location": {
    "latLng": { "latitude": 37.7621008, "longitude": -122.4382503 } }
  },
  "travelMode": "DRIVE",
  "computeAlternativeRoutes": true,
  "languageCode": "de",
  "units": "METRIC"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.localizedValues' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Пример ответа

В ответе возвращаются локализованные значения для полей distance , duration и staticDuration :

{
    "localizedValues": {
        "distance": {
            "text": "15,5 km"
         },
        "duration": {
            "text": "16 Minuten"
        },
        "staticDuration": {
            "text": "16 Minuten"
        }
    }
}