Method: computeRoutes

{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string
}

enum ( RouteLabel )

Метки для Route , которые полезны для определения конкретных свойств маршрута для сравнения с другими.

object ( RouteLeg )

Набор участков (сегментов пути между путевыми точками), составляющих маршрут. Каждый этап соответствует поездке между двумя via Waypoints . Например, маршрут без промежуточных путевых точек имеет только один этап. Маршрут, включающий одну via путевую точку, не являющуюся промежуточной, имеет два этапа. Маршрут, который включает в себя один маршрут via промежуточную путевую точку, имеет один этап. Порядок этапов соответствует порядку путевых точек от origin к intermediates destination .

integer

Протяженность маршрута, в метрах.

string ( Duration format)

Время, необходимое для прохождения маршрута. Если вы установите для routingPreference значение TRAFFIC_UNAWARE , то это значение будет таким же, как staticDuration . Если для routingPreference установлено значение TRAFFIC_AWARE или TRAFFIC_AWARE_OPTIMAL , это значение рассчитывается с учетом условий трафика.

Длительность в секундах, содержащая до девяти дробных цифр, заканчивающаяся на « s ». Пример: "3.5s" .

string ( Duration format)

Продолжительность проезда по маршруту без учета условий движения.

Длительность в секундах, содержащая до девяти дробных цифр, заканчивающаяся на « s ». Пример: "3.5s" .

object ( Polyline )

Общая полилиния маршрута. Эта полилиния представляет собой комбинированную полилинию всех legs .

string

Описание маршрута.

string

Массив предупреждений для отображения при отображении маршрута.

object ( Viewport )

Ограничивающая рамка области просмотра полилинии.

object ( RouteTravelAdvisory )

Дополнительная информация о маршруте.

integer

Если вы установите для параметра optimizeWaypointOrder значение true, это поле будет содержать оптимизированный порядок промежуточных путевых точек. В противном случае это поле пустое. Например, если вы вводите Origin: LA; Промежуточные путевые точки: Даллас, Бангор, Феникс; Пункт назначения: Нью-Йорк; а оптимизированный порядок промежуточных путевых точек — Феникс, Даллас, Бангор, то это поле содержит значения [2, 0, 1]. Индекс начинается с 0 для первой промежуточной путевой точки, предоставленной во входных данных.

object ( RouteLocalizedValues )

Текстовые представления свойств Route .

string

Веб-безопасный токен маршрута в кодировке base64, который можно передать в пакет SDK для навигации, который позволяет пакету навигации для навигации реконструировать маршрут во время навигации и, в случае изменения маршрута, соблюдать исходное намерение при создании маршрута путем вызова v2.computeRoutes. Клиенты должны рассматривать этот токен как непрозрачный большой двоичный объект. Он не предназначен для чтения или изменения. ПРИМЕЧАНИЕ. Route.route_token доступен только для запросов, в которых для ComputeRoutesRequest.routing_preference задано значение TRAFFIC_AWARE или TRAFFIC_AWARE_OPTIMAL . Route.route_token не поддерживается для запросов с путевыми точками Via.

{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}

integer

Протяженность участка маршрута, в метрах.

string ( Duration format)

Продолжительность времени, необходимого для прохождения ноги. Если для route_preference установлено значение TRAFFIC_UNAWARE , то это значение совпадает со staticDuration . Если route_preference имеет значение TRAFFIC_AWARE или TRAFFIC_AWARE_OPTIMAL , то это значение рассчитывается с учетом условий трафика.

Длительность в секундах, содержащая до девяти дробных цифр, заканчивающаяся на « s ». Пример: "3.5s" .

string ( Duration format)

Продолжительность проезда по этапу, рассчитанная без учета условий движения.

Длительность в секундах, содержащая до девяти дробных цифр, заканчивающаяся на « s ». Пример: "3.5s" .

object ( Polyline )

Общая полилиния для этого отрезка, включающая полилинию каждого step .

object ( Location )

Место начала этого этапа. Это местоположение может отличаться от указанного origin . Например, если исходная origin не находится рядом с дорогой, это точка на дороге.

object ( Location )

Конечное место этой ноги. Это местоположение может отличаться от указанного destination . Например, если указанный destination находится не рядом с дорогой, это точка на дороге.

object ( RouteLegStep )

Массив шагов, обозначающих сегменты в пределах этой ветви. Каждый шаг представляет собой одну инструкцию навигации.

object ( RouteLegTravelAdvisory )

Содержит дополнительную информацию, о которой должен быть проинформирован пользователь, например, возможные ограничения зоны движения на участке маршрута.

object ( RouteLegLocalizedValues )

Текстовые представления свойств RouteLeg .

object ( StepsOverview )

Обзорная информация о шагах в этом RouteLeg . Это поле заполняется только для ТРАНЗИТНЫХ маршрутов.

{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of list of possible types for union field polyline_type.
}

string

Строковое кодирование полилинии с использованием алгоритма кодирования полилинии

object ( Struct format)

Задает полилинию, используя формат GeoJSON LineString.

{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}

integer

Расстояние прохождения этого шага в метрах. В некоторых случаях это поле может не иметь значения.

string ( Duration format)

Продолжительность проезда через этот этап без учета условий движения. В некоторых случаях это поле может не иметь значения.

Длительность в секундах, содержащая до девяти дробных цифр, заканчивающаяся на « s ». Пример: "3.5s" .

object ( Polyline )

Полилиния, связанная с этим шагом.

object ( Location )

Место начала этого шага.

object ( Location )

Место окончания этого шага.

object ( NavigationInstruction )

Инструкции по навигации.

object ( RouteLegStepTravelAdvisory )

Содержит дополнительную информацию, о которой должен быть проинформирован пользователь, например, возможные ограничения зоны движения на шаге ноги.

object ( RouteLegStepLocalizedValues )

Текстовые представления свойств RouteLegStep .

object ( RouteLegStepTransitDetails )

Подробности, относящиеся к этому шагу, если выбран режим передвижения TRANSIT .

enum ( RouteTravelMode )

Режим движения, используемый для этого шага.

{
  "maneuver": enum (Maneuver),
  "instructions": string
}

enum ( Maneuver )

Инкапсулирует навигационные инструкции для текущего шага (например, повернуть налево, объединиться, прямо и т. д.). Это поле определяет, какой значок отображать.

string

Инструкции по прохождению этого шага.

{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}

object ( SpeedReadingInterval )

ПРИМЕЧАНИЕ. В настоящее время это поле не заполнено.

{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}

object ( LocalizedText )

Пройденное расстояние представлено в текстовой форме.

object ( LocalizedText )

Продолжительность без учета условий движения, представленная в текстовом виде.

{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}

object ( TransitStopDetails )

Информация о прибытии и отправлении остановок для шага.

object ( TransitDetailsLocalizedValues )

Текстовые представления свойств RouteLegStepTransitDetails .

string

Указывает направление движения по этой линии, отмеченное на транспортном средстве или на остановке отправления. Направление часто является конечной станцией.

string ( Duration format)

Указывает ожидаемое время как продолжительность между отправлениями с одной и той же остановки в это время. Например, при значении интервала в секундах, равном 600, вы ожидаете десятиминутное ожидание, если опоздаете на автобус.

Длительность в секундах, содержащая до девяти дробных цифр, заканчивающаяся на « s ». Пример: "3.5s" .

object ( TransitLine )

Информация о транзитной линии, используемой на этом этапе.

integer

Количество остановок от отправления до остановки прибытия. Этот подсчет включает остановку прибытия, но не включает остановку отправления. Например, если ваш маршрут отправляется с остановки A, проходит через остановки B и C и прибывает на остановку D, stopCount вернет 3.

string

Текст, который появляется в расписании и на вывесках для обозначения транзитной поездки для пассажиров. Текст должен однозначно идентифицировать поездку в течение служебного дня. Например, «538» — это tripShortText поезда Amtrak, который отправляется из Сан-Хосе, Калифорния, в 15:10 по будням в Сакраменто, Калифорния.

{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}

object ( TransitStop )

Информация об остановке прибытия на этап.

string ( Timestamp format)

Расчетное время прибытия на шаг.

Временная метка в формате RFC3339 UTC "Zulu" с разрешением в наносекунды и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

object ( TransitStop )

Информация об остановке отправления на ступень.

string ( Timestamp format)

Расчетное время выхода на этап.

Временная метка в формате RFC3339 UTC "Zulu" с разрешением в наносекунды и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

{
  "name": string,
  "location": {
    object (Location)
  }
}

string

Название транзитной остановки.

object ( Location )

Расположение остановки, выраженное в координатах широта/долгота.

{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}

object ( LocalizedTime )

Время в форматированном текстовом представлении с соответствующим часовым поясом.

object ( LocalizedTime )

Время в форматированном текстовом представлении с соответствующим часовым поясом.

{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}

object ( LocalizedText )

Время, указанное в виде строки в заданном часовом поясе.

string

Содержит часовой пояс. Значение представляет собой название часового пояса, определенное в базе данных часовых поясов IANA , например, «Америка/Нью-Йорк».

{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}

object ( TransitAgency )

Транзитное агентство (или агентства), которое управляет этой транзитной линией.

string

Полное название этой линии общественного транспорта, например, «8 Avenue Local».

string

URI для этой транзитной линии, предоставленный транспортным агентством.

string

Цвет, обычно используемый в вывесках для этой линии. Представлено в шестнадцатеричном формате.

string

URI значка, связанного с этой строкой.

string

Краткое название этой транзитной линии. Обычно это имя представляет собой номер строки, например «M7» или «355».

string

Цвет, обычно используемый в тексте на вывесках для этой строки. Представлено в шестнадцатеричном формате.

object ( TransitVehicle )

Тип транспортного средства, которое работает на этой транзитной линии.

{
  "name": string,
  "phoneNumber": string,
  "uri": string
}

string

Название этого транзитного агентства.

string

Отформатированный номер телефона транспортного агентства в определенном формате.

string

URI транспортного агентства.

{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}

object ( LocalizedText )

Название этого автомобиля с большой буквы.

enum ( TransitVehicleType )

Тип используемого транспортного средства.

string

URI значка, связанного с этим типом транспортного средства.

string

URI значка, связанного с этим типом транспортного средства, на основе вывесок местного транспорта.

{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}

object ( TollInfo )

Содержит информацию о платных проездах по конкретному RouteLeg . Это поле заполняется только в том случае, если мы ожидаем, что на RouteLeg есть дорожные сборы. Если это поле установлено, но подполе предполагаемая цена не заполнено, мы ожидаем, что дорога содержит плату за проезд, но мы не знаем расчетной цены. Если это поле не существует, то на RouteLeg плата не взимается.

object ( SpeedReadingInterval )

Интервалы скорочтения с подробным описанием плотности трафика. Применимо в случае настроек маршрутизации TRAFFIC_AWARE и TRAFFIC_AWARE_OPTIMAL . Интервалы охватывают всю полилинию RouteLeg без перекрытия. Начальная точка указанного интервала совпадает с конечной точкой предыдущего интервала.

Пример:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speedReadingIntervals: [A,C), [C,D), [D,G).

{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}

object ( LocalizedText )

Пройденное расстояние представлено в текстовой форме.

object ( LocalizedText )

Продолжительность с учетом условий движения представлена ​​в текстовом виде. Примечание. Если вы не запрашивали информацию о трафике, это значение будет таким же, как staticDuration.

object ( LocalizedText )

Продолжительность без учета условий движения, представленная в текстовом виде.

{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}

object ( MultiModalSegment )

Обобщенная информация о различных мультимодальных сегментах RouteLeg.steps . Это поле не заполняется, если RouteLeg не содержит мультимодальных сегментов в шагах.

{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}

object ( NavigationInstruction )

NavigationInstruction для мультимодального сегмента.

enum ( RouteTravelMode )

Режим движения мультимодального сегмента.

integer

Соответствующий индекс RouteLegStep , который является началом мультимодального сегмента.

integer

Соответствующий индекс RouteLegStep , являющийся концом мультимодального сегмента.

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object ( LatLng )

Необходимый. Нижняя точка окна просмотра.

object ( LatLng )

Необходимый. Верхняя точка смотрового окна.

{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}

object ( LocalizedText )

Пройденное расстояние представлено в текстовой форме.

object ( LocalizedText )

Продолжительность с учетом дорожных условий, представленная в текстовом виде. Примечание. Если вы не запрашивали информацию о трафике, это значение будет таким же, как staticDuration.

object ( LocalizedText )

Продолжительность без учета условий движения, представленная в текстовом виде.

object ( LocalizedText )

Транзитный тариф представлен в текстовом виде.

{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}

object ( GeocodedWaypoint )

Исходная геокодированная путевая точка.

object ( GeocodedWaypoint )

Геокодированная путевая точка назначения.

object ( GeocodedWaypoint )

Список промежуточных геокодированных путевых точек, каждая из которых содержит поле индекса, соответствующее отсчитываемому от нуля положению путевой точки в том порядке, в котором они были указаны в запросе.

{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}

object ( Status )

Указывает код состояния, полученный в результате операции геокодирования.

string

Тип(ы) результата в виде нуля или более тегов типа. Поддерживаемые типы: https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types .

boolean

Указывает, что геокодер не вернул точное совпадение с исходным запросом, хотя смог сопоставить часть запрошенного адреса. Вы можете проверить первоначальный запрос на наличие опечаток и/или неполного адреса.

string

Идентификатор места для этого результата.

integer

Индекс соответствующей промежуточной путевой точки в запросе. Заполняется только в том случае, если соответствующая путевая точка является промежуточной путевой точкой.