規劃最佳路線控點

路線控點最佳化是擴充 ComputeRoutes 的 Routes Preferred 功能。最佳化旅客路線中中間路線控點的順序，確保其行經最有效率的路線。路線控點最佳化的 ComputeRoutes 實作支援下列交通方式：

  • 開車
  • 電動機車
  • 騎單車
  • 散步

使用路線控點最佳化的好處

如果建構的應用程式會引導使用者經過多個路線控點，讓他們前往目的地，請特別注意，旅客必須以最佳順序穿越這些路線控點。這可確保旅客在最短時間內抵達每個路線控點。

運作方式

根據預設，ComputeRoutes 會按照原先提供的路線控點順序計算路線。只要將中間路線控點重新安排為更有效率的順序，就能讓 ComputeRoutes 最佳化路線。如果您將要求主體中的 optimizeWaypointOrder 欄位設為 true，就會收到包含最佳化路線控點的路線。

注意：路線控點最佳化的計算主要是根據交通時間，但系統也會將距離和轉彎次數等其他因素納入考量。

取得重新排序的路線控點

如要取得含有重新排序路線控點的路線，請在要求主體中將布林值欄位 optimizeWaypointOrder 設為 true，使其為 ComputeRoutes。此外，請在欄位遮罩中加入 optimizedIntermediateWaypointIndex 欄位。回應主體的 optimizedIntermediateWaypointIndex 欄位中包含最佳化的路線控點順序。

注意：optimizedIntermediateWaypointIndex 欄位會傳回從零開始的值。

要求範例

以下範例要求提供史丹佛大學校園附近的路線。路徑路線控點已依序在要求中提供。要求包含起點和目的地，包含兩個中繼路線點。

POST /v1alpha:computeRoutes
Host: routespreferred.googleapis.com
Content-Type: application/json
X-Server-Timeout: 10
X-Goog-Api-Key: YOUR_API_KEY
X-Goog-FieldMask: routes.optimizedIntermediateWaypointIndex,routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.418956,
        "longitude": -122.160815
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.4176423,
          "longitude":-122.1102246
        }
      }
    },
    {
      "location":{
        "latLng":{
          "latitude": 37.407689,
          "longitude": -122.1360597
        }
      }
    }
  ],
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.4032137,
        "longitude": -122.0349119
      }
    }
  },
  "travelMode": "DRIVE",
  "optimizeWaypointOrder": true,
  "routingPreference": "TRAFFIC_AWARE"}

回應範例

您可以在回應主體中的路徑物件 optimizedIntermediateWaypointIndex 欄位中，找到重新排序的中繼路線控點索引。編碼的折線與 Directions API 和 ComputeRoutes 相同。

routes {
  distance_meters: 17647
  duration {
    seconds: 1866
  }
  polyline {
    encoded_polyline: "wkkcFvorhVU{@Ec@C}CG}@Mm@[}@i@y@[[g@_@Tk@BSjCgGfF|D\\Pv@Lj@@XaCTeC\\aCTs@`ByD`@k@h@e@x@Yh@GtADhBF|@G`AWpAs@lAsAdA{A`BmDr@cBmUqQoS}OyGmFiBsAgEwD}CaCU_@Og@@e@Hy@nGkO~@sBr@cBlDqIlByEp@}AjIfGnBbBHLLd@^p@~ErDfNrKrA~@DIhEeBTQ~AqDlE{KjBgE|FnEh@aAi@`A}FoE~AmD`A}BcAm@mHwFwD}CkLwIsDqCgF_EG[GKnCsDrA_BrC_CnCoBpEkD`EyClCsBcBeBIAkGkH]k@eJmKQKsAuA_@g@wCoDGQmEmFmIqROKaDuHvBkBxAgANCRH^f@v@dBHDD?`AUiBqEhBpEaATMCQYm@wAY]SIOByAfAwBjB_ByDaAwBiCeIA[c@aBqEuNOm@IQbA{c@p@aZFmCTuBLg@Tc@BUAKxOeV~Vy_@nBoDv@_BvAcDzA_EdG{RdC{HtIsY|B{Hx@mDbAuFdBsMbKsv@TaBf@}AdF{Sn@_DJq@Lo@aE`@]GUQmAmAQk@@g@RK`Ce@d@UDEPc@f@cCrAyGJs@X{AbIem@bA{JD_AIaAMg@o@{A_Ad@y@NaCLCsCK_FGI"
  }
  optimizedIntermediateWaypointIndex: 1
  optimizedIntermediateWaypointIndex: 0
}

在這個範例中，請注意最佳化路線控點會反轉原始順序。

相較於簡易轉送要求，包含最佳化路線控點的要求，處理時間會較久。因此，建議您將 X-Server-Timeout 要求標頭的值設為至少十秒，為方法呼叫設定較高的逾時時間。如果您持續收到逾時錯誤，可新增其他秒，然後再試一次。

使用限制

如要使用路線控點最佳化功能，您必須遵守下列使用限制與條件：

  • 您可以為路徑上的中繼路線控點指定用量限制，步驟如下：

    • 最多 98 個路線控點，僅使用經緯度座標。
    • 如果您使用地點 ID 指定任何路線控點，最多則可達 25 個路線控點。

  • 所有路線控點都必須屬於停靠點類型。您所有的路線控點都不能是 via 的類型。

  • 您必須將 routes.optimizedIntermediateWaypointIndex 新增至欄位遮罩。

  • 如果您的要求包含 25 個以上的中繼路線控點，也必須符合下列條件：

    • 所有路線控點之間的累計直線距離不得超過 1,000 公里。這距離包含起點和目的地。

    • 交通方式必須是「主動」。

推薦內容