Установите точку для прохождения маршрута

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

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

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

Настройте промежуточную точку маршрута как сквозную точку маршрута, установив свойство via точки маршрута в true , используя Waypoint (REST) ​​или Waypoint (gRPC).

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

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

{
  "location": {
    "latLng": {
      "latitude":37.419734,
      "longitude":-122.0827784
    }
  },
  "via": true
}

Доступ к идентификаторам мест для промежуточных точек маршрута

Если указать местоположение исходной, конечной или промежуточной точки маршрута в виде адресной строки или кода Plus , API попытается найти наиболее релевантное местоположение, имеющее соответствующий идентификатор места. Массив geocodingResults.intermediates в результатах содержит идентификатор места, соответствующий местоположению точек маршрута, а также дополнительные данные о местоположении.

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

Например:

  • Вы указываете три промежуточные точки маршрута в запросе. Две из этих точек маршрута указываются адресными строками, а одна — координатами широты/долготы.

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

curl -X POST -d '{
  "origin":{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  },
  "destination":{
    "address": "24 Willie Mays Plaza, San Francisco, CA 94107"
  },
  "intermediates": [
    {
      "address": "450 Serra Mall, Stanford, CA 94305, USA"
    },
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      }
    },
    {
      "address": "1836 El Camino Real, Redwood City, CA 94063"
    }
  ],
  "travelMode": "DRIVE",
}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs,geocodingResults'
'https://routes.googleapis.com/directions/v2:computeRoutes'

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

{
  "routes": [{...}],
  "geocodingResults": {
    "origin": {
      "geocoderStatus": {},
      "type": [
        "premise"
      ],
      "placeId": "ChIJj38IfwK6j4ARNcyPDnEGa9g"
    },
    "destination": {
     "geocoderStatus": {},
      "type": [
        "premise"
      ],
      "placeId": "ChIJI7ES6tl_j4ARVpDZoXbWAiY"
    },
    "intermediates": [
      {
        "geocoderStatus": {},
        "intermediateWaypointRequestIndex": 0,
        "type": [
            "street_address"
        ],
        "placeId": "ChIJvdLMGyq7j4ARScE5tWX_C0Y"
      },
      {
        "geocoderStatus": {},
        "intermediateWaypointRequestIndex": 2,
        "type": [
          "premise"
        ],
        "placeId": "ChIJkTc0GKajj4AR9UMsOSHwGD0"
      }
    ]
  }
}