規劃最佳路線控點

路線控點最佳化是 Routes Preferred 功能 ComputeRoutes。 可最佳化旅客路線中中間路線控點的順序。 盡可能確保他們行駛了最省時的路線。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 個路線控點。

  • 所有路線控點都必須屬於停靠點類型。沒有任何路線控點 可以是「透過」。

  • 您必須在欄位中新增 routes.optimizedIntermediateWaypointIndex 遮罩。

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

    • 所有路線控點之間的累計直線距離必須是 不到 1,000 公里這個距離包含起點和 目的地。

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

推薦內容