要求替代路徑

根據預設，Routes API 會傳回「預設」路線，這通常是從起點到目的地最快的路線。當您要求替代路線時，API 會傳回最多三個路線，以及預設路線。這樣一來，客戶就能選擇最符合需求的路線。

要求替代路線時的注意事項

如要要求替代路線，請注意下列注意事項：

  • 您只能針對沒有中繼路線控點的路線要求替代路線。在路線指定中途路標點時，要求其他路線不會導致錯誤。但不會傳回任何替代路線。

  • 回應最多包含三個替代路線。不過，有時沒有可用的替代路線，因此回應只會包含預設路線。

  • 由於計算替代路線需要額外處理，因此要求替代路線可能會增加 API 的回應時間。

替代路線要求範例

將 computeAlternativeRoutes 設為 true 即可要求替代路線。以下範例說明如何在 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。

在這個範例中，回應包含預設路徑和兩個替代路徑。請注意，每個路線的 duration 和 distanceMeters 屬性值皆不同：

{
  "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"
      ]
    }
   ]
}