대체 경로 요청

기본적으로 Routes API는 기본 경로를 반환합니다. 이 경로는 일반적으로 출발지에서 목적지까지 가장 빠른 경로를 보여줍니다. 요청 시 대체 경로가 있는 경우 API는 기본 경로 및 있습니다. 그러면 고객은 자신의 요구사항에 가장 적합한 경로를 선택할 수 있습니다.

대체 경로 요청 시 고려사항

대체 경로를 요청하려면 다음 고려사항에 유의하세요.

  • 중간 경로가 없는 경로에 대해서만 대체 경로를 요청할 수 있습니다. 경유지. 경로에서 다음을 지정하는 경우 대체 경로 요청 오류가 발생하지 않습니다. 대체 방법 없음 경로가 반환됩니다

  • 응답에 최대 세 개의 대체 경로가 포함됩니다. 하지만 대체 경로를 사용할 수 없는 경우가 있으므로 응답에 기본 경로를 선택합니다

  • 대체 텍스트를 계산하는 데 추가 처리가 필요하기 때문에 경로를 요청할 경우 대체 경로를 요청하면 응답 시간이 생성합니다.

대체 경로 요청 예

대체 경로를 요청하려면 computeAlternativeRoutestrue로 설정합니다. 이 다음 예는 computeRoutes 메서드 (REST) 요청

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude":42.340173523716736,
        "longitude":-71.05997968330408
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":42.075698891472804,
        "longitude": -72.59806562080408
      }
    }
  },
  "travelMode": "DRIVE",
  "routingPreference":"TRAFFIC_AWARE",
  "computeAlternativeRoutes": true
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

이 예에서는 응답에 각 경로의 duration, distanceMeters,, routeLabels 속성 내 고객은 그 정보를 사용하여 어떤 경로를 이용할지 선택할 수 있습니다. 자세한 내용은 자세한 내용은 반환할 정보 선택을 참고하세요.

대체 경로 응답 예시

응답에서 routeLabels 배열 속성을 사용하여 도달범위를 식별합니다. 경로:

  • 기본 경로의 경우 routeLabels 속성에 다음이 포함됩니다. DEFAULT_ROUTE입니다.

  • 대체 경로의 경우 routeLabels 속성에 다음이 포함됩니다. DEFAULT_ROUTE_ALTERNATE입니다.

이 예에서 응답에는 기본 경로와 2개의 대체 경로가 포함되어 있습니다. 경로. durationdistanceMeters 속성의 값이 경로마다 다릅니다.

{
  "routes": [
    {
      "distanceMeters": 150322,
      "duration": "5309s",
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 157614,
      "duration": "6879s",
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    },
    {
      "distanceMeters": 189311,
      "duration": "7376s",
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    }
   ]
}

응답에 다중선 포함

사용자가 경로를 더 쉽게 선택할 수 있도록 다중선을 사용합니다. 그런 다음 지도에 각 폴리라인을 표시합니다.

다중선을 추가하려면 필드 마스크에 routes.polyline를 포함합니다.

-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels,routes.polyline'

그러면 응답에 각 경로에 대한 폴리라인이 포함됩니다.

{
  "routes": [
    {
      "distanceMeters": 150322,
      "duration": "5309s",
      "polyline": {
        "encodedPolyline": "mrlaGtavpLPLBTm…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 157614,
      "duration": "6879s",
      "polyline": {
        "encodedPolyline": "DmEd`@e@pCo@pCs@z…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    },
    {
      "distanceMeters": 189311,
      "duration": "7376s",
      "polyline": {
        "encodedPolyline": "FVLL|Af@HPAV…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    }
   ]
}