Примеры маршрутов

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

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

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

Следующий запрос возвращает маршрут от Торонто (Онтарио) до Монреаля (Квебек).

URL

https://maps.googleapis.com/maps/api/directions/json?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&key=YOUR_API_KEY'

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

URL

https://maps.googleapis.com/maps/api/directions/json
  ?avoid=highways
  &destination=Montreal
  &mode=bicycling
  &origin=Toronto
  &key=YOUR_API_KEYYOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&avoid=highways&mode=bicycling&key=YOUR_API_KEY'YOUR_API_KEY'

В следующем запросе выполняется поиск маршрута на общественном транспорте из Бруклина в Квинс (Нью-Йорк). В запросе не указан параметр departure_time, поэтому в качестве времени отправления по умолчанию используется текущее время:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Queens
  &mode=transit
  &origin=Brooklyn
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Brooklyn&destination=Queens&mode=transit&keyYOUR_API_KEY'

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

Примечание. В этом примере время отправления указано как 30 июля 2012 г. в 09:45. Чтобы избежать ошибки, перед отправкой запроса необходимо изменить параметр на время в будущем.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?departure_time=1343641500
  &destination=Queens
  &mode=transit
  &origin=Brooklyn
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Brooklyn&destination=Queens&mode=transit&departure_time=1343641500&key=YOUR_API_KEY'

В следующем запросе используются коды Plus Code, чтобы получить маршрут от H8MW+WP до GCG2+3M в Калькутте (Индия).

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=GCG2%2B3M%20Kolkata%20India
  &origin=H8MW%2BWP%20Kolkata%20India
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=H8MW%2BWP%20Kolkata%20India&destination=GCG2%2B3M%20Kolkata%20India&key=YOUR_API_KEY'

Следующий запрос возвращает маршрут из Глазго (Великобритания) в Перт (Великобритания) с использованием идентификаторов мест.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=place_id%3AChIJA01I-8YVhkgRGJb0fW4UX7Y
  &origin=place_id%3AChIJ685WIFYViEgRHlHvBbiD5nE
  &keyYOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=place_id%3AChIJ685WIFYViEgRHlHvBbiD5nE&destination=place_id%3AChIJA01I-8YVhkgRGJb0fW4UX7Y&key=YOUR_API_KEY'

Способы передвижения

При расчете маршрутов можно указать желаемый способ передвижения (mode). По умолчанию маршруты рассчитываются для driving. Поддерживаются следующие способы передвижения:

  • driving (по умолчанию) – запрашивает стандартный маршрут для автомобиля.
  • walking – запрашивает пеший маршрут по пешеходным дорожкам и тротуарам (в регионах, где это возможно).
  • bicycling запрашивает велосипедный маршрут по велосипедным дорожкам и предпочтительным улицам (где это возможно).
  • transit – запрашивает маршрут на общественном транспорте (в регионах, где это возможно). Если вы задали режим transit, то можете указать departure_time или arrival_time. Если не указано ни одно из значений, то для departure_time по умолчанию используется текущее время (то есть время отправления по умолчанию равно текущему времени). Вы также можете добавить свойства transit_mode и/или transit_routing_preference.

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

Информация о пробках

Информация о загруженности дорог считается используемой, когда соблюдаются все следующие условия (именно они позволяют получить поле duration_in_traffic в ответе от Directions):

  • Параметр mode для способа передвижения имеет значение driving или не указан (driving является значением по умолчанию).
  • Запрос содержит допустимое значение параметра departure_time. Для departure_time можно задать текущее время или произвольное время в будущем. Время в прошлом указать нельзя.
  • Запрос не содержит промежуточных путевых точек для остановок. Если запрос содержит путевые точки, добавьте к каждой из них префикс via:, чтобы построить по ним маршрут без остановок. Пример: 
    &waypoints=via:San Francisco|via:Mountain View|...

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

Следующий URL инициирует запрос маршрута из Бостона (Массачусетс) в Конкорд (Массачусетс) через Чарльзтаун и Лексингтон. Запрос включает время отправления и соответствует всем требованиям для возврата поля duration_in_traffic в ответе Directions API.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?departure_time=now
  &destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA&departure_time=now&key=YOUR_API_KEY'

Путевые точки

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

Укажите местоположения в параметре waypoints.

Вы можете указать одно или несколько местоположений, разделенных вертикальной чертой (| или %7C), в виде идентификатора места, адреса или координат широты и долготы. По умолчанию маршрут прокладывается через путевые точки в том порядке, в котором они указаны. Приоритет при обработке значения путевой точки: идентификатор места, координаты широты и долготы, адрес.

  • Если вы передаете идентификатор места, перед ним нужно указать префикс place_id:. Идентификаторы мест можно получить от Geocoding API и Places API (включая автозаполнение мест). Пример использования идентификаторов мест из сервиса автозаполнения мест можно найти в документе Автозаполнение мест и маршруты. Подробнее об идентификаторах мест…

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

  • Если вы передаете координаты широты и долготы, значения отправляются непосредственно на сервер внешнего интерфейса для расчета маршрутов без геокодирования. Точки привязываются к дорогам и могут не обеспечивать точность, необходимую для вашего приложения. Используйте координаты, если вы уверены, что значения действительно указывают точки, необходимые вашему приложению для маршрутизации, без учета возможных точек доступа или дополнительных сведений о геокодировании. Убедитесь, что значения широты и долготы разделены запятой (%2C), а не пробелом (%20).
  • Если вы передадите адрес, сервис Directions геокодирует строку и преобразует ее в координаты широты и долготы, чтобы рассчитать маршрут. Если адрес неоднозначен, может быть выполнен поиск, чтобы отличить его от похожих адресов. Например, "1-я улица" может быть полным значением или частью значения "1-я улица, СВ" или "1-я улица, ЮВ". Этот результат может отличаться от возвращаемого Geocoding API. Использование идентификаторов мест позволяет избежать возможных ошибок. Подробнее об устранении неполадок с результатами запроса маршрута…

Вы также можете указать закодированный набор точек, используя алгоритм кодированной ломаной линии. Закодированный набор полезен при большом количестве путевых точек, поскольку URL-адрес значительно короче. Для всех веб-сервисов действует ограничение на длину URL – 16 384 символа.

  • Закодированные ломаные линии должны начинаться с префикса enc:, за которым следует двоеточие (:). Пример: waypoints=enc:gfo}EtohhU:.
  • Вы также можете включить несколько закодированных ломаных линий, разделенных вертикальной чертой (|). Пример: waypoints=via:enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:| via:enc:udymA{~bxM:.

Следующий URL инициирует запрос маршрута между Бостоном и Конкордом (штат Массачусетс) с остановками в Чарльстауне и Лексингтоне (в указанном порядке). В примере используются адреса:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA&key=YOUR_API_KEY'

Как влиять на маршруты с помощью остановок и транзитных точек

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

Если вы хотите повлиять на маршрут с помощью путевых точек, не добавляя остановку, добавьте к путевой точке префикс via:. Путевые точки с префиксом via: не добавляются в массив legs, но маршрут проходит через них.

В следующем URL предыдущий запрос изменен так, что маршрут проходит через Лексингтон без остановки:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=Charlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=Charlestown%2CMA%7Cvia%3ALexington%2CMA&key=YOUR_API_KEY'

Префикс via: наиболее эффективен при создании маршрутов в ответ на перетаскивание пользователем путевых точек на карте. Это позволяет пользователю увидеть, как может выглядеть окончательный маршрут в режиме реального времени, и помогает убедиться, что путевые точки размещены в местах, доступных для Directions API (Legacy).

Следующий URL-адрес запрашивает промежуточные точки, используя координаты широты и долготы:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=via%3A-37.81223%2C144.96254%7Cvia%3A-34.92788%2C138.60008
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=via%3A-37.81223%2C144.96254%7Cvia%3A-34.92788%2C138.60008&key=YOUR_API_KEY'

Ниже приведен тот же запрос с использованием кодированной ломаной линии:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=via%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=via%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A&key=YOUR_API_KEY'

Обратите внимание, что спецификатор via: можно свободно комбинировать с модификаторами местоположения. Пример:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=side_of_road%3Avia%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=side_of_road%3Avia%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A&key=YOUR_API_KEY'

Оптимизация промежуточных точек

По умолчанию маршрут прокладывается через путевые точки в том порядке, в котором они указаны. Также вы можете использовать параметр optimize:true в качестве первого аргумента в запросе waypoints, чтобы сервис Directions мог оптимизировать маршрут, поменяв очередность путевых точек. (Эта оптимизация является практическим примером решения задачи коммивояжера.) Время в пути является главным критерием оптимизации, но могут учитываться также расстояние, количество поворотов и прочие факторы. Для оптимизации маршрута сервисом Directions все путевые точки должны быть остановками.

Если дать указание сервису Directions оптимизировать порядок путевых точек, их последовательность будет показана в поле waypoint_order объекта routes. Поле waypoint_order возвращает значения, отсчет которых начинается с нуля.

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

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Adelaide%2C%20SA
  &origin=Adelaide%2C%20SA
  &waypoints=optimize%3Atrue%7CBarossa%20Valley%2C%20SA%7CClare%2C%20SA%7CConnawarra%2C%20SA%7CMcLaren%20Vale%2C%20SA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Adelaide%2C%20SA&destination=Adelaide%2C%20SA&waypoints=optimize%3Atrue%7CBarossa%20Valley%2C%20SA%7CClare%2C%20SA%7CConnawarra%2C%20SA%7CMcLaren%20Vale%2C%20SA&key=YOUR_API_KEY'

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

"waypoint_order": [ 3, 2, 0, 1 ]

Ограничения

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

  • avoid=tolls
  • avoid=highways
  • avoid=ferries

Чтобы построить маршрут без платных дорог, автомагистралей и паромов, передайте в параметр avoid все три ограничения. Пример: avoid=tolls|highways|ferries.

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

Системы единиц

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

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

  • metric – определяет использование метрической системы. Для маршрутов, заданных текстовой строкой, результаты указываются в километрах и метрах.
  • imperial – определяет использование британской системы Для маршрутов, заданных текстовой строкой, результаты указываются в милях и футах.

Примечание. Этот параметр влияет только на text, отображаемый в полях distance. Поля distance также содержат values, которые всегда выражаются в метрах.

Привязка к региону

Вы можете настроить сервис Directions так, чтобы результаты возвращались с предпочтением определенного региона. Для этого служит параметр region. Этот параметр принимает двухсимвольный аргумент ccTLD (национальный домен верхнего уровня), указывающий на приоритет региона. Большинство кодов ccTLD совпадают с кодами ISO 3166-1 alpha-2, однако имеются некоторые исключения. Например, ccTLD Великобритании – uk (.co.uk), а код ISO 3166-1 – gb (технически относится к Соединенному Королевству Великобритании и Северной Ирландии). Список поддерживаемых регионов приведен в статье Доступность сервисов платформы Google Карт.

Вы можете использовать любой домен, в котором в основном приложении Google Карт запущены маршруты.

Например, запрос маршрута от Толедо до Мадрида возвращает правильные результаты, если для параметра region задано значение es, а Толедо интерпретируется как город в Испании:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Madrid
  &origin=Toledo
  &region=es
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toledo&destination=Madrid®ion=es&key=YOUR_API_KEY'

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ8f21C60Lag0R_q11auhbf8Y",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgTwKgJcpQg0RaSKMYcHeNsQ",
        "types": ["locality", "political"],
      },
    ],
  "routes":
    [
      {
        "bounds":
          {
            "northeast": { "lat": 40.4165207, "lng": -3.7026134 },
            "southwest": { "lat": 39.862808, "lng": -4.029406799999999 },
          },
        "copyrights": "Map data ©2022 Inst. Geogr. Nacional",
        "legs":
          [
            {
              "distance": { "text": "74.3 km", "value": 74327 },
              "duration": { "text": "57 mins", "value": 3446 },
              "end_address": "Madrid, Spain",
              "end_location": { "lat": 40.4165207, "lng": -3.705076 },
              "start_address": "Toledo, Spain",
              "start_location": { "lat": 39.862808, "lng": -4.0273727 },
              "steps":
                [
                  {
                    "distance": { "text": "0.6 km", "value": 615 },
                    "duration": { "text": "2 mins", "value": 106 },
                    "end_location":
                      { "lat": 39.8681019, "lng": -4.029378299999999 },
                    "html_instructions": "Head <b>northwest</b> on <b>Av. de la Reconquista</b> toward <b>C. de la Diputación</b>",
                    "polyline":
                      {
                        "points": "quhrF`rqWCBQJUJm@PQFg@Ni@JeBh@}@XaD|@{@Vk@Ns@RUFoA^u@R_AXwA`@WHMBG@C?E?GAC?IC",
                      },
                    "start_location": { "lat": 39.862808, "lng": -4.0273727 },
                    "travel_mode": "DRIVING",
                  },
                  // Additional steps omitted for brevity
                ],
              "traffic_speed_entry": [],
              "via_waypoint": [],
            },
          ],
        "overview_polyline":
          {
            "points": "quhrF`rqWcHzBaNzDeG~A][?k@lA{Dr@mBR]HmA[WQDWE[g@mAeE... (truncated for brevity)",
          },
        "summary": "A-42",
        "warnings": [],
        "waypoint_order": [],
      },
    ],
  "status": "OK",
}

XML

      
<DirectionsResponse>
 <status>OK</status>
 <route>
  <summary>A-42</summary>
  <leg>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>39.8628080</lat>
     <lng>-4.0273727</lng>
    </start_location>
    <end_location>
     <lat>39.8681019</lat>
     <lng>-4.0293783</lng>
    </end_location>
    <polyline>
     <points>quhrF`rqWCBQJUJm@PQFg@Ni@JeBh@}@XaD|@{@Vk@Ns@RUFoA^u@R_AXwA`@WHMBG@C?E?GAC?IC</points>
    </polyline>
    <duration>
     <value>106</value>
     <text>2 mins</text>
    </duration>
    <html_instructions>Head &lt;b&gt;northwest&lt;/b&gt; on &lt;b&gt;Av. de la Reconquista&lt;/b&gt; toward &lt;b&gt;C. de la Diputación&lt;/b&gt;</html_instructions>
    <distance>
     <value>615</value>
     <text>0.6 km</text>
    </distance>
   </step>
   <!-- Additional steps omitted for brevity -->
   <duration>
    <value>3446</value>
    <text>57 mins</text>
   </duration>
   <distance>
    <value>74327</value>
    <text>74.3 km</text>
   </distance>
   <start_location>
    <lat>39.8628080</lat>
    <lng>-4.0273727</lng>
   </start_location>
   <end_location>
    <lat>40.4165207</lat>
    <lng>-3.7050760</lng>
   </end_location>
   <start_address>Toledo, Spain</start_address>
   <end_address>Madrid, Spain</end_address>
  </leg>
  <copyrights>Map data ©2022 Inst. Geogr. Nacional</copyrights>
  <overview_polyline>
   <points>quhrF`rqWcHzBaNzDeG~A][?k@lA{Dr@mBR]HmA[WQDWE[g@mAeE... (truncated for brevity)</points>
  </overview_polyline>
  <bounds>
   <southwest>
    <lat>39.8628080</lat>
    <lng>-4.0294068</lng>
   </southwest>
   <northeast>
    <lat>40.4165207</lat>
    <lng>-3.7026134</lng>
   </northeast>
  </bounds>
 </route>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ8f21C60Lag0R_q11auhbf8Y</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgTwKgJcpQg0RaSKMYcHeNsQ</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

Запрос маршрута от Толедо до Мадрида, отправленный без параметра region, не возвращает результатов, поскольку Толедо интерпретируется как город в Огайо, а не в Испании:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Madrid
  &origin=Toledo
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toledo&destination=Madrid&key=YOUR_API_KEY'

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJeU4e_C2HO4gRRcM6RZ_IPHw",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgTwKgJcpQg0RaSKMYcHeNsQ",
        "types": ["locality", "political"],
      },
    ],
  "routes": [],
  "status": "ZERO_RESULTS",
}

XML

      
<DirectionsResponse>
 <status>ZERO_RESULTS</status>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJeU4e_C2HO4gRRcM6RZ_IPHw</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgTwKgJcpQg0RaSKMYcHeNsQ</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

Модификаторы местоположения

Вы можете использовать модификаторы местоположения, чтобы указать, как водители должны подъезжать к определенному месту. Для этого используйте параметр side_of_road, чтобы указать, какую сторону дороги использовать, или укажите заголовок, чтобы указать правильное направление движения. Эти модификаторы можно свободно комбинировать с модификатором via: для промежуточных путевых точек.

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

При указании путевой точки вы можете запросить, чтобы маршрут проходил по той стороне дороги, к которой смещена путевая точка, используя префикс side_of_road:. Например, в ответ на этот запрос будет возвращен длинный маршрут, чтобы транспортное средство оказалось на той стороне дороги, к которой была привязана путевая точка:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=side_of_road%3A37.7663444%2C-122.4412006
  &origin=37.7680296%2C-122.4375126
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=37.7680296%2C-122.4375126&destination=side_of_road%3A37.7663444%2C-122.4412006&key=YOUR_API_KEY'

При использовании side_of_road: с закодированными ломаными линиями параметр применяется к каждому местоположению вдоль ломаной линии.

Модификатор side_of_road: можно использовать только со следующими ограничениями:

Как указать, что маршруты должны иметь определенное направление

При указании путевой точки вы можете запросить, чтобы маршрут проходил через нее в определенном направлении. Это направление указывается с помощью префикса heading=X:, где X – целое число от 0 (включительно) до 360 (исключительно). Значение 0 соответствует северу, 90 – востоку и т. д. по часовой стрелке. Например, в этом запросе маршрут идет на восток от пункта отправления, а затем разворачивается:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=37.773245%2C-122.469502
  &origin=heading%3D90%3A37.773279%2C-122.468780
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=heading%3D90%3A37.773279%2C-122.468780&destination=37.773245%2C-122.469502&key=YOUR_API_KEY'

Модификатор heading=X: можно использовать только со следующими ограничениями:

  • Параметр mode для способа передвижения имеет значение driving, bicycling или не указан (driving является значением по умолчанию).
  • Модификатор side_of_road не указан для того же местоположения.
  • Местоположение задается с помощью значений широты и долготы. Нельзя использовать heading с адресами, идентификаторами мест или закодированными ломаными линиями.