Ответы на запросы маршрутов

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

Этот продукт имеет устаревший статус. С октября 2026 г. Directions API (Legacy) нельзя будет включить для новых облачных проектов Google Cloud. Существующие проекты по-прежнему полностью поддерживаются. Чтобы получить доступ к новым функциям и повысить производительность, перейдите на Routes API.

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

Ответы Directions API возвращаются в формате, указанном в параметре output в пути запроса URL.

Ниже приведен пример HTTP-запроса, рассчитывающего маршрут из Чикаго (Иллинойс) в Лос-Анджелес (Калифорния) через две путевые точки в Джоплине (Миссури) и Оклахома-Сити (Оклахома).

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Los%20Angeles%2C%20CA
  &origin=Chicago%2C%20IL
  &waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Chicago%2C%20IL&destination=Los%20Angeles%2C%20CA&waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK&key=YOUR_API_KEY'

В примере выше запрашивается вывод в формате JSON. Также можно запросить вывод в формате XML. Чтобы посмотреть примеры ответов в форматах JSON и XML, выберите нужную вкладку ниже.

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ7cv00DwsDogRAMDACa2m4K8",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ69Pk6jdlyIcRDqM1KDY3Fpg",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgdL4flSKrYcRnTpP0XQSojM",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJE9on3F3HwoAR9AhGJW_fL-I",
        "types": ["locality", "political"],
      },
    ],
  "routes":
    [
      {
        "bounds":
          {
            "northeast": { "lat": 41.8781139, "lng": -87.6297872 },
            "southwest": { "lat": 34.0523525, "lng": -118.2435717 },
          },
        "copyrights": "Map data ©2022 Google, INEGI",
        "legs":
          [
            {
              "distance": { "text": "579 mi", "value": 932311 },
              "duration": { "text": "8 hours 48 mins", "value": 31653 },
              "end_address": "Joplin, MO, USA",
              "end_location": { "lat": 37.0842449, "lng": -94.513284 },
              "start_address": "Chicago, IL, USA",
              "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
              "steps":
                [
                  {
                    "distance": { "text": "443 ft", "value": 135 },
                    "duration": { "text": "1 min", "value": 24 },
                    "end_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "html_instructions": "Head <b>south</b> on <b>S Federal St</b> toward <b>W Van Buren St</b>",
                    "polyline": { "points": "eir~FdezuOdCEjBC" },
                    "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
                    "travel_mode": "DRIVING",
                  },
                  {
                    "distance": { "text": "269 ft", "value": 82 },
                    "duration": { "text": "1 min", "value": 20 },
                    "end_location": { "lat": 41.8768866, "lng": -87.63073 },
                    "html_instructions": "Turn <b>right</b> at the 1st cross street onto <b>W Van Buren St</b>",
                    "maneuver": "turn-right",
                    "polyline": { "points": "sar~FzdzuO@fC?|@" },
                    "start_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "travel_mode": "DRIVING",
                  },
                  // Additional steps omitted for brevity
                ],
              "traffic_speed_entry": [],
              "via_waypoint": [],
            },
            // Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity
          ],
        "overview_polyline":
          {
            "points": "eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)",
          },
        "summary": "I-55 S and I-44",
        "warnings": [],
        "waypoint_order": [0, 1],
      },
    ],
  "status": "OK",
}

XML

      
<DirectionsResponse>
 <status>OK</status>
 <route>
  <summary>I-55 S and I-44</summary>
  <leg>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8781139</lat>
     <lng>-87.6297872</lng>
    </start_location>
    <end_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </end_location>
    <polyline>
     <points>eir~FdezuOdCEjBC</points>
    </polyline>
    <duration>
     <value>24</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Head &lt;b&gt;south&lt;/b&gt; on &lt;b&gt;S Federal St&lt;/b&gt; toward &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>135</value>
     <text>443 ft</text>
    </distance>
   </step>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </start_location>
    <end_location>
     <lat>41.8768866</lat>
     <lng>-87.6307300</lng>
    </end_location>
    <polyline>
     <points>sar~FzdzuO@fC?|@</points>
    </polyline>
    <duration>
     <value>20</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Turn &lt;b&gt;right&lt;/b&gt; at the 1st cross street onto &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>82</value>
     <text>269 ft</text>
    </distance>
    <maneuver>turn-right</maneuver>
   </step>
   <!-- Additional steps omitted for brevity -->
   <duration>
    <value>31653</value>
    <text>8 hours 48 mins</text>
   </duration>
   <distance>
    <value>932311</value>
    <text>579 mi</text>
   </distance>
   <start_location>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </start_location>
   <end_location>
    <lat>37.0842449</lat>
    <lng>-94.5132840</lng>
   </end_location>
   <start_address>Chicago, IL, USA</start_address>
   <end_address>Joplin, MO, USA</end_address>
  </leg>
  <!-- Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity -->
  <copyrights>Map data ©2022 Google, INEGI</copyrights>
  <overview_polyline>
   <points>eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)</points>
  </overview_polyline>
  <waypoint_index>0</waypoint_index>
  <waypoint_index>1</waypoint_index>
  <bounds>
   <southwest>
    <lat>34.0523525</lat>
    <lng>-118.2435717</lng>
   </southwest>
   <northeast>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </northeast>
  </bounds>
 </route>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ7cv00DwsDogRAMDACa2m4K8</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ69Pk6jdlyIcRDqM1KDY3Fpg</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgdL4flSKrYcRnTpP0XQSojM</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJE9on3F3HwoAR9AhGJW_fL-I</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

Далее в документе будет использоваться синтаксис JSON. В большинстве случаев формат вывода не имеет значения для иллюстрации концепций или названий полей в документации. Однако обратите внимание на следующие различия:

  • Результаты XML заключены в корневой элемент <DirectionsResponse>.
  • В JSON записи с несколькими элементами обозначаются массивами во множественном числе (например, steps и legs), а в XML – несколькими элементами в единственном числе (например, <step> и <leg>).
  • В JSON порядок путевых точек обозначается полем waypoint_order, а в XML – отдельными элементами <waypoint_index>.
  • Пустые элементы обозначаются пустыми массивами в JSON, но отсутствием любого такого элемента в XML. Например, если результатов нет, то в ответе JSON будет пустой массив routes, а в ответе XML не будет элементов <route>.

DirectionsResponse

Поле Обязательно Тип Описание
Обязательно Массив<DirectionsRoute>

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

Подробную информацию можно найти в статье DirectionsRoute.
Обязательно DirectionsStatus

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

Подробную информацию можно найти в статье DirectionsStatus.
необязательно Массив<TravelMode>

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

Подробную информацию можно найти в разделе TravelMode.
необязательно string

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

необязательно Массив<DirectionsGeocodedWaypoint>

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

Эти сведения не будут представлены для путевых точек, указанных в виде текстовых значений широты и долготы, если сервис не возвращает результатов. Это связано с тем, что для таких путевых точек выполняется обратное геокодирование, чтобы получить их репрезентативный адрес только после того, как маршрут будет найден. В массиве geocoded_waypoints соответствующие места будут заняты пустым объектом JSON.

Подробную информацию можно найти в разделе DirectionsGeocodedWaypoint.

DirectionsRoute

Маршруты состоят из вложенных объектов legs и steps.

Поле Обязательно Тип Описание
Обязательно Границы

Содержит граничную рамку области просмотра overview_polyline.

Подробнее о границах…
Обязательно string

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

Обязательно Array<DirectionsLeg>

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

Подробную информацию можно найти в статье DirectionsLeg.
Обязательно DirectionsPolyline

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

Подробную информацию можно найти в разделе DirectionsPolyline.
Обязательно string

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

Обязательно Array<string>

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

Обязательно Массив целых чисел

Массив, определяющий порядок путевых точек на рассчитанном маршруте. Порядок путевых точек может быть изменен, если в запросе был передан параметр optimize:true.

необязательно Fare

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

Подробнее о тарифах…

Границы

Прямоугольник в географических координатах, заданный юго-западным и северо-восточным углами.

Поле Обязательно Тип Описание
Обязательно LatLngLiteral Подробную информацию можно найти в разделе LatLngLiteral.
Обязательно LatLngLiteral Подробную информацию можно найти в разделе LatLngLiteral.

LatLngLiteral

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

Поле Обязательно Тип Описание
Обязательно число

Широта в десятичных градусах
Обязательно число

Долгота в десятичных градусах

DirectionsLeg

Поле Обязательно Тип Описание
Обязательно string

Содержит удобочитаемый адрес (обычно улицу и номер дома), полученный в результате обратного геокодирования end_location этого отрезка. Этот текст должен отображаться "как есть", без дополнительной программной обработки.

Обязательно LatLngLiteral

Координаты широты и долготы конечной точки отрезка. Для расчета маршрута Directions API использует ближайшую к начальной и конечной точкам линию транспорта (обычно дорогу). Поэтому end_location может отличаться от указанной в запросе конечной точки отрезка (например, если дорога находится далеко от нее).

Подробную информацию можно найти в разделе LatLngLiteral.
Обязательно string

Содержит человекочитаемый адрес (обычно почтовый адрес), полученный в результате обратного геокодирования start_location этого этапа. Этот текст должен отображаться "как есть", без дополнительной программной обработки.

Обязательно LatLngLiteral

Широта и долгота исходной точки отрезка. Для расчета маршрута Directions API использует ближайшую к начальной и конечной точкам линию транспорта (обычно дорогу). Поэтому start_location может отличаться от указанной в запросе начальной точки отрезка (например, если дорога находится далеко от нее).

Подробную информацию можно найти в разделе LatLngLiteral.
Обязательно Массив<DirectionsStep>

Массив шагов, содержащий информацию о каждом отдельном шаге на этапе поездки.

Подробную информацию можно найти в статье DirectionsStep.

traffic_speed_entry

необязательно Массив<DirectionsTrafficSpeedEntry>

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

Подробную информацию можно найти в статье DirectionsTrafficSpeedEntry.

Обязательно Массив<DirectionsViaWaypoint>

Местоположения промежуточных путевых точек на этом отрезке.

Подробную информацию можно найти в разделе DirectionsViaWaypoint.

необязательно TimeZoneTextValueObject

Расчетное время прибытия в конечную точку этого участка. Это свойство возвращается только для маршрутов на общественном транспорте.

Дополнительную информацию можно найти в описании объекта TimeZoneTextValueObject.

необязательно TimeZoneTextValueObject

Содержит примерное время начала этого отрезка, указанное в виде объекта Time. departure_time доступно только для маршрутов на общественном транспорте.

Дополнительную информацию можно найти в описании объекта TimeZoneTextValueObject.

необязательно TextValueObject

Общее расстояние, покрываемое отрезком.

Подробнее TextValueObject…
необязательно TextValueObject

Общая длина этого отрезка.

Подробнее TextValueObject…
необязательно TextValueObject

Общая продолжительность поездки по отрезку. Это значение представляет собой расчетное время в пути с учетом текущей и статистической загруженности дорог. Параметр запроса traffic_model позволяет указать, какое значение вы хотите получить: оптимистичное, пессимистичное или наиболее вероятное. Продолжительность поездки с учетом трафика возвращается, только если соблюдены следующие условия:

  • Запрос не содержит промежуточных остановок Если запрос содержит путевые точки, добавьте к каждой из них префикс via:, чтобы построить по ним маршрут без остановок.
  • Запрашиваются автомобильные маршруты: для параметра mode установлено значение driving.
  • Запрос содержит параметр departure_time.
  • Сведения о загруженности дорог доступны для запрошенного маршрута.

Подробнее TextValueObject…

DirectionsStep

Каждый элемент в массиве steps определяет один шаг рассчитанного маршрута. Шаг – самая маленькая единица измерения маршрута, которая содержит одну подсказку по маршруту (например, "Поверните налево на 4-й улице"), а также данные о расстоянии и времени поездки, позволяющие сопоставить этот шаг со следующим. Например, для шага "Выезжайте на М-80" может быть указана длительность "37 миль" и "40 минут". Это означает, что следующий шаг наступит через 37 миль или 40 минут после этого шага.

При использовании Directions API для поиска маршрутов на общественном транспорте массив steps будет включать дополнительные сведения о маршруте на общественном транспорте в виде массива transit_details. Если используются разные способы передвижения, во внутренний массив steps включаются шаги для пеших и автомобильных участков. Например, это может быть пеший шаг маршрута с указанием начальной и конечной точек ("Следуйте от ул. Пограничная до пр. Пионерский"). В массиве inner steps содержатся подробные подсказки, такие как "Следуйте на северо-восток", "Поверните налево на ул. Мичурина", "Поверните налево в сторону ул. Тараса Шевченко".

Поле Обязательно Тип Описание
Обязательно TextValueObject

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

Подробнее TextValueObject…
Обязательно LatLngLiteral

Содержит местоположение последней точки этого шага.

Подробную информацию можно найти в разделе LatLngLiteral.
Обязательно string

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

Обязательно DirectionsPolyline

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

Подробную информацию можно найти в разделе DirectionsPolyline.
Обязательно LatLngLiteral

Содержит местоположение начальной точки этого шага.

Подробную информацию можно найти в разделе LatLngLiteral.
Обязательно TravelMode

Содержит тип используемого способа передвижения.

Подробную информацию можно найти в разделе TravelMode.
необязательно TextValueObject

Расстояние отрезка, соответствующее шагу. Если расстояние неизвестно, это поле может остаться без определения.

Подробнее TextValueObject…
необязательно string

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

The allowed values include: turn-slight-left, turn-sharp-left, turn-left, turn-slight-right, turn-sharp-right, keep-right, keep-left, uturn-left, uturn-right, turn-right, straight, ramp-left, ramp-right, merge, fork-left, fork-right, ferry, ferry-train, roundabout-left, and roundabout-right
необязательно

Содержит подробные подсказки для перемещения пешком или на общественном транспорте. Подшаги доступны, только если для параметра travel_mode задано значение transit. Внутренний массив steps имеет тот же тип, что и steps.

необязательно DirectionsTransitDetails

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

Подробную информацию можно найти в статье DirectionsTransitDetails.

TextValueObject

Объект, содержащий числовое значение и его форматированное текстовое представление.

Поле Обязательно Тип Описание

text

Обязательно string

Строковое значение.
Обязательно число

Числовое значение.

DirectionsPolyline

Кодирование ломаных линий – это алгоритм сжатия с потерями, который позволяет хранить последовательность координат в виде одной строки. Координаты точек кодируются с использованием подписанных значений. Если у вас есть только несколько статических точек, вы также можете использовать интерактивную утилиту кодирования ломаных линий.

В процессе кодирования двоичное значение преобразуется в последовательность кодов символов ASCII с помощью стандартной схемы кодирования base64. Чтобы обеспечить правильное отображение этих символов, к закодированным значениям прибавляется 63 (символ ASCII "?"), после чего они преобразуются в ASCII. Алгоритм также проверяет наличие дополнительных кодов символов для заданной точки, проверяя наименее значимый бит каждой группы байтов. Если этот бит равен 1, точка ещё не полностью сформирована и за ней должны следовать дополнительные данные.

Кроме того, для экономии места точки включают только смещение относительно предыдущей точки (за исключением, конечно, первой точки). Все точки кодируются в Base64 как целые числа со знаком, поскольку широта и долгота – это значения со знаком. Формат кодирования в ломаной линии должен представлять две координаты, обозначающие широту и долготу, с разумной точностью. Поскольку максимальная долгота составляет +/- 180 градусов с точностью до 5 знаков после запятой (от 180,00000 до -180,00000), для ее представления требуется 32-битное знаковое двоичное целое число.

Поле Обязательно Тип Описание
Обязательно string

Одна строка, представляющая ломаную линию.

TravelMode

  • DRIVING (по умолчанию) – расчет с использованием дорожной сети.
  • BICYCLING – запрашивает расчет маршрута по велосипедным дорожкам и улицам, где удобнее передвигаться на велосипеде (в регионах, где это возможно).
  • TRANSIT – запрашивает расчет маршрута на общественном транспорте (в регионах, где это возможно).
  • WALKING – запрашивает расчет пешего маршрута по пешеходным дорожкам и тротуарам (в регионах, где это возможно).

DirectionsTransitDetails

Дополнительная информация, не применимая к другим способам передвижения.

Поле Обязательно Тип Описание
необязательно DirectionsTransitStop

Остановка прибытия.

Подробную информацию можно найти в разделе DirectionsTransitStop.

необязательно TimeZoneTextValueObject Дополнительную информацию можно найти в описании объекта TimeZoneTextValueObject.
необязательно DirectionsTransitStop

Остановка отправления.

Подробную информацию можно найти в разделе DirectionsTransitStop.

необязательно TimeZoneTextValueObject Дополнительную информацию можно найти в описании объекта TimeZoneTextValueObject.
необязательно string

Направление линии общественного транспорта, в котором следует ехать (как указано на транспортном средстве или остановке). Обычно это конечная остановка маршрута.

необязательно Целое число

Частота отправления транспорта с этой остановки в секундах. Например, если значение headway равно 600, это означает, что следующий автобус придет через 10 минут.

необязательно DirectionsTransitLine

Содержит информацию о маршруте общественного транспорта на этом шаге.

Подробную информацию можно найти в статье DirectionsTransitLine.

необязательно Целое число

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

необязательно string

Текст, который пассажиры видят в расписаниях и на информационных табло. Текст должен однозначно идентифицировать поездку в течение дня обслуживания. Например, trip_short_name – это номер поезда Amtrak, который отправляется из Сан-Хосе (Калифорния) в Сакраменто (Калифорния) в 15:10 по будням.

DirectionsTransitStop

Поле Обязательно Тип Описание
Обязательно LatLngLiteral

Местоположение остановки.

Подробную информацию можно найти в разделе LatLngLiteral.
Обязательно string

Название остановки общественного транспорта.

TimeZoneTextValueObject

Объект, содержащий время в формате Unix, часовой пояс и его форматированное текстовое представление.

Поле Обязательно Тип Описание

text

Обязательно string

Время в виде строки в часовом поясе.
Обязательно string

Часовой пояс. Значение представляет собой название часового пояса, определенное в базе данных часовых поясов IANA (например, "America/New_York").

Обязательно число

Время, указанное в формате эпохи Unix, или количество секунд, прошедших с полуночи 1 января 1970 года по всемирному координированному времени.

DirectionsTransitLine

Поле Обязательно Тип Описание
Обязательно Array<DirectionsTransitAgency>

Транспортное агентство (или агентства), которое обслуживает этот маршрут.

Подробную информацию можно найти в описании класса DirectionsTransitAgency.

Обязательно string

Полное название маршрута, например "8 Avenue Local".
необязательно string

Цвет, которым обозначается этот маршрут.
необязательно string

URL значка этого маршрута.
необязательно string

Краткое название маршрута. Как правило, это номер маршрута, например 7 или 355.

text_color

необязательно string

Цвет, которым обозначается этот маршрут.
необязательно string

URL страницы маршрута, предоставленный транспортным агентством.
необязательно DirectionsTransitVehicle

Тип транспортного средства, которое используется на этом маршруте.

Дополнительную информацию можно найти в описании класса DirectionsTransitVehicle.

DirectionsTransitAgency

Поле Обязательно Тип Описание
необязательно string

Название транспортного агентства.
необязательно string

Номер телефона транспортного агентства.
необязательно string

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

DirectionsTransitVehicle

Поле Обязательно Тип Описание
Обязательно string

Название транспортного средства, написанное заглавными буквами.
Обязательно string

Тип транспортного средства.

  • BUS – автобусы
  • CABLE_CAR – канатная дорога (транспорт, обычно наземный, приводимый в движение с помощью троса). Воздушные канатные дороги могут относиться к типу GONDOLA_LIFT.
  • COMMUTER_TRAIN – электропоезда
  • FERRY – паромы
  • FUNICULAR – фуникулер (канатная дорога для подъема в гору, как правило, состоящая из двух вагонов, служащих противовесом друг другу)
  • GONDOLA_LIFT – воздушная канатная дорога.
  • HEAVY_RAIL – междугородний поезд,
  • HIGH_SPEED_TRAIN – скоростные поезда
  • INTERCITY_BUS – междугородние автобусы
  • LONG_DISTANCE_TRAIN – поезда дальнего следования
  • METRO_RAIL – легкорельсовый транспорт
  • MONORAIL – монорельсовый транспорт,
  • OTHER – все другие транспортные средства.
  • RAIL – железная дорога
  • SHARE_TAXI – маршрутное такси (автобус с возможностью посадки и высадки в любой точке маршрута).
  • SUBWAY – подземное легкое метро
  • TRAM – наземное легкое метро.
  • TROLLEYBUS – троллейбусы
The allowed values include: BUS, CABLE_CAR, COMMUTER_TRAIN, FERRY, FUNICULAR, GONDOLA_LIFT, HEAVY_RAIL, HIGH_SPEED_TRAIN, INTERCITY_BUS, LONG_DISTANCE_TRAIN, METRO_RAIL, MONORAIL, OTHER, RAIL, SHARE_TAXI, SUBWAY, TRAM, and TROLLEYBUS
необязательно string

Содержит URL значка, связанного с этим типом транспорта.
необязательно string

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

DirectionsTrafficSpeedEntry

Поле Обязательно Тип Описание
Обязательно число

Смещение вдоль пути (в метрах), до которого действительна эта категория скорости.
Обязательно string

Текущая загруженность дорог и скорость движения на этом участке пути.

DirectionsViaWaypoint

Поле Обязательно Тип Описание
необязательно LatLngLiteral

Местоположение путевой точки.

Подробную информацию можно найти в разделе LatLngLiteral.
необязательно Целое число

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

Положение путевой точки на ломаной линии шага, выраженное в виде коэффициента от 0 до 1.

Тариф

Общая стоимость билетов по маршруту.

{
  "currency" : "USD",
  "value" : 6,
  "text" : "$6.00"
}
Поле Обязательно Тип Описание
Обязательно string

Код валюты ISO 4217, в которой приведена стоимость проезда.

text

Обязательно string

общая стоимость проезда в формате запрошенного языка.
Обязательно число

Общая стоимость проезда в указанной валюте.

DirectionsStatus

Поле status в объекте ответа Directions содержит статус запроса и может содержать сведения для отладки, которые помогут вам выяснить, почему сервис Directions не работает. Поле статуса может принимать следующие значения:

  • OK – ответ содержит действительный результат.
  • NOT_FOUND – не удалось найти геокод как минимум для одного местоположения, указанного в запросе как пункт отправления, пункт назначения или путевая точка.
  • ZERO_RESULTS – между пунктом отправления и пунктом назначения не найдено ни одного маршрута.
  • MAX_WAYPOINTS_EXCEEDED – в запросе слишком много путевых точек. Для приложений, использующих Directions API в качестве веб-сервиса, или для сервиса Directions в Maps JavaScript API максимальное допустимое количество путевых точек равно 25 (без учета начальной и конечной точек).
  • MAX_ROUTE_LENGTH_EXCEEDED – запрос нельзя обработать: слишком длинный маршрут. Такая ошибка возникает, когда возвращается слишком сложный маршрут. Попробуйте сократить количество путевых точек, поворотов и инструкций.
  • INVALID_REQUEST – переданный запрос недействителен. Обычно это происходит из-за недопустимого параметра или значения параметра.
  • OVER_DAILY_LIMIT указывает на одно из следующих значений:
    • Ключ API отсутствует или недействителен.
    • В вашем аккаунте не включены платежные функции.
    • Превышено заданное ограничение на использование.
    • Указанный способ оплаты больше не действует (например, истек срок действия кредитной карты).
    Инструкции по устранению этой проблемы приведены в разделе часто задаваемых вопросов о Картах.
  • OVER_QUERY_LIMIT – сервис получил слишком много запросов от вашего приложения за промежуток времени.
  • REQUEST_DENIED – вашему приложению отказано в использовании сервиса Directions.
  • UNKNOWN_ERROR – обработка запроса маршрута невозможна из-за ошибки сервера. Если повторить попытку, запрос может оказаться успешным.

DirectionsGeocodedWaypoint

Поле Обязательно Тип Описание
необязательно string

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

The allowed values include: OK, and ZERO_RESULTS
необязательно

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

В большинстве случаев частичные совпадения возникают при использовании почтовых адресов, которые отсутствуют в местности, указанной в запросе. Частичные совпадения могут также возвращаться для запросов, в которых имеется соответствие нескольким местоположениям в пределах одной местности. Например, запрос "Воронеж, улица Лиз" вернет частично совпадающие результаты "улица Лизюкова" и "улица Лизы Чайкиной". Обратите внимание: если запрос содержит ошибки в написании адреса, сервис геокодирования может предложить альтернативный адрес. Такие предложения также будут помечены как частичные совпадения.

необязательно string

Уникальный идентификатор, который можно использовать и с другими API Google. Подробнее об идентификаторах мест…

необязательно Array<string>

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

  • administrative_area_level_1 – первый уровень национального административного деления. В США такими административными уровнями являются штаты. Эти административные уровни используются не во всех странах. В большинстве случаев краткие имена administrative_area_level_1 будут близко соответствовать подразделениям в стандарте ISO 3166-2 и других широко распространенных списках. Тем не менее, поскольку геокодирование зависят от разных сигналов и данных о местоположении, его результаты могут быть разными.
  • administrative_area_level_2 – второй уровень национального административного деления. В США такими административными уровнями являются округи. Эти административные уровни используются не во всех странах.
  • administrative_area_level_3 – третий уровень национального административного деления. Это малая единица гражданского деления. Эти административные уровни используются не во всех странах.
  • administrative_area_level_4 – четвертый уровень национального административного деления. Это малая единица гражданского деления. Эти административные уровни используются не во всех странах.
  • administrative_area_level_5 – пятый уровень национального административного деления. Это малая единица гражданского деления. Эти административные уровни используются не во всех странах.
  • airport – аэропорт.
  • colloquial_area указывает часто используемое альтернативное название объекта.
  • country указывает страну и обычно является типом наивысшего порядка, который возвращает геокодер.
  • intersection указывает крупный перекресток, как правило, двух крупных дорог.
  • locality – городская административная единица.
  • natural_feature – заметный природный объект.
  • neighborhood – район с собственным названием.
  • park – парк, имеющий название.
  • plus_code указывает код местоположения на основе широты и долготы. Коды Plus Code можно использовать в качестве замены почтовым адресам там, где эти адреса не существуют (здания не пронумерованы или улицам не присвоены названия). Подробную информацию можно найти на сайте https://plus.codes.
  • point_of_interest обозначает объект инфраструктуры, имеющий название. Как правило, эти POI являются крупными местными объектами, которые сложно отнести к другой категории, например "Эмпайр-стейт-билдинг" или "Эйфелева башня".
  • political указывает административную единицу. Чаще всего такой тип обозначает многоугольник, включающий местную административно-территориальную единицу.
  • postal_code указывает почтовый индекс в том виде, в котором он используется в стране для обработки почты.
  • premise указывает место с собственным названием, обычно строение или группу строений с общим именем.
  • route указывает шоссе с названием (например, "US 101").
  • street_address указывает точный почтовый адрес.
  • sublocality – первый уровень городского административного деления. Для некоторых местоположений можно получить один из дополнительных типов от sublocality_level_1 до sublocality_level_5. Каждый уровень ниже населенного пункта является гражданской единицей. Чем выше уровень, тем меньше охватываемая им географическая область.
  • subpremise указывает единицы, на которые делится предыдущая категория, обычно отдельные строения внутри групп строений с общим названием.
  • tourist_attraction – туристическая достопримечательность.
  • train_station – железнодорожная станция.
  • transit_station – остановка общественного транспорта.

Пустой список типов указывает, что для того или иного элемента адреса нет известных типов, например lieu-dit во Франции.