要求替代路徑

根據預設,Routes API 會傳回 default 路徑,這個路徑一般為 從起點到目的地的最快路線。當您要求 alternative 路徑時,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'

在這個範例中,您指定了欄位遮罩,讓回應只包含 每條路線的 durationdistanceMeters,routeLabels 屬性。您的 就能依據這些資訊選擇要採用的路線。如要 相關資訊,請參閱選擇要傳回的資訊

替代路徑回應範例

在回應中,使用 routeLabels 陣列屬性找出觸及率 路徑:

  • 針對預設路線,routeLabels 屬性包含 DEFAULT_ROUTE

  • 如有任何替代路線,routeLabels 屬性會包含 DEFAULT_ROUTE_ALTERNATE

,瞭解如何調查及移除這項存取權。

在此範例中,回應包含預設路徑和兩個替代路徑 路徑。請注意,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"
      ]
    }
   ]
}